前言¶
DeepSeek Harness（DSH）把功能擴展交給插件。對使用 DSH Web 的開發者來說，Token 用量往往需要從會話日誌裏整理出來；如果要做累計回顧、單日峯值檢查、連續天數觀察，就需要一個集中展示入口。
QuanWenG/token_usage_heatmap 是面向 DSH Web 設置頁的 Token 使用統計插件。它提供最近 53 周的每日、每週和累計視圖，並支持鼠標懸浮與鍵盤聚焦查看明細。該插件不修改 DSH 源碼。
這是什麼¶
這個插件由 QuanWenG 維護，倉庫爲 QuanWenG/token_usage_heatmap。它面向 DSH 的 web profile，兼容 DeepSeek Harness >=0.1.0-rc.5 <0.2.0，許可證爲 MIT。
安裝後，它會在 DSH Web 的“設置 → 個人統計”中展示 Token 使用統計，包括累計 Token、單日峯值、最長聊天時長、當前連續天數、最長連續天數，以及 53 周熱力圖。
核心功能¶
下面介紹插件已列出的主要能力：
- 展示累計 Token、單日峯值、最長聊天時長、當前連續天數和最長連續天數。
- 提供最近 53 周的每日、每週和累計三種視圖。
- Token 使用量越高，格子顏色或周柱高度越明顯。
- 鼠標懸浮和鍵盤聚焦均可查看精確 Token 數，以及輸入、輸出、緩存讀取、緩存寫入明細。
- 支持中英文、亮色/暗色主題、橫向滾動和響應式佈局。
- 從已有會話日誌即時派生統計，安裝前的歷史記錄也會自動納入。
- 不修改 DSH 源碼。
安裝與啓用¶
克隆源碼後安裝¶
先克隆倉庫並進入插件目錄：
git clone https://github.com/QuanWenG/token_usage_heatmap.git
cd token_usage_heatmap
接下來安裝依賴，並執行測試、類型檢查和構建：
pnpm install
pnpm test
pnpm typecheck
pnpm build
然後在插件目錄中執行安裝、配置導出和啓動命令：
dsh plugin --profile web add .
dsh --profile web --dump-config
dsh --profile web
啓動後打開：
http://127.0.0.1:3080
進入“設置 → 個人統計”查看插件頁面。
直接從 GitHub 安裝¶
也可以直接把 GitHub 倉庫加入 web profile，並鎖定 tag 或 commit：
dsh plugin --profile web add github:QuanWenG/token_usage_heatmap#<tag-or-commit>
命令中的 <tag-or-commit> 是佔位符，實際安裝時需要替換爲具體 tag 或 commit。
pnpm 構建腳本注意¶
源碼構建要求 Corepack，倉庫固定使用 pnpm 11.7.0。直接從 GitHub 安裝時，要求 pnpm 10 或更高版本。
pnpm 10 及以上默認禁止依賴在安裝期間執行構建腳本。如果首次安裝被拒絕，需要先確認源碼可信，再把該 profile 的 pnpm-workspace.yaml 中加入 allowBuilds 配置：
allowBuilds:
dsh-plugin-token-usage-heatmap: true
確認源碼可信後，重新運行安裝命令。
典型用法¶
安裝成功後，打開 DSH Web 的“設置 → 個人統計”，即可看到累計 Token、單日峯值、最長聊天時長、當前連續天數和最長連續天數。
熱力圖會展示最近 53 周的每日、每週和累計視圖。Token 使用量越高，格子顏色或周柱高度越明顯。
鼠標懸浮或鍵盤聚焦到某個統計單元時，可以看到精確 Token 數，以及輸入、輸出、緩存讀取、緩存寫入明細。統計從已有會話日誌即時派生，安裝前已經存在的歷史記錄也會納入統計。
配置注意¶
如果需要同步調整插件配置，可在 profile 的 cordis.patch.yml 中覆蓋 maxConcurrentSessionReads。允許範圍是 1–32：
maxConcurrentSessionReads: 1
上面的 1 只是範圍下限示例，實際值按需要選擇。DSH 的後置 patch 會替換整份 config，而不是深度合併，因此覆蓋插件配置時需要保留所有仍然需要的配置鍵。
連續天數與刪除會話¶
今天沒有使用量時，不會立即中斷當前連續天數；如果今天產生使用量，則今天會計入連續天數。
刪除會話後，該會話的 Token 貢獻會在下次讀取時消失。插件不會創建或複製會話事件。
適用場景與注意¶
適合使用 DSH web profile，並且希望在一個設置頁內回顧 Token 用量、53 周使用趨勢和連續天數的開發者。使用前應確認運行版本在兼容範圍內：DeepSeek Harness >=0.1.0-rc.5 <0.2.0。
插件會以當前 dsh 進程權限運行，並讀取會話日誌來派生統計，因此安裝前應檢查源碼、許可證和依賴。本插件許可證爲 MIT。
社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不要把它理解爲官方應用商店。
鏈接¶
- GitHub：
https://github.com/QuanWenG/token_usage_heatmap - 目錄頁線索：
https://www.skillhub.cn/plugins/QuanWenG/token_usage_heatmap
