前言¶
在 DSH 裏混用 DeepSeek、本地模型和其他廠商 API 時，會話能正常進行，但「花了多少 token、賬戶裏還剩多少錢」往往要另開控制台或翻日誌。DeepSeek Harness 的插件生態支持把這類能力掛進客戶端界面。下面介紹社區插件 dsh-tok-qty：在對話輸入框右下角狀態欄顯示總餘額，並基於本機會話日誌統計今日、本週、本月的用量，同時區分 DeepSeek 與其他 provider 的佔比。
這是什麼¶
dsh-tok-qty 由維護者 loiter1EM 發佈，在 SkillHub 插件目錄 中歸類爲 admin-security。當前 package.json 版本爲 1.1.0，許可證 MIT，面向 web 客戶端（dsh.client.platform: web）。
一句話定位：在 composer 狀態欄展示 DeepSeek 賬戶餘額，並從本地 assistant/message 事件聚合 token 統計；餘額可走官方 GET /user/balance，統計範圍覆蓋 DSH 會話裏記錄的調用，也能把非 DeepSeek 模型按廠商分組展示。
核心功能¶
狀態欄與面板¶
輸入框右下角狀態行會出現錢包圖標和總餘額（例如 總餘額 ¥31.99）。點擊後展開面板：
- 今日 / 本週 / 本月 切換，頂部總量隨當前標籤變化（面板頂部的總量僅統計 DeepSeek 調用）。
- 分時段面積圖：今天按 24 小時分桶，本週按 7 天，本月按當月每天；懸停顯示豎線、圓點與該時段數值。
- 橫向柱狀圖：同一時間段內，本地模型與 Anthropic、OpenAI、OpenRouter 等廠商各用多少，便於對比 DeepSeek 佔比。
- 明細行：緩存讀取、未緩存輸入、輸出、緩存命中率。
- 右上角刷新即時重算；旁側齒輪進入設置（面積圖峯谷配色、柱狀圖分組配色、五類字段顯隱，底部「恢復默認」）。
設置保存在瀏覽器 localStorage；關閉面板再打開仍回到統計視圖，不會留在設置頁。
數據來源與憑據¶
- 餘額：DeepSeek 官方
GET /user/balance，由宿主進程代發，瀏覽器側不接觸 API key。 - 用量：讀本機會話日誌中的
assistant/message事件，全部在本機計算，不上傳任何數據。 - 讀取 API key 的順序：DSH 憑據服務 → 環境變量
DEEPSEEK_API_KEY。只要 DSH 本身能調用 DeepSeek，此處即可顯示餘額。
與其他統計方式的區別¶
插件只統計寫入會話日誌的調用；在 DSH 之外用同一 API key 產生的消耗不會進入用量圖表（餘額本身仍是全賬戶）。「其他模型」分組按 provider 前綴識別 WorkBuddy、本地模型（lm-*、omlx、local）和常見廠商，其餘歸入「其他」。
安裝與啓用¶
在能使用 dsh plugin 的環境中執行（命令來自倉庫 README）：
dsh plugin --profile web add dsh-tok-qty
裝完後重啓 DSH。插件自帶 cordis.patch.yml bundle patch，一般無需再改宿主側的 cordis.patch.yml。
兼容性要點：
- 需要能在
conversation.composer.dock註冊的 DSH 客戶端（依賴@deepseek-ai/dsh-client-ui-conversation）。 - 用量統計依賴多幀 zstd 解壓（Node 20+ 的
zlib.zstdDecompressSync）；更舊 Node 可能只讀到第一幀，面板顯示爲 0。package.json中engines.node爲>=20。
典型用法¶
- 完成安裝並重啓 DSH，進入已有會話（dock 不在新建會話歡迎頁渲染）。
- 在輸入框右下角點擊錢包與餘額藥丸，打開統計面板。
- 在「今日 / 本週 / 本月」間切換，查看對應總量與面積圖、柱狀圖。
- 需要最新數據時點刷新；要調整圖表樣式或隱藏字段時打開齒輪，改完後關閉面板即可，下次仍從統計界面進入。
無額外配置文件；偏好存在瀏覽器 localStorage。
適用場景與注意¶
適合誰：經常在 DSH web 客戶端裏對話、希望在同界面掌握 DeepSeek 餘額與本機會話 token 分佈的開發者；需要對比 DeepSeek 與本地 / 第三方模型用量佔比時也有柱狀圖可用。
運行與信任邊界：插件以當前 DSH 進程權限運行，並會讀取本機會話日誌與憑據服務中的 DeepSeek key（僅用於餘額請求）。安裝前建議在 GitHub 倉庫 閱讀源碼與 MIT 許可證，確認符合你的安全策略。
已知邊界（README 原文）：
- 新建會話歡迎頁無狀態欄藥丸。
- 用量不含 DSH 外的同 key 消費。
- 廠商分組依賴前綴啓發式，未知 provider 落在「其他」。
社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」，本插件是社區貢獻之一。
結尾¶
dsh-tok-qty 把 DeepSeek 餘額和基於本地日誌的 token 統計收進 composer 狀態欄，今日 / 本週 / 本月切換、分時段圖與按廠商柱狀圖都在同一面板完成，數據本地計算、不上傳。若你使用 DSH web 客戶端並希望少切窗口看用量，可按上文命令安裝並重啓驗證。
- 目錄頁：https://www.skillhub.cn/plugins/loiter1EM/dsh-tok-qty
- 源碼與說明：https://github.com/loiter1EM/dsh-tok-qty
