前言¶
在 DeepSeek-Harness (DSH) 的開發流程中，監控 Token 消耗並按模型或時段進行計費是常見需求。dsh-token-tracker 是一個用於處理這些數據的網頁插件，它從持久會話日誌中摺疊提供者 Token 使用情況，並提供高峯/低谷定價。它會在 DSH GUI 中顯示總計，並提供獨立概覽頁面和 JSON API。
插件概覽¶
這是一個由 XiaHouSheng 維護的 DSH 客戶端插件（MIT 許可證）。插件運行在 DSH host 內，負責監聽會話事件、摺疊 Token 數據，並在 Web 界面中展示。
核心功能¶
- 數據摺疊與展示：從會話日誌中摺疊提供者 Token 使用情況。
- 時段定價：支持按高峯/低谷時段定價。
- GUI 懸浮元素：在 DSH GUI 頭部顯示 Token 徽章和週期標籤，提供 Tracker 按鈕、作曲家停靠線、回合結束尾以及
conversation.viewToken 標籤。 - 獨立頁面與 API：提供獨立的概覽頁面和 JSON API。
安裝與啓用¶
安裝此插件前，必須先安裝 DeepSeek-Harness (dsh)，因爲它將其作爲 peer dependency。插件本身是一個可直接安裝的 dsh 插件包，lib/ 目錄下包含預構建內容。
- 安裝插件：
執行以下命令安裝插件包：
dsh plugin --profile web add https://github.com/XiaHouSheng/dsh-token-tracker.git
- 啓動 DSH：
啓動服務以激活插件層：
dsh --profile web
典型用法¶
-
配置定價：
在 workspace 根目錄或 session cwd 中放置token-pricing.json文件，以覆蓋默認價格。系統會讀取該文件並按緩存/未緩存、輸入/輸出以及高峯/低谷時段進行計費。 -
訪問頁面：
* 獨立概覽頁面：訪問http://127.0.0.1:<port>/dsh-token-tracker。
* JSON API：訪問http://127.0.0.1:<port>/dsh-token-tracker/api。
注意事項¶
- 插件運行在 DSH host 內，利用其運行時環境。
- 從源代碼重新構建需要 Node.js >= 20 和 pnpm，但安裝插件本身不需要這些依賴。
- 該插件是一個可直接安裝的 dsh 插件包，
lib/目錄下包含預構建內容。
總結¶
該插件爲 DSH 用戶提供了可視化的 Token 監控和計費功能。更多詳情可查閱 GitHub 倉庫。
