前言¶
使用 DeepSeek Harness（DSH）時，模型調用記錄通常分散在會話日誌裏。如果想回看過去一段時間每天用了多少 Token、哪些模型消耗較多，常見做法是翻日誌或自己寫統計腳本。
snownightt/dsh-token-activity 是一個面向 DeepSeek Harness 的第三方插件。它把最近 365 個本地自然日的每日 Token 消耗展示成熱力圖，並能在懸停日期時查看當天全部模型及各自 Token 用量。
這是什麼¶
snownightt/dsh-token-activity 由 SnowNightt 維護，GitHub 倉庫地址是 https://github.com/SnowNightt/dsh-token-activity，許可證爲 MIT。
它解決的問題很具體：在 DeepSeek Harness Web 界面裏提供一個“使用量”入口，用於查看累計 Token、峯值 Token，以及按日聚合的歷史 Token 消耗。
核心功能¶
- 設置界面新增一級導航「使用量」。
- 頂部指標卡展示累計 Token 與峯值 Token。
- 展示最近 365 個本地自然日的每日 Token 消耗熱力圖。
- 懸停任意日期時，顯示當日總量、日期、全部模型及各自 Token。
- 歷史會話自動回填，並即時展示回填進度。
- 單個會話回填失敗不影響整體統計。
安裝與啓用¶
下面介紹從 npm 包安裝並啓用的流程：先安裝插件，再啓動 Web 服務，最後檢查配置。
安裝插件：
dsh plugin --profile web add @snownightt/dsh-token-activity-bundle
安裝完成後，啓動 DeepSeek Harness Web 服務：
dsh web
經過上面的步驟後，可以檢查組合配置：
dsh --profile web --dump-config
輸出中應包含：
token-activity
ui-token-activity
注意：安裝或卸載插件後，需要重啓 DeepSeek Harness Web 服務。
典型用法¶
- 安裝插件後，啓動 DeepSeek Harness Web 服務：
dsh web
-
在瀏覽器打開 DeepSeek Harness Web 界面，進入「設置」，點擊一級導航中的「使用量」。
-
首次打開時，等待歷史會話自動回填完成。單個會話讀取失敗不會中斷其他數據統計。
-
回填完成後，頁面會展示累計 Token、峯值 Token、最近 365 個本地自然日的 Token 消耗熱力圖。懸停任意日期，可以看到當日總量、日期、全部模型及各自 Token。
適用場景與注意¶
這個插件適合需要在 DeepSeek Harness Web 界面裏查看歷史 Token 消耗、按日期回看模型用量的開發者。
它基於 DeepSeek Harness 會話日誌統計已記錄模型調用 Token，不直接讀取 API 提供商賬戶賬單。因此，插件顯示的累計量應理解爲 Harness 會話已記錄 Token，不能替代 API 提供商平臺的賬戶用量。費用、餘額或最終計費，以 API 提供商官方平臺爲準。
以下情況可能導致插件統計值與官方平臺數據不一致：
- 自動標題生成、上下文壓縮等輔助模型調用可能未完整計入；
- 網頁搜索響應 Token 用量目前不寫入本插件統計來源；
- 失敗、取消或重試請求，僅在 Harness 會話日誌保存
usage時統計。
此外，該插件會隨當前 dsh 進程加載，運行權限取決於當前 dsh 進程。安裝前建議檢查 GitHub 源碼和 MIT 許可證。
如果要從 npm 安裝版本卸載，可執行：
dsh plugin --profile web remove @snownightt/dsh-token-activity-bundle
卸載後同樣需要重啓 DeepSeek Harness Web 服務。
結尾¶
snownightt/dsh-token-activity 的價值不是替代 API 提供商賬單，而是給 DeepSeek Harness 的會話日誌提供一個按日聚合的 Token 消耗視圖。適合先通過本地會話日誌快速判斷用量趨勢，再按官方平臺數據覈對費用。
目錄頁：https://www.skillhub.cn/plugins/SnowNightt/dsh-token-activity
GitHub：https://github.com/SnowNightt/dsh-token-activity
