前言¶

在 DSH Web 中做智能體開發時，一次任務可能觸發多次 LLM 調用。如果需要觀察 token 用量，單獨翻看請求記錄不夠方便，也很難按 API、模型和日期做對比。

zerro-223/dsh-token-usage 是一個 DeepSeek Harness Web UI 插件，用來捕獲每次 LLM 調用的用量，並在側邊欄打開一個統計面板，展示 Token 消耗、估算成本、趨勢圖和每日用量熱力圖。

這是什麼¶

dsh-token-usage 是 DeepSeek Harness Web UI 的 Token 用量統計插件。它由 zerro-223 維護，npm 包名爲 @zerro223/dsh-token-usage，版本爲 1.1.1，許可證爲 MIT。

插件捕獲 llm/stream 中每次 LLM 調用的用量，並按 API（provider）、模型、日期展示統計與圖表。

核心功能¶

插件在 DeepSeek Harness Web UI 側邊欄底部增加「Token 用量」入口，打開統計面板。主要能力包括：

• 按 API（provider）、模型、日期展示 Token 消耗。
• 監聽 llm/stream waterfall 事件，捕獲每次模型調用的 usage chunk，包括輸入、輸出、緩存讀、緩存寫、推理 tokens。
• 持久化到 ~/.dsh/storages/token-stats/usage.jsonl。
• 展示總 Tokens、請求數、輸入、輸出、總命中率、估算成本統計卡。
• 按模型單價估算成本，自動同步 modelradar.cn，並支持手動覆蓋。
• 提供輸入、輸出、緩存命中、成本雙軸趨勢圖。
• 提供近一年每日用量熱力圖。
• 提供模型彙總表、API/模型篩選、最近 30 條請求。
• 支持導出 JSONL、JSON、CSV，並可清空全部歷史。
• 每 15 秒自動刷新；標籤頁隱藏時暫停後臺輪詢。
• 適配深色/淺色主題。

安裝與啓用¶

環境要求¶

插件要求 Node >=18，並聲明以下 peer dependencies：

{
  "engines": {
    "node": ">=18"
  },
  "peerDependencies": {
    "@deepseek-ai/cordis": "^4.0.1",
    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6",
    "react": "^18.0.0"
  }
}

npm 安裝（推薦）¶

先安裝插件：

dsh plugin --profile web add @zerro223/dsh-token-usage

安裝完成後，重啓 DSH Web，然後打開 DSH Web UI 側邊欄底部的「Token 用量」入口。

本地源碼安裝¶

如果從本地源碼安裝，先做兩步：

1、將 @zerro223/dsh-token-usage 包目錄複製到 profile 的 node_modules。

2、在 profile 的 cordis.patch.yml 中追加 token-usage 條目：

token-usage

完成後再重啓 DSH Web。

本地目錄 / Git 倉庫安裝¶

也可以直接安裝本地目錄或 GitHub 倉庫：

dsh plugin --profile web add file:D:/path/to/dsh-token-usage

或：

dsh plugin --profile web add github:zerro-223/dsh-token-usage

典型用法¶

先重啓 DSH Web，打開側邊欄底部的「Token 用量」入口，然後按下面步驟查看。

1、在面板中切換 API、模型、日期範圍，查看統計卡與圖表。

2、需要保存數據時，使用導出菜單導出 JSONL、JSON 或 CSV；如不需要歷史數據，可執行清空全部歷史。

3、通過接口讀取聚合數據：

/token-stats/api/overview
/token-stats/api/heatmap

/token-stats/api/overview 返回 series、totals、cacheHitRate、filterOptions；/token-stats/api/heatmap 返回熱力圖數據。

完整接口列表如下：

/token-stats/api/overview
/token-stats/api/heatmap
/token-stats/api/export
/token-stats/api/clear

數據存儲與限制¶

數據文件位於：

~/.dsh/storages/token-stats/usage.jsonl

存儲行爲如下：

• 內存保留最近 50 萬條記錄。
• 文件超過 128MB 時自動壓縮，保留最近 50 萬條。
• 多個 profile 共享同一存儲文件，壓縮時合併最新記錄。
• 插件依賴 webServer 服務，記錄與統計僅在有 web 服務的 profile（如 web）中激活。
• 重試/重複請求每次真實到達 provider 的調用都會記錄。
• 卸載插件不會刪除歷史數據；重新啓用可恢復統計，執行清空全部歷史除外。

價格與成本估算¶

插件按模型單價估算成本。價格自動同步來自 modelradar.cn；CNY 來源模型會標註「自動·源CNY」。手動價格優先於自動價格。

安全與適用場景¶

DSH 的理念是「一切皆插件」。社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不要把它理解成官方應用商店。

該插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。許可證爲 MIT，源碼倉庫見 GitHub 鏈接。

適合以下場景：

• 需要在 DSH Web UI 中查看每次 LLM 調用 token 用量的開發者。
• 需要按 API（provider）、模型、日期對比調用量與估算成本的使用者。
• 需要導出 JSONL、JSON、CSV 或長期保留用量歷史的用戶。

結尾¶

dsh-token-usage 的價值在於把 llm/stream 中分散的 usage chunk 彙總成可按 API、模型、日期查看的統計面板，並支持導出和成本估算。

GitHub：

https://github.com/zerro-223/dsh-token-usage

已覈實資料未提供目錄頁地址，因此本文不列出目錄頁鏈接。