前言¶
使用 DeepSeek Harness（DSH）时，模型调用记录通常分散在会话日志里。如果想回看过去一段时间每天用了多少 Token、哪些模型消耗较多，常见做法是翻日志或自己写统计脚本。
snownightt/dsh-token-activity 是一个面向 DeepSeek Harness 的第三方插件。它把最近 365 个本地自然日的每日 Token 消耗展示成热力图，并能在悬停日期时查看当天全部模型及各自 Token 用量。
这是什么¶
snownightt/dsh-token-activity 由 SnowNightt 维护，GitHub 仓库地址是 https://github.com/SnowNightt/dsh-token-activity，许可证为 MIT。
它解决的问题很具体：在 DeepSeek Harness Web 界面里提供一个“使用量”入口，用于查看累计 Token、峰值 Token，以及按日聚合的历史 Token 消耗。
核心功能¶
- 设置界面新增一级导航「使用量」。
- 顶部指标卡展示累计 Token 与峰值 Token。
- 展示最近 365 个本地自然日的每日 Token 消耗热力图。
- 悬停任意日期时，显示当日总量、日期、全部模型及各自 Token。
- 历史会话自动回填，并实时展示回填进度。
- 单个会话回填失败不影响整体统计。
安装与启用¶
下面介绍从 npm 包安装并启用的流程：先安装插件，再启动 Web 服务，最后检查配置。
安装插件：
dsh plugin --profile web add @snownightt/dsh-token-activity-bundle
安装完成后，启动 DeepSeek Harness Web 服务：
dsh web
经过上面的步骤后，可以检查组合配置：
dsh --profile web --dump-config
输出中应包含：
token-activity
ui-token-activity
注意：安装或卸载插件后，需要重启 DeepSeek Harness Web 服务。
典型用法¶
- 安装插件后，启动 DeepSeek Harness Web 服务：
dsh web
-
在浏览器打开 DeepSeek Harness Web 界面，进入「设置」，点击一级导航中的「使用量」。
-
首次打开时，等待历史会话自动回填完成。单个会话读取失败不会中断其他数据统计。
-
回填完成后，页面会展示累计 Token、峰值 Token、最近 365 个本地自然日的 Token 消耗热力图。悬停任意日期，可以看到当日总量、日期、全部模型及各自 Token。
适用场景与注意¶
这个插件适合需要在 DeepSeek Harness Web 界面里查看历史 Token 消耗、按日期回看模型用量的开发者。
它基于 DeepSeek Harness 会话日志统计已记录模型调用 Token，不直接读取 API 提供商账户账单。因此，插件显示的累计量应理解为 Harness 会话已记录 Token，不能替代 API 提供商平台的账户用量。费用、余额或最终计费，以 API 提供商官方平台为准。
以下情况可能导致插件统计值与官方平台数据不一致：
- 自动标题生成、上下文压缩等辅助模型调用可能未完整计入；
- 网页搜索响应 Token 用量目前不写入本插件统计来源；
- 失败、取消或重试请求，仅在 Harness 会话日志保存
usage时统计。
此外，该插件会随当前 dsh 进程加载，运行权限取决于当前 dsh 进程。安装前建议检查 GitHub 源码和 MIT 许可证。
如果要从 npm 安装版本卸载，可执行：
dsh plugin --profile web remove @snownightt/dsh-token-activity-bundle
卸载后同样需要重启 DeepSeek Harness Web 服务。
结尾¶
snownightt/dsh-token-activity 的价值不是替代 API 提供商账单，而是给 DeepSeek Harness 的会话日志提供一个按日聚合的 Token 消耗视图。适合先通过本地会话日志快速判断用量趋势，再按官方平台数据核对费用。
目录页：https://www.skillhub.cn/plugins/SnowNightt/dsh-token-activity
GitHub：https://github.com/SnowNightt/dsh-token-activity
