DeepSeek Harness (DSH) 採用插件化架構，對於需要精細化控制成本和優化模型的開發者而言，實時監控 Token 用量是核心需求。dsh-token-usage-dashboard 插件爲 DSH Web UI 提供了一個類似 GitHub 的 Activity Heatmap 的統計面板，聚合了會話日誌中的關鍵指標，幫助快速定位高耗能環節。
功能概覽¶
該插件包含以下核心模塊：
- 5 個統計卡片：展示總 Token 數、單日峯值、最長會話、當前連續使用天數、歷史最長連續天數。數值支持自動縮放以適應單行顯示。
- GitHub 風格熱力圖：53 列 x 7 行的滾動網格，支持“每日”和“每週”視圖切換（每週視圖以底部爲起點，每 7 格爲一週）。鼠標懸停可查看具體日期的 Token 數量與請求次數。
- 洞察面板：統計總輪次、LLM 請求數、活躍會話數、活躍天數、緩存命中率，以及平均每輪 Token 數和耗時。
- 模型排名：按 Token 使用量統計 Top 5 的 Favorite Models，並提供比例條形圖直觀展示。
- 數據同步：支持實時增量更新，並在後臺持久化快照，重啓後可快速恢復。
安裝與啓用¶
使用官方 CLI 安裝該插件：
dsh plugin --profile web add github:solstice621/dsh-token-usage-dashboard
安裝完成後，重啓 Web Profile 以應用插件。隨後在 DSH 界面中打開 Settings → Stats 即可查看儀表盤。首次打開時，插件會掃描歷史會話日誌進行初始化，隨後開始實時更新。
典型用法¶
- 查看統計：在儀表盤首頁查看 5 個核心指標卡片和熱力圖概覽。
- 切換視圖：在熱力圖區域點擊切換“每日”或“每週”模式。
- 語言適配：根據 DSH 界面的語言設置（中文或英文），儀表盤標籤會自動切換。
注意事項與邊界¶
使用前需注意以下事實：
- 插件形式衝突：該插件提供“Bundle 形式”（推薦）和“Dynamic Plugin 形式”（toksta-5）。兩者註冊的設置區塊 ID 均爲
token-stats，切勿同時運行。 - 環境依賴：
dsh plugin命令依賴於pnpm，請確保pnpm已在系統 PATH 中（可通過corepack enable pnpm啓用）。 - 數據統計規則：
- 僅統計 Adapter 報告了
usage的調用，標題生成調用不計入。 - 模型歸屬信息來自會話最新請求的
request/header。 - 當前連續天數若今日無使用，則統計至昨日。
- 僅統計 Adapter 報告了
- 樣式渲染：CSS 注入通過客戶端內置樣式完成，不支持
ctx.get('styles')這種服務端寫法。
結語¶
dsh-token-usage-dashboard 是解決 DeepSeek Harness 開發者 Token 監控需求的有效工具。它通過可視化方式整合了 Session 日誌中的關鍵數據，減少了手動查看日誌的時間成本。更多細節與源碼，請訪問 GitHub 倉庫。
