dsh-token-usage：DeepSeek Harness 本地 Token 用量統計

前言¶

DeepSeek Harness 的核心設計理念是「一切皆插件」。在使用本地大模型時，如果不關注用量，很容易產生意外費用。dsh-token-usage 插件通過讀取本地的會話日誌，在設置頁提供可視化的統計面板，幫助開發者掌握跨模型、跨供應商的 Token 消耗情況。

這是什麼¶

這是一個 DeepSeek Harness 客戶端插件，由 Gnatnaituy 維護，採用 MIT 許可證。

它不依賴第三方計費接口，而是直接讀取 Harness 自身的會話日誌。安裝後，會在「設置」裏新增一個 Token 用量 頁面，展示總用量、GitHub 風格的用量日曆，以及按供應商分組的逐模型用量。

核心功能¶

插件主要提供以下三類數據視圖：

總用量
- 跨所有模型供應商、所有模型的 token 彙總。
- 時間維度：今日 / 近 7 日 / 近 30 日 / 全部。
- 分項統計：輸入、輸出、緩存讀、緩存寫、推理。
用量日曆
- GitHub 貢獻圖風格的熱力圖，每天一格。
- 懸停可查看當日 token 明細與請求數。
- 配色跟隨當前主題（深色/淺色自適應）。
按供應商分組的模型用量
- 每個供應商一張表。
- 列出每個模型今日、近 7 日、近 30 日的用量與佔比。

安裝與啓用¶

使用官方提供的安裝腳本進行安裝：

node tools/install-into-profile.mjs            # 安裝
node tools/install-into-profile.mjs --dry-run  # 預覽會做什麼
node tools/install-into-profile.mjs --uninstall # 卸載

腳本執行後，等待一兩秒，刷新瀏覽器頁面，打開 設置 → Token 用量 即可看到數據。

典型用法¶

查看用量：安裝完成後，刷新頁面進入設置頁的 Token 用用量板塊查看彙總數據。
臨時停用：如果想在不卸載插件的情況下停用，在 profile 的 cordis.patch.yml 文件中添加以下配置：

- id: token-usage
  name: dsh-token-usage
  disabled: true

注意事項¶

數據權限：插件只讀取 <home>/sessions 裏的會話日誌，只寫插件自己的目錄；從不刪除或改寫任何用戶數據。
統計口徑：彙總口徑與 DSH 持久日誌一致。只有 provider 上報了 usage 的 assistant/message 才計爲一條；assistant/attempt、重試事件不帶 usage，不重複計數。
供應商顯示：沒有供應商目錄信息時，供應商 id 會做標題化顯示；歸屬不明的記錄歸到「未標註」。
開發調試：改 lib/index.js 等 host 半代碼後，需要重啓 DSH Desktop，因爲模塊熱重載默認關閉。

總結¶

dsh-token-usage 插件通過讀取本地日誌實現了無侵入式的用量統計，適合需要精細化控制本地模型調用成本的開發者。它不自己計算，而是複用 Harness 的路由與數據源，保證了統計口徑的一致性。