前言¶
在 DeepSeek Harness (DSH) 的使用过程中，追踪 Token 消耗、分析缓存命中率以及评估不同模型的成本是常见需求。手动统计效率低下，且难以获得全局视角。dsh-all-usage 插件旨在解决这一问题，提供可视化的用量看板，帮助开发者按模型、供应商、工作区和时间范围分析 Token、缓存与账户余额。
核心功能¶
1. 统计与可视化¶
插件提供 53 周使用热力图，展示每日回合与 Token 明细。支持趋势折线图，按输入、输出、推理及总处理量显示，并支持小时或日级聚合。数据统计包含模型统计（混合查看、按模型合并、按供应商汇总）、成本统计与价格表，支持 CSV 导出。
2. 工作区管理¶
支持工作区别名管理，持久化保存到本地存储。支持界面语言切换（中文/English）。通过监听 DSH 的 domain/changed 事件，自动跟随工作区注册表，对新增或删除的工作区做增量处理。
3. 数据处理机制¶
插件支持完整历史与增量重建。通过持久化日志的 revision 作为变更信号，实现重启免读，仅读取变化的会话。支持数据健康检查与按需刷新，避免重复读取。
运行环境与兼容性¶
1. 运行环境¶
运行环境需要 Node.js >=22 <25。
2. DSH 兼容性¶
插件兼容 DSH 0.1.1-rc.1 到 0.1.8-0。Web 服务依赖 Host 的 webServer。
3. 桌面客户端¶
插件在 DSH 桌面客户端上实测运行正常（实测版本 @deepseek-ai/dsh-desktop 0.1.7-rc.2）。
典型用法¶
插件提供可复现事件的示例。在项目根目录下执行以下命令：
node scripts/replay-fixture.mjs fixtures/usage-events.json
该命令会加载真实插件 Host，调用兼容 API，校验预期 Token/records，并输出不含敏感信息的摘要。
适用场景与注意¶
适用场景¶
适合需要精细化管理 DSH 本地用量数据、进行成本估算与分析的开发者。
注意事项¶
- 成本口径：成本是基于 models.dev 价格的估算，不是供应商账单。目录不可用或模型没有官方匹配时不会猜测价格，而是显示未计价。
- 中断请求：上游请求被中断时可能只有
assistant/chunk的 usage，没有最终assistant/message。本插件会保留该 chunk 用量，但这不等于官方一定收费。 - 工作区统计：本地统计只包含已注册工作区。未注册 cwd（包括已存在但未登记的目录）会被忽略。已删除工作区的历史用量会保留并汇总为一行「已删除」。
- 权限与安全：插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
短结尾¶
dsh-all-usage 提供了从热力图、趋势分析到成本估算的完整工具链，能够有效辅助开发者进行用量审计与成本控制。更多详情请参考 Skillhub 目录 或 GitHub 仓库。
