dsh-token-pulse：本地 Token 熱圖插件

DeepSeek Harness（DSH）採用插件化架構，dsh-token-pulse 是其中一款本地 Token 監控工具。它通過讀取本地會話日誌，生成 GitHub 風格的日曆熱圖，解決在沒有云端儀表盤時追蹤 Token 消耗的需求。

安裝與啓用¶

1. 確保本地已安裝 Node.js ≥ 23.8（插件依賴內置的 node:zlib 進行 zstd 解碼）。
2. 確保已啓動 DSH Web profile（dsh web 已運行）。
3. 執行安裝命令：

dsh plugin --profile web add dsh-token-pulse

4. 安裝完成後，重啓 DSH Web 服務，進入設置頁面即可找到 Token Pulse 欄目。

核心功能¶

• 視圖切換：支持周、月、季度、年四種視圖。
  • 周視圖：每天展開爲 24 個小時柱狀圖，用於觀察高峯時段。
  • 月視圖：日曆格顯示日期與當日用量。
  • 季度/年視圖：採用 GitHub 風格的日曆格，季度視圖放大以便觀察，年度視圖採用雙行排布。
• 統計展示：
  • 頂部展示今日、本週、本月及累計總量的統計數據。
  • 支持按模型或供應商查看 Top 5 統計數據。
• 數據與刷新：
  • 本地持久化：歷史數據落盤保存，刪除會話不會丟失記錄。
  • 自動刷新：支持 5 / 10 / 30 / 60 分鐘的自動刷新，也可手動刷新。
• 語言與設置：支持中/英文界面切換。

使用與配置¶

• 數據源：插件僅讀取本地會話日誌。請確認 $DSH_HOME/sessions 目錄下存在包含 usage 字段的日誌文件，否則可能顯示爲 0。
• 重置歷史：如需清空所有歷史統計數據，進入設置頁右上角 ... 菜單，選擇「重置歷史」。

注意事項¶

• 時區：插件固定使用北京時區，周起始日爲週一。
• 網絡與計費：零網絡請求，零計費接口調用，僅作爲只讀工具運行。

生態背景¶

DSH 理念是“一切皆插件”。本插件爲社區維護項目（MIT 協議），維護者：Hou-DL。

• GitHub 倉庫