前言¶
在 DeepSeek Harness (DSH) 的使用過程中，追蹤 Token 消耗、分析緩存命中率以及評估不同模型的成本是常見需求。手動統計效率低下，且難以獲得全局視角。dsh-all-usage 插件旨在解決這一問題，提供可視化的用量看板，幫助開發者按模型、供應商、工作區和時間範圍分析 Token、緩存與賬戶餘額。
核心功能¶
1. 統計與可視化¶
插件提供 53 周使用熱力圖，展示每日回合與 Token 明細。支持趨勢折線圖，按輸入、輸出、推理及總處理量顯示，並支持小時或日級聚合。數據統計包含模型統計（混合查看、按模型合併、按供應商彙總）、成本統計與價格表，支持 CSV 導出。
2. 工作區管理¶
支持工作區別名管理，持久化保存到本地存儲。支持界面語言切換（中文/English）。通過監聽 DSH 的 domain/changed 事件，自動跟隨工作區註冊表，對新增或刪除的工作區做增量處理。
3. 數據處理機制¶
插件支持完整歷史與增量重建。通過持久化日誌的 revision 作爲變更信號，實現重啓免讀，僅讀取變化的會話。支持數據健康檢查與按需刷新，避免重複讀取。
運行環境與兼容性¶
1. 運行環境¶
運行環境需要 Node.js >=22 <25。
2. DSH 兼容性¶
插件兼容 DSH 0.1.1-rc.1 到 0.1.8-0。Web 服務依賴 Host 的 webServer。
3. 桌面客戶端¶
插件在 DSH 桌面客戶端上實測運行正常（實測版本 @deepseek-ai/dsh-desktop 0.1.7-rc.2）。
典型用法¶
插件提供可復現事件的示例。在項目根目錄下執行以下命令：
node scripts/replay-fixture.mjs fixtures/usage-events.json
該命令會加載真實插件 Host，調用兼容 API，校驗預期 Token/records，並輸出不含敏感信息的摘要。
適用場景與注意¶
適用場景¶
適合需要精細化管理 DSH 本地用量數據、進行成本估算與分析的開發者。
注意事項¶
- 成本口徑：成本是基於 models.dev 價格的估算，不是供應商賬單。目錄不可用或模型沒有官方匹配時不會猜測價格，而是顯示未計價。
- 中斷請求：上游請求被中斷時可能只有
assistant/chunk的 usage，沒有最終assistant/message。本插件會保留該 chunk 用量，但這不等於官方一定收費。 - 工作區統計：本地統計只包含已註冊工作區。未註冊 cwd（包括已存在但未登記的目錄）會被忽略。已刪除工作區的歷史用量會保留並彙總爲一行「已刪除」。
- 權限與安全：插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
短結尾¶
dsh-all-usage 提供了從熱力圖、趨勢分析到成本估算的完整工具鏈，能夠有效輔助開發者進行用量審計與成本控制。更多詳情請參考 Skillhub 目錄 或 GitHub 倉庫。
