前言¶
在 DeepSeek Harness（DSH）裏切換智譜、OpenCode Go、Kimi、小米套餐或 DeepSeek 官方模型時，各家額度窗口、餘額和 Token 消耗口徑並不統一，往往要分別打開控制台或查接口才能對齊「還剩多少、何時重置」。dsh-quota 是社區維護的聯網工具類插件，把上述信息聚合到輸入框狀態欄徽標和明細麪板裏，數據在本地聚合，憑據按 DSH 憑據服務或環境變量引用，不額外外發。
這是什麼¶
dsh-quota（GitHub：shy3130/dsh-quota，npm：@wshylabs/dsh-quota）由維護者 shy3130 發佈，定位爲 DeepSeek Harness 輸入框狀態欄 · 多廠商額度與消耗監控插件。覆蓋智譜 GLM、OpenCode Go、Kimi For Coding、小米 Token 套餐、DeepSeek 官方（餘額 + 今日消耗估算），並附帶今日 / 7 天 / 30 天 Token 用量統計。插件爲標準 DSH bundle，不修改官方源碼；所有宿主路由帶 DSH 登錄門。許可證 MIT；當前 package 版本爲 1.4.1（以倉庫 package.json 爲準）。README 標明在 DeepSeek Harness 0.2.1-rc.3 桌面 RC 上開發與實測，≥ 0.2 理論兼容。
核心功能¶
狀態欄徽標與自動跟隨¶
宿主讀取 DSH 默認模型與會話模型選擇（與輸入框模型芯片同源）；切換模型後約 1 秒內切換到對應廠商徽標，未覆蓋的廠商徽標隱藏且不佔位。客戶端約每秒查詢一次 GET /quota/active，額度數據每 60 秒刷新；窗口獲焦、會話切換、模型保存時會立即查詢。
徽標文案示例（README 原文示意）：
GLM 5h 21% ▰ · 周 6% ▰
OpenCode 5h 8% ▰ · 周 3% ▰ · 月 1% ▰
Kimi 5h 24% ▰ · 周 42% ▰
小米 套餐 12% ▰ · 月 17% ▰
DeepSeek 餘額 ¥85.31 · 今日 ¥1.26
五家額度來源¶
| 廠商 | 面板側重 |
|---|---|
| 智譜 GLM | 5 小時窗口 · 本週 · 本月工具額度（含分項） |
| OpenCode Go | 5 小時滾動窗 · 本週 · 本月 |
| Kimi For Coding | 5 小時窗口 · 本週彙總 |
| 小米 Token 套餐 | 套餐額度 · 補償額度 · 本月總量 |
| DeepSeek 官方 | 賬戶餘額（充值 / 贈送）+ 今日消耗 |
點開徽標可打開明細麪板：剩餘 / 已用 / 重置倒計時（如 6d 21h）、工具額度分項；底部柱狀 / 環狀指示器可切換，選擇記在瀏覽器 localStorage（鍵 dsh-quota:indicator）。
Token 用量與 DeepSeek 費用估算¶
面板內可切換今日 / 7 天 / 30 天：總量、輸入 / 輸出、緩存命中率、請求數與每日柱狀圖，均由本地計算。DeepSeek 側按官方價目表（區分高峯 / 空閒時段）由本地 token 記錄估算金額，不依賴官方用量接口。
客戶端與佈局¶
支持 macOS · Windows · Linux。窄屏（≤520px）下徽標緊湊、彈層橫向鋪滿並限高，觸屏點外部關閉。
安裝與啓用¶
環境要求：DeepSeek Harness 0.2.1-rc.3（README 實測）；Node.js 無需單獨安裝；各廠商憑據見下文配置。安裝或更新後需完全退出並重開 DSH（僅刷新頁面不夠）。
推薦從 npm 安裝：
dsh plugin --profile desktop add @wshylabs/dsh-quota
釘住版本示例：
dsh plugin --profile desktop add @wshylabs/dsh-quota@1.4.1
從 GitHub 跟蹤 main：
dsh plugin --profile desktop add github:shy3130/dsh-quota
釘住 git tag：
dsh plugin --profile desktop add github:shy3130/dsh-quota#v1.3.1
更新已安裝版本：
dsh plugin --profile desktop update @wshylabs/dsh-quota
卸載：
dsh plugin --profile desktop remove @wshylabs/dsh-quota
版本變更說明見 GitHub Releases。
配置憑據與可選項¶
憑據可放在環境變量，或通過 DSH 憑據服務按下列名稱保存（插件只持引用名）：
| 廠商 | 憑據名 | 說明摘要 |
|---|---|---|
| 智譜 GLM | ZAI_CODING_CN_API_KEY |
智譜開放平臺 API Key |
| OpenCode Go | OPENCODE_GO_API_KEY |
OpenCode Zen 後臺 API Key |
| Kimi For Coding | KIMI_API_KEY 或 DSH Kimi OAuth |
優先 llm-pi-ai/kimi-coding access token |
| 小米 Token 套餐 | XIAOMI_MIMO_SESSION_COOKIE |
瀏覽器 SSO Cookie，非 tp-... API Key |
| DeepSeek 官方 | 通常無需（DSH 已登錄）；或 DEEPSEEK_API_KEY |
賬號走 deepseekAccount，Key 走 GET /user/balance |
在 cordis.patch.yml 的插件 config 中可覆蓋各來源 baseUrl 與 credentialRef（字段名見 README「來源地址與憑據引用」）。若希望新環境默認環狀指示器：
config:
indicator: ring # bar（默認）| ring
修改經宿主路由 /quota/config 讀取的默認值後需重啓 DSH；面板內切換隻需刷新頁面。
典型用法與數據刷新¶
- 安裝插件並配置所需廠商憑據，重啓 DSH。
- 在會話中選擇已支持的模型；狀態欄右下角（移動端佈局見 README）出現對應徽標。
- 單擊徽標查看額度明細與 Token 統計；按需切換柱狀 / 環狀指示器或統計時間範圍。
工作原理摘要：/quota/active 將 provider 映射到各家 HTTP 接口（如智譜 GET .../api/monitor/usage/quota/limit、OpenCode GET .../zen/go/v1/usage 等）；未映射的 provider 不顯示徽標。
適用場景與注意¶
適合長期在 DSH 桌面端混用多家模型、希望在輸入框旁持續看到額度與本地 Token 統計的開發者。插件以當前 DSH 進程權限運行，會代表你調用各廠商用量接口；安裝前應閱讀倉庫源碼與 MIT 許可證，並自行保管 API Key / Cookie。DSH 處於 RC/預覽階段時，升級客戶端後若徽標或面板異常，可在 GitHub Issues 附上 dsh --version 反饋。社區插件目錄（如 skillhub.cn）與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。
結尾¶
dsh-quota 把 GLM、OpenCode Go、Kimi、小米套餐與 DeepSeek 官方的額度與消耗信息收攏到 DSH 狀態欄，減少在多控制台之間切換的成本。目錄與倉庫：
- 插件目錄頁：https://www.skillhub.cn/plugins/shy3130/dsh-quota
- GitHub：https://github.com/shy3130/dsh-quota
