前言¶
在 DeepSeek Harness（DSH）裏跑多工作區、多會話時，Token 花在哪、哪天用得最多、緩存有沒有命中，往往只能翻日誌或憑感覺估算。官方控制檯能查餘額，但和本地會話用量、工作區維度對不上。
下面介紹社區插件 dsh-usage-stats（維護者 Make0209，分類 admin-security）。它把持久化會話日誌聚合成 GitHub 風格熱力圖和統計卡片，並在設置面板提供工作區別名管理，安裝後自動回填歷史。
這是什麼¶
dsh-usage-stats 是標準的 DSH 社區插件包：聲明 dsh.bundle manifest，包含 host 半與 web client 半。數據全部來自 DSH 持久化會話日誌，不依賴外部統計服務。
- 目錄頁：https://www.skillhub.cn/plugins/Make0209/dsh-usage-stats
- 源碼：https://github.com/Make0209/dsh-usage-stats
- 許可證：MIT
核心功能¶
用量熱力圖¶
53 周 GitHub 綠格佈局：每完成一個回合點亮對應日期。懸停可查看當日按工作區拆分的次數明細與 Token。
統計卡片¶
看板彙總以下指標：
- 總花費 Token（分項展示）
- 緩存命中率
- 賬戶餘額（調用 DeepSeek 官方
/user/balance，複用llm-deepseek的 API Key 配置） - 總使用次數、連續使用天數
- 各工作區 Token 進度條
支持近 30 天、近 90 天、全部時間範圍切換，帶過渡動畫，亮暗主題自適應。
工作區別名¶
設置頁頭部提供「工作區別名」入口，別名持久化保存在 $DSH_HOME/storages 的 KV 單元 usage-stats-aliases，便於在熱力圖和卡片裏用可讀名稱替代原始路徑。
數據與接口¶
Host 半（lib/index.js）掃描會話日誌，聚合 turn/end 與 assistant/message.usage，並監聽 session/event 即時更新。對外註冊：
GET /api/usage-stats— 統計快照GET /api/usage-stats/balance?force=1— 賬戶餘額POST /api/usage-stats/alias— 設置工作區別名
Client 半（lib/client.js）通過 window.__ModuleLoader__ 註冊設置面板「用量統計」頁（settings.section 槽位）。
僅統計能歸屬到已註冊工作區（按會話 cwd 匹配）的會話。插件卸載或重啓後，歷史數據不丟。
安裝與啓用¶
推薦用官方插件命令安裝到 web profile：
dsh plugin --profile web add dsh-usage-stats
安裝後刷新頁面即可，無需改配置、無需重啓 DSH。
若使用本地包，需把目錄鏈到 $DSH_HOME/profiles/node_modules/，並在 $DSH_HOME/profiles/web/cordis.patch.yml 插入插件註冊項；保存後頁面熱重載生效。具體符號鏈接與 patch 寫法見 GitHub README。
典型用法¶
- 執行上述安裝命令，刷新 DSH Web 界面。
- 打開設置，進入「用量統計」頁，查看熱力圖與卡片。
- 若需顯示賬戶餘額，先在 DSH 中配置
llm-deepseek的 API Key；未配置時餘額卡片會顯示引導文案。 - 點擊頭部工作區別名管理，爲常用
cwd設置別名，便於在多工作區間對比用量。 - 切換 30 天 / 90 天 / 全部，觀察 Token 與緩存命中率變化。
開發時修改 lib/client.js 刷新頁面即生效；修改 lib/index.js 需重啓 DSH。插件包無第三方依賴。
適用場景與注意¶
適合需要長期跟蹤 DSH 本地用量、按工作區對比 Token、順帶查看 DeepSeek 賬戶餘額的開發者。
安裝前請注意：
- 插件以當前 DSH 進程權限運行，會讀取本地會話日誌與 API Key 配置，安裝前應閱讀源碼並確認 MIT 許可證。
- 餘額查詢走官方接口，與會話統計相互獨立；統計範圍受工作區註冊與
cwd匹配規則限制。 - SkillHub 爲社區目錄站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-usage-stats 把分散在會話日誌裏的回合與 Token 信息收成一張熱力圖和一組卡片，並支持工作區別名，適合作爲 DSH 日常用量自檢工具。更多信息見 SkillHub 目錄頁 與 GitHub 倉庫。
