本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-usage-stats

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-usage-stats

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 热力图：53 周 GitHub 绿，每完成一个回合点亮；悬停按工作区显示次数明细与当日 Token
• 统计卡片：总花费 Token（分项）、缓存命中率、账户余额（DeepSeek 官方接口）、总使用次数、连续使用、各工作区 Token 进度条
• 工作区别名：头部「✎ 工作区别名」管理，持久化保存（$DSH_HOME/storages 的 KV 单元 usage-stats-aliases）
• 时间范围切换（近 30 天 / 近 90 天 / 全部）、动画、亮暗主题自适应
• • id: usage-stats

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后需要重启 DSH 才能看到用量统计页吗？

不需要。host 半启动时立刻跑历史回填，client 半随 web 页面加载，刷新浏览器即可在设置面板的"用量统计"标签页看到内容（README.md:28 / lib/index.js:517 / lib/client.js:678-685）。

余额卡片显示「未配置」该怎么办？

插件读取的是 llm-deepseek 配置中的 API Key 环境变量（默认 DEEPSEEK_API_KEY），先把 DeepSeek 开放平台的 Key 配到该环境变量或 settings 配置里，再点余额卡片旁的刷新即可（lib/index.js:411-429 / README.md:55）。

卸载插件后历史用量数据会丢失吗？

不会。Token 与回合数全部来自 DSH 持久化的会话日志，会话日志不归本插件所有；插件删除后再次安装会重新回填全部历史。仅工作区别名属于插件自身存储（lib/index.js:196-253 / README.md:54）。

能否只统计某一个项目工作区的用量？

可以切换顶部「30 天 / 90 天 / 全部」时间范围查看总量，热力图本身是按天聚合；按工作区分项的 Token 用量与进度条在工作区栏会自动列出，但只能汇总，无法排除某个工作区（lib/client.js:59-91 / README.md:10）。

账户余额走哪个接口，数据多久刷新一次？

走 DeepSeek 官方 https://api.deepseek.com/user/balance 接口。插件内有 5 分钟缓存，需要强制刷新可访问 /api/usage-stats/balance?force=1（lib/index.js:408-470）。

macOS / Linux 上能看到账户余额吗？

余额查询依赖 curl.exe 或 powershell.exe 进程，在 macOS / Linux 上通常取不到余额；但用量热力图、Token 看板、缓存命中率、工作区别名均跨平台可用（lib/index.js:438-441）。

工作区别名保存在哪里，删除后能找回吗？

保存在 DSH 的 $DSH_HOME/storages 下一个名为 usage-stats-aliases 的 KV 单元里（global 段）。插件卸载时只会关闭连接，不会主动清理；删除插件并清空 storages 后无法恢复（lib/index.js:268-309）。

热力图为什么只有最近 53 周？

源码里写死只统计 53 周（约一年）内的日期，超出范围的当天格子不会渲染，统计卡片「全部时间」范围也只对 53 周内的事件重新聚合（lib/index.js:50-58）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: 未声明
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则