前言¶
在 DeepSeek Harness（DSH）的插件生態中，能夠直接在 Web 界面呈現量化數據的工具較少。對於需要精細控制 Token 成本和監控模型調用的開發者來說，缺乏可視化的用量統計會帶來不便。haoyueqin/dsh-usage-statistics-panel 插件通過訂閱會話事件流，將分散的日誌聚合爲可視化的圖表，直接在設置頁提供“使用統計”入口。
插件介紹¶
這是 DeepSeek Harness 的一個 Web 插件，用於展示按天的 Token 趨勢、GitHub 風格的活躍熱力圖、緩存命中率曲線，以及按模型和供應商的用量拆分。插件由 HaoyueQin 維護，採用 MIT 許可證。
安裝與啓用¶
- 使用安裝命令添加插件：
dsh plugin --profile <name> add dsh-usage-statistics-panel@latest
- 安裝完成後，在瀏覽器中執行硬刷新（Cmd/Ctrl+Shift+R）以加載客戶端改動。
- 在設置頁的左側導航欄中找到“使用統計”頁面。
核心功能¶
該插件提供以下功能：
* 按天 Token 趨勢：顯示堆疊柱狀圖和緩存命中率曲線。
* GitHub 風格活躍熱力圖：覆蓋 26 周，每日 token 用量以色階展示。
* 彙總卡片：展示 Token 總量、會話數、請求數、活躍天數、緩存命中率及最常用模型。
* 模型用量拆分：前 10 名模型分色展示，其餘摺疊。
* 供應商用量拆分：前 5 名供應商分色，其餘歸入 Other。
* 底部信息欄增強：支持顯示精確命中率、Token 明細（輸入/輸出/緩存讀/緩存寫）及流式速度。
* 歷史回掃：首次啓用時回放既有會話日誌，補全掛載前的數據。
* 本地持久化：數據存儲在 $DSH_HOME/storages/usage_history.，無外部依賴。
技術細節與注意¶
- 版本兼容：支持 DeepSeek Harness
>= 0.1.2-rc.1。使用0.1.1-rc.2或0.1.2-alpha.*的舊版本用戶，需安裝本插件的0.1.9及之前版本。 - 數據採集：爲觀測式採集，訂閱
session/event流。 - Token 口徑：與服務商賬單一致，包含未緩存輸入、輸出、緩存讀和緩存寫。
- 子代理統計：子代理會話獨立統計，與頂層會話合併。
- 權限與安全：純本地持久化，無外部依賴。
總結¶
該插件通過手繪 SVG 圖表和本地存儲，爲 DSH 用戶提供了直觀的用量分析工具。對於關注成本和效率的開發者，它是一個實用的輔助工具。
