前言¶
在使用 DeepSeek Harness (DSH) 進行開發時，追蹤每條請求的 Token 消耗、計算實際費用以及監控供應商配額是控制成本的核心環節。現有的統計方式往往不夠直觀。dsh-token-usage 插件通過在 Web UI 中直接嵌入可視化圖表與數據面板，將原本分散的用量信息聚合展示，解決了開發者無法實時掌握資源消耗的問題。
插件簡介¶
這是一個面向客戶端的 DSH 插件，由開發者 LaoYueHanNi 維護。其核心作用是在 Web UI 中實時顯示模型 Token 的用量與費用，提供趨勢圖表、歷史回填、按模型定價明細以及供應商配額顯示功能。
核心功能¶
- 實時記錄：自動記錄每次請求的 Token 數量、費用、使用的模型以及所屬會話，包括上下文壓縮調用。
- Web 統計頁面：在設置中提供彙總卡片、每日總 Token 折線圖、按模型/會話的明細表，支持通過日期範圍和模型進行篩選。
- 會話用量標籤頁：在對話面板中新增“用量”視圖，展示成功率、成本、緩存命中率等六項核心指標。
- 定價與配額：提供按模型定價的詳細查看入口，並在輸入欄按鈕中直接顯示當前供應商的剩餘配額。
- 歷史回填：首次啓動時會自動同步安裝前的歷史請求記錄。
安裝與啓用¶
由於倉庫已停止提供預構建輸出，請通過 npm 進行安裝。
dsh plugin --profile web add @laoyuehanni/dsh-token-usage
安裝完成後，在 Web UI 側邊欄的齒輪圖標處進入 設置，即可看到 Token Usage 頁面。
使用示例¶
進入 Token Usage 頁面後，可以通過過濾器按日期範圍和模型篩選數據。點擊模型名稱上的費率按鈕可以查看完整的定價表；在輸入欄左側點擊按鈕可以查看當前供應商的剩餘配額。
注意事項¶
- 升級舊版需注意：如果從舊版（<= 0.3.7，包名
dsh-token-usage）升級，直接更新會導致插件無法加載。需要先移除舊包名，再重新添加。 - 定價文件失效：手動編輯的
pricing.json在升級後會被靜默忽略，費率表每次啓動從雲端同步。 - 數據目錄可配置：數據目錄默認爲
~/.dsh/token-usage/，可在 Web 設置卡片中修改爲絕對路徑，保存後歷史數據會自動遷移。 - 安裝源變更：不再支持 GitHub 直接安裝，必須使用 npm 包名。
總結¶
dsh-token-usage 插件爲 DSH 用戶提供了直觀的成本與配額管理入口，適合需要精細化監控資源消耗的開發場景。
