前言¶
在 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
