前言¶
用 DeepSeek Harness 切換多家模型提供商時，額度窗口、重置時間和賬戶餘額往往分散在各家的控制台或 CLI 裏。對話進行到一半，爲了確認「這週還剩多少」「餘額夠不夠續跑」，需要反覆切應用，打斷上下文。DSH 社區裏有不少按廠商拆分的客戶端能力；若希望在一個界面裏統一查看多家入口的用量，並在輸入區旁得到簡要提醒，可以安裝維護者 KouzakiUmi 發佈的客戶端插件 dsh-subusage（npm 包名 dsh-subusage，GitHub：KouzakiUmi/dsh-subusage）。下面介紹它的定位、能力與使用步驟。
這是什麼¶
dsh-subusage 是 DeepSeek Harness 的訂閱用量顯示插件，分類爲客戶端。它不註冊模型路由，只讀取各提供商的額度或餘額接口並在 UI 展示；查詢失敗時會說明原因，不把未知狀態當成「充足」。
當前 npm 版本爲 0.14.3（以倉庫 package.json 爲準），許可證 MIT，要求 Node.js >= 22.19.0，與 DSH Core 0.2.x 兼容（peer 依賴 @deepseek-ai/dsh 等 0.2 系列）。
核心功能¶
餘量藥丸與彈層明細¶
在模型選擇器旁的輸入區會出現用量藥丸。正常時保持簡潔；當週窗偏少、額度耗盡或讀取失敗時，藥丸會給出明確提示。點開後可查看百分比、適用範圍與重置倒計時等明細。
額度窗口與餘額分開展示¶
有訂閱窗口時，一個窗口對應一根餘量條，優先展示最緊張的窗口。無套餐窗口且數據完整時，藥丸可直接顯示金額；人民幣、美元與 credits 按各自規則展示。文檔強調：餘額不等於訂閱額度，也不能蓋過已耗盡的套餐。DeepSeek 提供 deepseek（獨立 API Key） 與 deepseek-account（本機 DSH 登錄態） 兩個入口，憑據與餘額互不替代、不相加。
統一設置頁¶
路徑爲 設置 → 訂閱用量 → 提供商管理。可填寫 API Key，或複用對應提供方插件的登錄態；MiMo 支持「登錄並自動導入」。Codex（openai-codex）默認關閉，避免與提供方自帶藥丸重複，需要統一展示時可手動開啓。
只讀 Agent 工具¶
模型可調用只讀工具 subusage_quota，讀取與界面同源的額度與餘額，可按提供商篩選；Command Code 可分別返回各賬戶狀態。該工具不會修改設置。典型用法例如在對話中說：「看一下 Kimi 和 Codex 還剩多少額度。」
支持的數據入口¶
共 29 條 provider id；新安裝默認開啓 11 條、默認關閉 18 條（清單以倉庫 lib/index.js 的 PROVIDERS 爲準）。按場景大致包括：
| 你想看什麼 | 代表提供商 |
|---|---|
| 訂閱窗口與重置時間 | Kimi、MiMo、Codex、SuperGrok、MiniMax、Z.ai、OpenCode Go、OpenDesign |
| 賬號錢包與 API 餘額 | DeepSeek API / 賬號、SiliconFlow、Novita、Hyperbolic、DeepInfra |
| 套餐、餘額與多層預算 | Command Code、NanoGPT、OpenRouter、ZenMux、LiteLLM |
| 賬號級套餐與企業席位 | 火山方舟 Agent Plan / Coding Plan（arkcli） |
各家的窗口語義、字段與單位換算見倉庫 docs/providers.md。私有額度接口可能變化，界面數字僅供參考，不是計費依據。
文檔記錄的真實賬號實測覆蓋包括：火山方舟 Agent / Coding Plan（個人版）、Kimi Coding、小米 MiMo、Command Code、SuperGrok、Codex 等；其餘入口較多依賴樁測試，使用前宜閱讀 README 中的「實測覆蓋」與憑據指引 docs/credentials.md。
安裝與啓用¶
安裝命令（來自 README「快速開始」）：
dsh plugin --profile web add dsh-subusage
其中 web 僅爲示例 Profile，請替換爲實際目標。若在 DSH Desktop 環境使用，應通過桌面殼提供的 DSH Desktop CLI 管理插件，不要用獨立公共 CLI 去操作保留的 desktop Profile。
經過上面的步驟後：
- 啓用插件：按你的部署方式重載，使 Host 與 Client 一併生效；只刷新頁面不保證 Host 已升級。
- 配置提供商：在 設置 → 訂閱用量 → 提供商管理 中啓用並填寫所需憑據。
- 回到對話：選擇對應提供商的模型，確認輸入區出現用量藥丸。
已登錄 DSH DeepSeek 賬號時，默認開啓的「DeepSeek 賬號」入口可直接讀宿主餘額，無需複製 token。
使用前須知¶
- 不猜數據：查詢失敗、緩存與部分覆蓋會明確標註；接口讀取成功也不保證仍可續用。
- 憑據安全：API Key、Cookie 與 OAuth token 不會回填到界面；但手動配置仍可能明文落盤，本插件不是加密憑據庫。
- 插件權限：插件以當前 DSH 進程權限運行，安裝前建議在 GitHub 查看源碼與 MIT 許可證，自行評估是否滿足環境要求。
Command Code 在自動輪換模式下，藥丸展示的用量仍對應默認賬戶，不跟隨實際服務中輪換到的賬戶；需在彈層或設置頁查看各賬戶詳情。
結尾¶
dsh-subusage 把多家提供商的額度、餘額與重置信息收斂到 DSH 對話界面與統一設置頁，並暴露只讀 subusage_quota 供 Agent 查詢，適合經常混用多家模型、又不想頻繁離開對話查控制台的用戶。
