前言¶
在 DeepSeek Harness（DSH）的插件生态中，能够直接在 Web 界面呈现量化数据的工具较少。对于需要精细控制 Token 成本和监控模型调用的开发者来说，缺乏可视化的用量统计会带来不便。haoyueqin/dsh-usage-statistics-panel 插件通过订阅会话事件流，将分散的日志聚合为可视化的图表，直接在设置页提供“使用统计”入口。
插件介绍¶
这是 DeepSeek Harness 的一个 Web 插件，用于展示按天的 Token 趋势、GitHub 风格的活跃热力图、缓存命中率曲线，以及按模型和供应商的用量拆分。插件由 HaoyueQin 维护，采用 MIT 许可证。
安装与启用¶
- 使用安装命令添加插件：
dsh plugin --profile <name> add dsh-usage-statistics-panel@latest
- 安装完成后，在浏览器中执行硬刷新（Cmd/Ctrl+Shift+R）以加载客户端改动。
- 在设置页的左侧导航栏中找到“使用统计”页面。
核心功能¶
该插件提供以下功能：
* 按天 Token 趋势：显示堆叠柱状图和缓存命中率曲线。
* GitHub 风格活跃热力图：覆盖 26 周，每日 token 用量以色阶展示。
* 汇总卡片：展示 Token 总量、会话数、请求数、活跃天数、缓存命中率及最常用模型。
* 模型用量拆分：前 10 名模型分色展示，其余折叠。
* 供应商用量拆分：前 5 名供应商分色，其余归入 Other。
* 底部信息栏增强：支持显示精确命中率、Token 明细（输入/输出/缓存读/缓存写）及流式速度。
* 历史回扫：首次启用时回放既有会话日志，补全挂载前的数据。
* 本地持久化：数据存储在 $DSH_HOME/storages/usage_history.，无外部依赖。
技术细节与注意¶
- 版本兼容：支持 DeepSeek Harness
>= 0.1.2-rc.1。使用0.1.1-rc.2或0.1.2-alpha.*的旧版本用户，需安装本插件的0.1.9及之前版本。 - 数据采集：为观测式采集，订阅
session/event流。 - Token 口径：与服务商账单一致，包含未缓存输入、输出、缓存读和缓存写。
- 子代理统计：子代理会话独立统计，与顶层会话合并。
- 权限与安全：纯本地持久化，无外部依赖。
总结¶
该插件通过手绘 SVG 图表和本地存储，为 DSH 用户提供了直观的用量分析工具。对于关注成本和效率的开发者，它是一个实用的辅助工具。
