前言¶
跑過一段時間 DSH（DeepSeek Harness）的開發者，多半會有一個疑問：Token 到底花在哪了？是某個長會話喫掉的，還是某個插件、某個 Skill 在持續消耗？DSH 內置的 token-meter 有數據，但界面上沒有一個地方能把整個實例的消耗彙總起來直接看。
dsh-token-usage 解決的就是這個問題：在 DSH Web 界面里加一個 Token 用量統計面板，把當前運行實例全部會話的 Token 消耗彙總展示。界面仿 Codex 個人用量頁風格，用過 Codex 的開發者幾乎零學習成本。
這是什麼¶
dsh-token-usage 是 jiamuAi 開發的 DSH 插件，當前版本 0.1.0，狀態爲 beta，許可證 MIT。一句話定位：DSH Token 用量統計面板（Codex 風格）——全實例 Token 消耗彙總 + 活動熱力圖。
插件依賴 DSH 內置包（@deepseek-ai/*），放進 DSH 倉庫即可自動解析，無需額外安裝。倉庫裏已提交構建產物 lib/，裝了就能跑。
核心功能¶
- 5 大指標：累計 / 單會話峯值 Token、最長聊天時長、當前 / 最長連續天數
- Token 活動熱力圖：每日（GitHub 貢獻圖風格）/ 每週（柱狀）/ 累計（折線）三視圖，懸浮看數值
- 活動洞察 + Top5：含最常用模型的活動洞察，以及插件 / Skill Top5
- 兩個原生入口：側邊欄底部「Token 統計」按鈕（應用級常駐）；會話頭部即時用量膠囊，每 5 秒自動刷新
- 深空紫雙主題（深色 / 淺色），跟隨系統或手動切換
- 數據每 5 秒刷新，歷史會話自動回填，重啓不丟
數據口徑與 DSH 內置 token-meter 一致：累計 Token = input + output + cacheRead + cacheWrite，不重複計數。
安裝與啓用¶
有兩種安裝方式。
方式一：讓 Agent 一句話裝好（推薦）¶
把這句話發給你的 DSH Agent，它會自己讀倉庫說明並完成安裝：
你看一下這個倉庫：https://github.com/jiamuAi/dsh-token-usage ，然後幫我把 dsh-token-usage 安裝到我的 DSH 上。
方式二：手動安裝¶
先克隆倉庫並複製到 DSH 源碼的插件目錄，再在 DSH 倉庫根目錄執行安裝和構建：
git clone https://github.com/jiamuAi/dsh-token-usage.git
cp -R dsh-token-usage <你的deepseek-harness路徑>/packages/extensions/
cd <你的deepseek-harness路徑> && pnpm install && pnpm run build:lib
<你的deepseek-harness路徑> 指 DSH 源碼在你機器上的位置。不知道在哪，終端執行：
readlink -f $(which dsh)
可以看到 dsh 的真實路徑，往上找 deepseek-harness 目錄就是。
複製完成後，編輯 ~/.dsh/profiles/web/package.json，在 dsh.profile.bundles 里加上 "dsh-token-usage"，然後重啓 dsh web 並刷新頁面。
兩點說明：
1、lib/ 是已提交的構建產物，一般使用者無需構建。想改代碼的話，需要把 src/ 放進 DSH 倉庫的 packages/extensions/dsh-token-usage/ 下，用 DSH 倉庫的編譯工具（tsc + tsdown + Typert 生成器）構建，產物同步回倉庫提交。
2、插件依賴 DSH 內置包（@deepseek-ai/*），放進 DSH 倉庫後自動解析，不需要額外安裝依賴。
典型用法¶
安裝啓用後，按下面步驟使用：
1、重啓 dsh web 後，左側欄底部出現「Token 統計」入口。
2、打開任意會話，標題旁出現即時用量膠囊，例如 ⚡ 2.61億，每 5 秒自動刷新。
3、點擊任一入口打開面板，右上角可以切換主題、關閉面板。
4、熱力圖支持三視圖切換，懸浮可查看單日 / 單週 / 累計數值。
數據每 5 秒刷新，歷史會話自動回填，重啓後不丟。
適用場景與注意¶
適合這些人：
- 長期使用 DSH、想知道 Token 具體去向的個人開發者
- 熟悉 Codex 用量頁、希望 DSH 有同類視圖的用戶
- 需要排查哪個插件或 Skill 消耗最多的使用者
使用前注意兩點：
1、插件當前爲 beta（0.1.0），功能和數據口徑可能隨版本調整。
2、插件以當前 dsh 進程權限運行，安裝前建議先查看倉庫源碼與許可證（MIT），確認無誤再裝。
結尾¶
dsh-token-usage 做的事情很單一：把 DSH 已經記錄的 Token 數據變成一個能直接看的面板，累計、峯值、熱力圖、插件 Top5 一屏呈現。如果你在關心「Token 花哪去了」，可以裝上試試。
- GitHub 倉庫：https://github.com/jiamuAi/dsh-token-usage
- 社區目錄頁：https://www.skillhub.cn/plugins/jiamuAi/dsh-token-usage
需要說明的是，skillhub.cn 是獨立的社區插件目錄站點，與 DeepSeek / 幻方無官方從屬關係，僅作爲插件索引使用。
