前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構。在 Web GUI 開發與調試過程中，開發者需要直觀地掌握 Token 消耗情況。內置的 Wallet 插件雖然記錄了本地賬本，但缺乏可視化界面。dsh-token-stats 插件旨在解決這一問題，它直接讀取 Wallet 插件已有的 365 天本地賬本，在界面內提供可視化的 Token 統計面板。
插件定位¶
這是一個運行在 DeepSeek Harness Web GUI 客戶端的儀表盤插件。它不進行額外的數據收集，完全依賴 Wallet 插件生成的數據文件。插件本身是純前端展示組件，不涉及複雜的後端邏輯。
核心功能¶
- 側邊欄入口：在左側邊欄註冊 “Token Statistics” 入口，點擊後在中間列以全寬模式展示儀表盤，兼容展開與收起側邊欄兩種狀態。
- 彙總卡片：展示今日、本週、本月、累計四個維度的 Token 使用量與費用（如有定價數據）。
- 堆疊柱狀圖：純 SVG 繪製，按模型着色。支持按日（30 天）、周（12 周）、月（12 月）切換，鼠標懸停可查看各模型詳情。
- 模型明細表：列出每個模型的輸入 Token、輸出 Token、緩存讀取 Token、總量及佔比條，並按總量排序。
- 多語言支持：內置英語、越南語、中文、日語四種語言。儀表盤頭部提供語言切換器，選擇結果會被本地記住。
- 自動刷新：面板打開期間每 30 秒自動刷新數據，並提供手動刷新按鈕。
- 零依賴：無構建步驟，主程序爲純 ESM Node 環境，客戶端爲預打包的 CJS 模塊。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add dsh-token-stats
安裝完成後，重啓 dsh web（或通過市場的「一鍵重啓」功能重啓），在左側邊欄即可看到 Token Statistics 入口。
使用方法¶
- 在左側邊欄點擊 Token Statistics 打開儀表盤。
- 在儀表盤頭部點擊語言圖標，選擇所需語言（支持英語、越南語、中文、日語）。
- 查看頂部的彙總卡片瞭解總體消耗。
- 使用圖表下方的標籤頁切換日/周/月視圖，或查看模型明細表。
注意事項與適用場景¶
- 版本要求：插件依賴 DSH 的側邊欄 DOM 結構，要求 DSH 版本至少爲
0.1.1-rc.2。 - 只讀模式：插件僅從 Wallet 插件讀取數據，不會向賬本寫入任何內容。
- 數據展示限制：對於沒有定價信息的模型，面板僅顯示 Token 數量，不顯示費用金額。
結語¶
dsh-token-stats 是一個輕量級的 Token 統計工具，適合需要在 DeepSeek Harness Web 界面內快速查看使用量與成本分佈的開發者。其數據源與 Wallet 插件完全打通，避免了重複數據採集的開銷。
