在使用 DeepSeek Harness 进行模型推理或开发时，按月追踪 API key 的 token 消耗是常见需求。现有方式要么依赖云端统计，要么统计维度单一。下面介绍一款专注于本地数据的侧边栏月度 Token 统计插件。
是什么¶
这是一款 DeepSeek Harness 插件，用于在侧边栏显示指定 API key 在日历月度的 token 使用量。该插件由 greyhackintoch-dev 维护，采用 MIT 许可证，仅读取本地数据，并在每月 1 日 00:00 自动重置计数。
核心功能¶
该插件主要解决“本地化月度统计”的需求，具体能力如下：
- 侧边栏展示：在设置上方显示日历月度的 API key token 使用量。点击该行可查看明细，包括各来源（DSH home、opencode、Pen、WorkBuddy）的贡献。
- 多数据源统计：支持统计此 DSH home、opencode、Pen 和 WorkBuddy 的使用情况。
- 本地化与重置：仅读取本地数据，不发送网络请求。计数器在每月 1 日 00:00 重置。
- 跨设备汇总：支持通过
trackKeys配置，将同一密钥在不同机器上的使用量汇总为单数。
安装与启用¶
需通过命令行安装该插件。安装后必须重启 dsh web 才能生效。
dsh plugin --profile web add github:greyhackintoch-dev/dsh-month-tokens
典型用法¶
安装完成后，侧边栏会出现 Token 统计行。若希望将“机器计数”变为“密钥计数”，即汇总同一密钥在多台设备上的用量，需配置 trackKeys。配置后，同一密钥在不同设备上的使用量将基于密钥指纹合并显示。
适用场景与注意¶
- 仅支持 Web Profile：该插件仅支持
web浏览器外壳，不支持官方的 DSH Desktop app。第三方封装了 Web profile 的桌面客户端可以正常使用。 - 不统计 web-search：web-search 路径直接向提供商发送请求且不记录，因此该插件无法统计该路径的用量。
- 计数为 floor（下限）：由于依赖本地记录，插件统计的是能读取到的部分，即“下限”而非“总数”。对于未在本地留下记录的调用（如脚本或未记录的 IDE），不计入统计。
- 依赖重启：安装命令执行后，插件会写入配置文件，但需手动重启
dsh web界面才能看到效果。
总结¶
该插件为本地化月度统计提供了可落地的方案，能够清晰展示各组件的使用情况。若需了解详情或获取源码，可查阅相关目录页或 GitHub 仓库。
