前言¶
在 DeepSeek Harness（DSH）的 Web GUI（dsh web）中，開發者經常需要查看兩類信息：當前會話消耗了多少 token、上下文佔用處於什麼水平；近 30 天每日消耗和按模型消耗如何分佈。
DSH 的插件機制遵循“一切皆插件”的思路。dsh-token-usage 是其中一個 Token 用量展示插件，由 AFAP 維護；社區目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係。
下面介紹它的功能、安裝方式和注意點。
這是什麼¶
dsh-token-usage 是一個用於 dsh web 的 Token 用量展示插件。它不要求配置，也不修改文件，面向需要查看會話級與全局 token 消耗的使用者。插件許可證爲 MIT。
核心功能¶
單會話膠囊¶
在會話頭部右側顯示當前會話的輸入、輸出和上下文佔用。點擊膠囊後，會彈出四組明細：提供方用量、上下文構成、上下文壓力、會話統計。
全局消耗面板¶
在側邊欄底部提供“Token 統計”按鈕。打開全局面板後，可展示近 30 天每日消耗、按模型分解、按日明細。數據來自會話日誌，即時掃描聚合；面板打開時每 60 秒自動刷新。
數據與運行約束¶
- 無需任何配置。
- 不修改任何文件；全局面板只讀掃描
$DSH_HOME\sessions下的會話日誌，不寫入、不刪除、不改動日誌。 - 宿主半部零外部依賴，僅使用 Node 內置能力和
./stats.js。 DSH_HOME從環境變量解析：$DSH_HOME→~/.dsh。- 日誌格式爲多幀 zstd 容器；宿主半部使用 Node 22.22+ 內置
zstdDecompressSync，並跳過崩潰殘留的不完整尾幀。 /api/token-stats以 exact 路由註冊，並帶瀏覽器信任圍欄（loopback / trustedHosts + same-origin 檢查），用於拒絕 DNS 重綁定與跨站請求。- 語言跟隨界面，內置簡體中文和 English 詞典。
- 已聚合數據帶本地緩存，反覆打開或重啓
dsh後無需重新統計。
安裝與啓用¶
先執行安裝命令，然後重啓 dsh web 生效。
dsh plugin --profile web add github:AFAP/dsh-token-usage
安裝完成後，插件位於：
$DSH_HOME\profiles\web\node_modules\dsh-token-usage
該位置與源碼倉庫位置無關。
如果需要從本地源碼目錄安裝：
dsh plugin --profile web add "D:\path\to\dsh-token-usage"
升級和卸載命令如下：
dsh plugin --profile web update dsh-token-usage
dsh plugin --profile web remove dsh-token-usage
典型用法¶
1、驗證是否加載成功：打開任意會話，查看頭部右側是否出現 token 膠囊，以及側邊欄底部是否出現“Token 統計”按鈕。
2、打開全局面板：點擊側邊欄底部的“Token 統計”。面板打開後每 60 秒自動刷新，也可手動刷新。
3、查看單日分佈：點擊某天柱子，可展開該日 24 小時用量分佈。
4、關閉面板：按 Esc 或點擊遮罩關閉。
適用場景與注意¶
適合在 dsh web 中運行會話，並希望查看當前會話 token 佔用、上下文壓力、近 30 天消耗和按模型分佈的使用者。
插件會以當前 dsh 進程權限運行。安裝前應先檢查源碼、接口行爲和許可證；本插件許可證爲 MIT。
全局面板依賴 $DSH_HOME\sessions 下的會話日誌，統計結果以可掃描的會話日誌爲準。
鏈接¶
目錄頁（獨立社區站點，不代表 DeepSeek 或幻方官方從屬關係）：
https://www.skillhub.cn/plugins/AFAP/dsh-token-usage
