前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在使用 DSH 進行開發或調試時，追蹤 token 消耗是常見的剛需。dsh-token-heatmap 提供了一種直觀的監控方式，通過 GitHub 風格的貢獻圖展示用量。
插件簡介¶
這是一個可拖動的浮動窗口，用於顯示 DeepSeek Harness 的 token 用量。它基於本地會話日誌進行統計，沒有網絡請求和遙測行爲。由 cccchensy 開發，採用 MIT 許可證。
核心功能¶
- GitHub 風格熱力圖：頂部顯示今日總量，下方顯示最近 30 天的用量。
- 年度面板：懸停時會展開年度面板，包含總量、活躍天數、日均、當前與最長連續天數、最佳單日，以及每日的輸入/緩存/輸出拆分。
- 可拖動窗口：支持拖動到任意位置，位置會被記住。
- 運行狀態指示：有會話在運行時，窗口會緩慢閃爍。
- 本地統計：直接讀取會話日誌，無網絡請求，支持統計 subagent（可配置）。
安裝與啓用¶
在任意會話中，向 agent 發送以下命令即可安裝：
github:cccchensy/dsh-token-heatmap
插件按 profile 生效，安裝後重啓 DSH 即可加載。卸載和更新插件需在 Plugins 頁面操作，更新後必須重啓 DSH。
使用說明¶
- 拖動：按住窗口任意位置可拖動到屏幕其他位置。
- 查看詳情：鼠標懸停可展開年度面板，查看詳細的輸入、緩存和輸出數據。
- 摺疊：雙擊窗口可將其摺疊成只剩標題行。
- 狀態閃爍：當有會話在運行時，窗口會緩慢亮滅，表示有活動，而非此刻正在消耗 token。
侷限與注意¶
由於插件基於日誌讀取，存在以下口徑差異和限制：
* 統計口徑：數字準確到最後一個已提交的 step，而不是最後一個生成的 token。
* 官方對齊：口徑與官網用量頁一致，但會低 0.25%。這源於重試失敗的請求，官方計入服務端已處理的 prompt，而 Harness 不把失敗嘗試的用量寫進日誌。
* 數據範圍：無法獲取服務端已處理但失敗的 prompt。
* 去重機制：同一份會話歷史被複制進多個日誌時（如 subagent 快照、fork）只算一次，按指紋去重。
* 壓縮摘要：壓縮摘要本身是一次計費調用，已計入統計。
* 閃爍含義：閃爍表示「有會話在運行」，而非「此刻正在消耗 token」。
* 權限與更新：插件以當前 dsh 進程權限運行。更新插件後必須重啓 DSH。
結語¶
dsh-token-heatmap 是一個輕量級的本地監控工具，適合需要直觀追蹤 token 消耗的開發者。其 GitHub 風格的界面降低了認知負擔，且完全本地化運行。更多詳情請查看 插件目錄 或 GitHub 倉庫。
