技能介绍

你要解决的问题

当你在 SkillHub 上发布了多个技能之后，后台列表只展示当前的下载量、安装数和星标，历史趋势无处可查。手动翻页截图记录既不现实，也很难回答"上个月的下载增长是从哪几个 skill 来的"这类问题。如果还想每天早上自动拿到昨天的更新数据，靠人工操作根本做不到。

这个技能做什么

它会登录 SkillHub 后台接口，拉取你发布的全部技能的最新指标，按日期存为本地 JSON 快照，然后基于快照历史生成一份自包含的 HTML 看板。核心能力包括：

数据拉取：调用 https://api.skillhub.cn/api/v1/dashboard/skills，自动翻页取全量 skill，汇总当日 downloads、installs、stars 总量
快照存储：以 YYYY-MM-DD 为 key 写入 snapshots.json，同一天多次采集只保留最后一次
趋势看板：生成离线 HTML，包含三条趋势折线图和每 skill 明细表，内置 echarts
定时采集：可创建每日任务自动执行，失败时明确提示重新授权

工作流

检查授权：先确认凭证是否有效，支持官方 API Token（skh_xxx 格式）或浏览器 Cookie 兜底
采集快照：执行采集脚本，脚本自动翻页、汇总、写快照，失败时会区分 AUTH_EXPIRED、FETCH_ERROR、PARSE_ERROR 三类错误
生成报告：基于最新快照生成 HTML 看板，趋势图展示每日三项指标的总和，明细表展示每个 skill 的当前数据

适用边界

凭证不会写进 skill 目录，统一存放在 ~/.workbuddy/skillhub-stats/credentials.json，权限为 600，绝不提交 git。该接口是 SkillHub 后台内部接口，字段结构可能随版本调整，遇到 PARSE_ERROR 通常意味着接口已变更。PAT token 没有过期时间，只能手动撤销；撤销后自动采集会失败，这是预期的重授权机制。