dsh-token-usage：DeepSeek Harness 本地 Token 用量看板

DeepSeek Harness 是本地智能體開發環境。開發者需要監控 Token 消耗。該插件解決此問題。

插件簡介¶

dsh-token-usage 是面向 DeepSeek Harness 的本地用量看板插件。它由 xbyzzZ 維護，遵循 MIT 許可證。

核心功能¶

數據源：只讀 $DSH_HOME/sessions 裏的 session.l.zstd。
時間範圍：按最近 30 天彙總 provider 回報的 token usage。
界面入口：在 Web 側欄設置上方放入口，點擊打開用量彈窗。
展示形式：熱力圖 + 按模型表。
技術實現：獨立 bundle 插件，不改 DSH 源碼，不引入 SQLite。
主題支持：支持暗色/淺色模式。

安裝與配置¶

進入插件目錄後執行安裝命令：

dsh plugin --profile web add .

這會在 $DSH_HOME/profiles/web 用 pnpm 裝上插件，並追加進 package.json 的 dsh.profile.bundles。安裝後重啓 DSH，左下角設置上方會出現「用量」入口。

若 dsh plugin add 報錯 pnpm v11.12.0 is a broken release，這是 profile 的 packageManager 釘死了壞版本。需將 $DSH_HOME/profiles/web/package.json 裏的 pin 改爲 pnpm@11.22.0（或更新的可用版本），再執行安裝命令。

插件自帶 cordis.patch.yml。若要覆蓋配置，需整段重寫 config：

- insert:
    - id: dsh-token-usage
      name: dsh-token-usage
      config:
        days: 30
        maxFiles: 4000
        maxFileBytes: 33554432

界面與用法¶

入口：Web 側欄設置按鈕上方。

彈窗內容：
* 最近 30 天熱力圖。
* 新產生 / 有用量的天 / 會話數量。
* 熱力圖顏色：淺色模式爲白到藍，暗色模式爲黑到藍；無用量爲白 / 黑。
* 模型表：包含 provider + 模型名、步數、輸入、輸出、緩存讀、緩存寫、推理。
* 空數據：還沒有帶 usage 的會話。
* 失敗：讀不了本地 JSONL，可再掃一次。

數據口徑¶

統計對象：只統計會話日誌裏的 assistant/message.usage（同 turn/step 後寫覆蓋前寫）。
新產生計算：inputTokens + outputTokens + cacheWriteTokens。
獨立列表：緩存讀、推理單獨列表，不併進熱力圖主數字。
舊會話：沒有 usage 的舊會話不按字數估算。

技術注意事項¶

運行環境：需要 Node >= 22。
Profile 限制：Host 在沒有 connection 的 headless profile 裏不會註冊 RPC。
數據獲取：Web profile 會通過 /token-usage 的 summary 接口取數。

結語¶

該插件爲 DSH 本地開發提供了輕量級的用量監控能力。更多細節與源碼可查閱插件目錄或GitHub 倉庫。