前言¶

DeepSeek Harness（下文簡稱 dsh）是 DeepSeek AI 開源的智能體運行時，架構口號是「Everything is a Plugin / 一切皆插件」。模型、工具、會話、沙箱和界面都可以拆成插件來組合。日常用它寫代碼、跑任務時，用量其實一直在漲：每個回合消耗多少 Token、緩存命中高不高、哪個工作區最燒額度，默認界面並不集中展示。

GitHub 貢獻圖那種 53 周綠格子，很多人已經習慣用它判斷「這周有沒有在幹活」。Make0209 維護的社區插件 dsh-usage-stats，就是把類似的活躍格子，加上 Token、緩存命中、賬戶餘額和工作區別名，裝進 dsh Web 端的設置頁。

需要先說明兩點。第一，DeepSeek Harness 插件目錄 是社區獨立站點，和 DeepSeek / 幻方沒有官方從屬關係。第二，官方倉庫目前仍標註 developer preview，接口可能不兼容。本文按 2026 年 8 月 18 日打開的目錄詳情頁、GitHub 倉庫 README 與源碼交叉覈對，不編造使用反饋。

這是什麼¶

dsh-usage-stats 是面向 DeepSeek Harness Web 端的用量看板插件，目錄分類爲「工具與能力」，許可證 MIT，主要語言 JavaScript，package.json 中的版本號爲 1.0.0。維護者是 Make0209。截至 2026 年 8 月 18 日，GitHub 倉庫 star 數爲 17。

一句話定位：掃描本機持久化會話日誌，按已註冊工作區聚合回合次數和 Token，在設置面板裏畫出 53 周 GitHub 風格熱力圖，並附帶餘額查詢與工作區別名。

GitHub 上還有其他同名倉庫，功能和安裝命令並不相同。本文只寫 Make0209/dsh-usage-stats。安裝時請帶上完整倉庫路徑，不要只憑插件名搜索。

核心功能¶

倉庫 README 和源碼對得上的能力，可以分成下面幾塊。

1、53 周用量熱力圖。格子配色接近 GitHub 綠，按「完成一個回合點亮一次」計數，口徑包含子代理會話。顏色分五檔：0 次、1 次及以上、3 次及以上、6 次及以上、10 次及以上。鼠標懸停某一天，會按工作區列出當日回合次數，以及輸入 / 緩存命中 / 輸出 Token。點擊工作區芯片可以篩選熱力圖和明細表。

2、統計卡片。頁面默認展示：總花費 Token（輸入、緩存命中、輸出、推理分項）、緩存命中率、賬戶餘額、各工作區 Token 花費進度條（先列出用量最高的 3 個）、總使用次數、連續使用天數。緩存命中率按 cacheRead / (input + cacheRead) 計算。卡片數字首次加載時有滾動動畫，界面跟隨 Web UI 的亮暗主題。

3、時間範圍。右上角可以在「近 30 天」「近 90 天」「全部」之間切換，默認是近 90 天。熱力圖本身固定覆蓋約 53 周；30 / 90 天主要影響卡片彙總和工作區明細表。

4、工作區別名。頭部有「✎ 工作區別名」按鈕。別名寫入 $DSH_HOME/storages 裏的 KV 單元 usage-stats-aliases，卸載或重啓後仍在。單個別名最長 80 個字符；回車保存一項，清空輸入框則恢復文件夾名，也可以一次性全部保存。

5、數據來源。使用次數和 Token 全部來自 dsh 持久化會話日誌，Host 半讀取 turn/end 與 assistant/message.usage，並監聽 session/event 做即時摺疊。插件激活時會回填歷史，卸載或重啓不會丟掉這些日誌。只統計能按會話 cwd 匹配到已註冊工作區的會話，匹配不上的不會出現在圖上。

6、賬戶餘額。餘額走 DeepSeek 開放平臺的 https://api.deepseek.com/user/balance，複用 llm-deepseek 的 API Key 配置，插件自己不另存一份密鑰。未配置 Key 時卡片會顯示引導文案。查詢結果默認緩存 5 分鐘；頁面上的「刷新」會帶 force=1 強制再查。

插件包聲明瞭 dsh.bundle manifest 和 Web client 半，package.json 裏 dsh.client.platform 爲 web。Host 半在 lib/index.js，Client 半在 lib/client.js，通過設置面板槽位 settings.section 註冊名爲「用量統計」的一頁。README 寫明包內無第三方依賴：Host 只用 Cordis 服務，Client 只用模塊表提供的 React。

安裝與啓用¶

目錄頁給出的安裝命令如下，在 DeepSeek Harness 終端裏運行即可。dsh CLI 會從 GitHub 解析插件並裝進當前配置：

dsh plugin add github:Make0209/dsh-usage-stats

這是社區插件，會以當前 dsh 進程的權限運行，安裝時可能執行代碼。裝之前先看倉庫源碼和 MIT 許可證。需要可復現安裝時，把 commit 哈希釘死。倉庫 main 分支在 2026 年 8 月 14 日的最新提交是 8992d306cdca8857b4362868d591fde3689765b0：

dsh plugin add github:Make0209/dsh-usage-stats#8992d306cdca8857b4362868d591fde3689765b0

