前言¶
在 DSH 的插件化使用方式中，很多客户端能力可以以插件形式接入。对于 Web 平台里的 DSH 客户端，一个常见需求是把模型调用的 token 用量看得更清楚：按哪个模型、哪一小时、各占多少。
dsh-usage-meter 是 cute-baobao 维护的用量统计插件，面向 Web 平台 DSH 客户端。它自动记录模型调用的 token 用量，按「模型 × 小时」聚合，并在 Web GUI 设置页以堆叠柱状图展示。
这是什么¶
dsh-usage-meter 是 DeepSeek Harness 用量统计插件。它把 token 用量记录到本地文件，并在启动时重新聚合，给设置页提供「模型 × 小时」的柱状图。
它面向 Web 平台客户端，dsh.client.platform 为 web，并注入以下 client 包：
@deepseek-ai/dsh-client-locale
@deepseek-ai/dsh-client-runtime
@deepseek-ai/dsh-client-ui-settings
许可证为 MIT。
核心功能¶
- 自动记录模型调用的 token 用量。
- 按「模型 × 小时」聚合用量数据。
- 在 Web GUI 设置页以堆叠柱状图展示：每小时一根柱子，按模型分色。
- 数据记录在本地 JSONL 文件。
- 启动时按小时重新聚合。
- 界面中英双语，跟随 GUI 语言。
数据文件位置为：
$DSH_HOME/usage-meter/usage.jsonl
安装与启用¶
先安装插件。下面命令使用 pnpm 和 web profile：
pnpm dsh plugin --profile web add @dsh-usage-meter/usage
如果刚发布当天解析失败，可以显式钉版本，例如 0.3.0：
pnpm dsh plugin --profile web add @dsh-usage-meter/usage@0.3.0
安装后，重启 Web 客户端：
dsh web
重启完成后，进入「设置 → 用量统计」即可查看。
典型用法¶
下面按顺序做一次最小验证：
- 安装插件：
pnpm dsh plugin --profile web add @dsh-usage-meter/usage
- 重启 DSH Web 进程：
dsh web
-
打开「设置 → 用量统计」，查看按小时、按模型分色的堆叠柱状图。
-
如需检查原始记录，可查看数据文件：
$DSH_HOME/usage-meter/usage.jsonl
- 如果不再需要，可以卸载：
pnpm dsh plugin --profile web remove @dsh-usage-meter/usage
适用场景与注意¶
适合需要查看 Web 平台 DSH 客户端 token 用量的人。尤其是希望按模型和小时观察调用情况，并在设置页看到图表的使用者。
使用前注意：
- 插件会以当前
dsh进程权限运行；安装前建议检查源码与许可证。 - 许可证为
MIT。 package.json声明的 Node 要求和包管理器版本为：
node: ^22.19.0 || >=24.0.0
pnpm@11.7.0
- 数据记录在：
$DSH_HOME/usage-meter/usage.jsonl
启动时按小时重新聚合。
- 界面语言跟随 GUI，支持中英双语。
链接¶
GitHub 仓库：
https://github.com/cute-baobao/dsh-usage-meter
