前言¶
DeepSeek Harness 的插件生態允許對客戶端功能進行擴展。對於開發者而言，追蹤 token 用量以評估成本或資源使用情況是一個常見需求。dsh-token-stat 是一個插件，用於統計使用 DSH 以來累計 token 用量，並按模型 / 日期區分明細；它提供可視化看板，且數據保存目錄可在設置頁在線更改。
核心功能¶
該插件具備以下核心能力：
- 累計統計：統計累計 token 用量，包含輸入、緩存讀取、緩存寫入、輸出和總計。
- 明細查詢：按模型和日期區分明細。
- 可視化看板：在設置頁查看包含可視化 SVG 圖表（環形圖、堆疊柱狀圖、排行）的看板。
- 數據管理：數據保存目錄可在設置頁在線更改。
- 零依賴：零運行時依賴，無需構建或授權。
安裝¶
通過 CLI 命令安裝插件，無需額外構建步驟：
dsh plugin --profile <profile> add https://github.com/Anna-la/token-stat
安裝後，插件將自動掃描 <DSH_HOME>/sessions 下的全部歷史會話並開始累計。
使用方法¶
- 設置頁查看：打開「設置 → 插件 → 可配置」，找到「Token 用量統計」卡片點擊展開。卡片內展示累計總量、按模型/日期的明細表以及元信息。
- 查看可視化圖表：在卡片展開後，點擊「可視化」可查看手寫的 SVG 圖表（模型用量佔比環形圖、每日用量堆疊柱狀圖、模型用量橫向排行）。
- 數據目錄管理：在卡片中修改「數據保存目錄」並保存，可在線更改數據存儲位置。
- 重新掃描：點擊卡片內的「重新掃描」按鈕，可從磁盤全量重新摺疊歷史會話。
- 對話框查詢：在對話框裏問「查一下 token 用量統計」，模型會調用插件的工具返回報告文本。
統計口徑與數據說明¶
- 數據來源：數據來自會話日誌中供應商上報的精確 usage。
- 去重規則：同一
(turn, step)步內的重試/重複上報只計最後一次採樣。 - 數據隔離：報告默認寫入
~/.dsh-token-stat，完全位於DSH_HOME之外。官方對profiles/storages/sessions等目錄的任何清理、重裝都不會誤刪本插件的數據。 - 報告文件：生成
report.md、report.json和archive.json三個文件。 - 工具調用：支持工具調用查詢統計。
注意事項¶
- 安全性：API
/api/token-stat/stats僅限迴環地址可訪問，外部請求一律 403。 - 依賴情況：零第三方依賴，圖表爲手寫 SVG。
- 卸載後保留：卸載插件後，歷史報告文件仍保留在默認目錄。
- 只讀操作：插件只讀會話日誌，不修改任何會話數據。