倉庫 README 另外給了一條針對 Web profile 的寫法，和這個插件的 platform: web 聲明一致。如果當前默認 profile 不是 web，可以用這一條：

dsh plugin --profile web add dsh-usage-stats

README 的說明是：安裝後刷新頁面即可，不必手改配置、也不必重啓 dsh。如果是本地目錄調試，README 還提供了手動註冊步驟：在 $DSH_HOME/profiles/node_modules/ 下做符號鏈接（Windows 用 junction），再往 $DSH_HOME/profiles/web/cordis.patch.yml 插入：

- insert:
    - id: usage-stats
      name: dsh-usage-stats

用戶 patch 層會熱重載，保存後再刷新頁面。

典型用法¶

裝好並刷新 Web UI 之後，按下面順序就能看到數據。這些步驟對應 README 和 lib/client.js 裏的界面，不是額外編出來的操作手冊。

1、打開設置，進入「用量統計」。Client 半把頁面掛在 settings.section 槽位，標籤就是這四個字。首次進入可能顯示「正在加載用量統計…」，隨後會出現歷史回填進度條，文案類似「正在統計歷史會話 scanned / total」。掃描結束後進度條消失。

2、看卡片和熱力圖。如果本機還沒有能歸屬到工作區的會話，頁面會提示「還沒有使用記錄。開始對話後，這裏會點亮。」有數據時，上方是六張卡片，下方是 53 周格子和工作區明細表。明細表列回合、輸入、緩存命中、輸出、推理、合計、命中率和佔比。

3、切換時間範圍。點「近 30 天」「近 90 天」或「全部」。熱力圖格子仍按 53 周排布；卡片上的 Token、命中率、回合數，以及明細表，會按所選窗口重算。

4、懸停和篩選。把鼠標放在某個格子上，能看到該日各工作區的次數和 Token。點熱力圖上方的工作區芯片，或點明細表某一行，可以只看這個工作區；再點一次取消篩選。

5、改工作區別名。點「✎ 工作區別名」，給已註冊工作區填項目名，回車保存單項，或點「全部保存」。別名會出現在芯片、懸停提示和明細表標題上，底層路徑仍保留。

6、看餘額。已在 dsh 裏配好 DeepSeek API Key 時，卡片會顯示幣種和金額（源碼按 CNY / USD 格式化）。沒配 Key 時不會報錯退出，只是卡片處於缺密鑰狀態。點「刷新」會強制再查一次餘額，同時刷新統計快照。

Host 半對外暴露的數據路由也可以對照源碼理解頁面從哪取數，一般不用手工調用：

• GET /api/usage-stats：統計快照（含掃描進度、按日數據、工作區彙總、別名）
• GET /api/usage-stats/balance?force=1：賬戶餘額
• POST /api/usage-stats/alias：設置工作區別名

適用場景與注意事項¶

這個插件適合已經在用 dsh web、並且希望把本機會話用量看清楚的人：要覈對緩存命中是否生效、比較多個工作區的 Token 佔比、或者只是想用一張年曆圖回顧自己最近有沒有持續在用 dsh。它不做計費賬單導出，也不統計未註冊工作區裏的會話。

使用前注意下面幾條，都來自 README 或源碼，不是推斷。

1、運行權限。插件以當前 dsh 進程權限運行，安裝時可能執行代碼。裝之前檢查 源碼倉庫 和 MIT 許可證。

2、只覆蓋能匹配工作區的會話。統計按會話 cwd 去對已註冊工作區路徑。cwd 爲空、或對不上任何工作區的會話，不會進入熱力圖和明細。

3、面向 Web UI。package.json 聲明 client platform 爲 web，設置頁也只掛在 Web 端。純終端 / TUI 用法不在這個插件的範圍內。

4、餘額查詢的環境依賴。用量統計本身讀本地日誌，不需要聯網。餘額則要有 API Key，並且 Host 半會拉起 curl.exe 或 powershell.exe 去請求官方接口。當前實現明顯偏向 Windows；在沒有這兩條命令的環境裏，熱力圖和 Token 卡片仍可用，餘額卡片可能一直失敗。

5、同名插件不要裝錯。社區裏至少還有其他 dsh-usage-stats 倉庫，有的做多供應商餘額，有的做 CSV 導出。目錄頁安裝命令帶的是 github:Make0209/dsh-usage-stats，以這一條爲準。

6、dsh 仍在快速迭代。官方 README 寫明 developer preview，可能出現破壞性變更。釘死 commit 比始終跟蹤 main 更容易復現。

小結¶

dsh-usage-stats 把 GitHub 貢獻圖那套 53 周格子搬進了 DeepSeek Harness 的設置頁，並補上 Token 分項、緩存命中、連續使用天數、工作區別名和（在 Key 可用時）官方餘額。數據來自本機會話日誌，安裝後會回填歷史，不另搞一套賬本。

它是 Make0209 維護的 MIT 社區插件，不是 DeepSeek 官方應用商店裏的條目。目錄頁和倉庫地址如下，安裝前建議對照源碼再執行命令：

• 目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-usage-stats-make0209/
• GitHub：https://github.com/Make0209/dsh-usage-stats
• DeepSeek Harness 官方倉庫：https://github.com/deepseek-ai/deepseek-harness