前言¶
DeepSeek Harness（DSH）的生態強調“一切皆插件”。在本地調試或使用過程中，查看 Token 消耗和模型調用情況是常見需求。dsh-plugin-token-usage 是一個由 Hjay1101 維護的客戶端插件，它直接讀取本地會話日誌，將數據轉化爲 GitHub 風格的熱力圖，並提供按粒度的模型拆分視圖。
核心功能¶
該插件提供以下能力：
- GitHub 風格熱力圖：展示最近 30 天的 Token 使用情況，採用“週日優先”的列布局排列，今日數據會被高亮輪廓顯示。零使用天數會被填充爲空。
- 多粒度切換：支持按“天 / 周 / 月”切換視圖，顏色刻度會根據當前粒度範圍自動重新歸一化。
- 交互詳情：鼠標懸停單元格時，會顯示當日的 Token 數量、請求數和緩存命中率。
- 模型拆分表格：根據當前粒度聚合模型數據，提供窗口內的精確聚合（基於會話×天和模型×天的二級映射），並支持過濾掉僅產生請求但無實際 Token 的模型。
- 側邊欄徽章：鼠標懸停側邊欄圖標時，顯示“今日使用量”，並在後臺進行靜默輪詢（30 秒間隔），數據在午夜自動滾動。
- 命令行工具：通過模型工具
usage_report在對話中直接查詢 Token 使用情況。 - 主題適配：所有顏色均映射到 DSH 的主題變量，支持深色和淺色模式自動切換。
安裝與啓用¶
安裝前請確保當前 DSH 架構版本不低於 0.1.2-rc.1。
- 執行安裝命令：
dsh plugin --profile web add dsh-plugin-token-usage
插件包自帶 `cordis.patch.yml`，安裝後會自動掛載。
使用方式¶
- Web 界面：在側邊欄設置行點擊柱狀圖圖標，即可打開 Token 使用量模態框。
- 對話調用：在聊天中指示 Agent 調用
usage_report模型工具（例如使用refresh參數強制刷新或top參數限制顯示行數）。
注意事項¶
- 本地化與隱私：插件僅對
~/.dsh/sessions/**下的日誌文件進行只讀解析（支持流式 zstd 解壓）。不發送任何網絡請求，不收集遙測數據，也不進行任何寫入操作。 - 環境依賴：運行需要本地環境具備 React 18.2.0 及 DeepSeek 相關的 Cordis 和 Schemastery 依賴。
結語¶
這是一個純本地、只讀的 Token 分析工具，適合需要詳細追蹤模型調用成本的 DSH 用戶。
