前言¶
DeepSeek Harness (DSH) Web GUI 是一個基於瀏覽器和 Node.js 的集成環境，常用於智能體開發和模型調用測試。在日常使用中，精確掌握每日的 Token 消耗量對於控制成本、排查異常高耗以及優化 Prompt 至關重要。目前 DSH 原生界面缺乏可視化統計功能，手動統計或依賴外部腳本操作繁瑣。面向這一場景，dsh-plugin-token-heatmap 插件提供了一個直觀的解決方案。
插件概覽¶
這是一個面向 DeepSeek Harness Web GUI 的每日 Token 用量熱力圖插件。它通過懸浮窗的形式展示歷史與實時用量，幫助用戶快速識別使用模式。
- 維護者: P-CAmilE
- 許可證: MIT
核心功能¶
該插件主要提供以下能力：
- 雙數據視圖：懸浮窗內支持在「全局」（所有會話合計）與「當前會話」之間切換查看。
- 歷史回填：首次安裝時，插件會自動掃描所有歷史會話日誌，將過去的數據計入熱力圖。
- 實時更新：窗口可見時，系統每 3 秒輪詢一次數據。數據攜帶版本號，僅當數值變化時觸發更新。
- 可視化展示：採用 5 級藍色色階（最深色爲
#396BE2），根據非零天數的四分位進行分檔。支持豎向網格，展示 12 個月窗口，包含「回到最新」的快捷操作。 - 交互與記憶：支持拖動懸浮窗，窗口位置會被記錄在
localStorage中。支持顯隱控制，並適配 DSH 的深淺主題。 - 彙總統計：提供今日、本週、本月及 12 個月合計數據。鼠標懸停可查看輸入、輸出、緩存讀寫等分項詳情。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add dsh-plugin-token-heatmap
安裝完成後，重啓 DSH Web，右下角會出現一個方形圖標，即表示插件已啓用。
典型用法¶
- 查看數據：點擊右下角的方形圖標，懸浮窗會顯示當前的 Token 用量熱力圖。
- 切換視圖：在懸浮窗頂部點擊，在「全局」和「當前會話」之間切換數據源。
- 瀏覽歷史：熱力圖默認展示最新一週，向下滾動可查看更早的 12 個月數據。
- 查看詳情：鼠標懸停在某個色塊上，可查看該日的詳細用量統計。
環境與注意事項¶
- 運行環境：插件依賴
@deepseek-ai/*運行時（私有包），僅能在 DSH 環境內安裝和使用。 - 開發依賴：本地構建需要 Node.js >= 20 和 pnpm。
- 數據存儲：插件的持久化數據存儲在宿主端的
$DSH_HOME/token-heatmap/目錄（即~/.dsh/token-heatmap/）。 - 容錯機制：如果文件損壞，插件會從空狀態啓動並告警，不會導致 DSH 進程崩潰。
- 權限範圍：插件以當前 DSH 進程的權限運行，建議在安裝前查看源碼與許可證。
結語¶
dsh-plugin-token-heatmap 爲 DSH Web 用戶提供了一個輕量級的 Token 追蹤工具。通過可視化的色階和實時更新機制，可以更直觀地管理開發成本。更多細節與源碼，可參考其 GitHub 倉庫。
