前言¶
在 DeepSeek Harness（DSH）裏同時接入多家模型服務商時，賬戶餘額、訂閱套餐窗口、重置時間這些信息通常散落在各家控制台和頁面裏，要來回切換才能確認還剩多少可用額度。dsh-model-quota 是一個客戶端分類的 DSH 插件，把這些信息集中到一個設置頁面裏查看，由 zhangmin510 維護。下面介紹它的功能範圍、安裝方式、授權流程和使用時需要注意的邊界。
這是什麼¶
dsh-model-quota 在 Harness 的 設置 → 模型餘量 頁面集中顯示當前已配置服務商的餘額、套餐窗口剩餘百分比和重置時間，支持中文／英文與宿主淺色／深色主題。界面展示的額度是直接向服務商接口查詢的結果；插件按需刷新，不輪詢、不發送推理請求、不修改模型配置。
運行時要求 Node.js 22 或以上，無 npm 運行依賴、無安裝腳本、無構建步驟，原生 ESM 直接運行。實際驗證環境爲 Desktop 0.2.1-rc.5。項目許可爲 MIT，星標數爲 0，屬於社區維護的插件，不是 DeepSeek / 幻方的官方組件。
支持的服務範圍¶
插件目前覆蓋以下服務商的額度查詢：
| 服務商 | 顯示內容 | 認證來源 |
|---|---|---|
| DeepSeek API | 賬戶餘額 | Harness 當前配置的 API Key |
| DeepSeek 已登錄賬戶 | 充值／贈送餘額 | Harness 賬戶服務 |
| 千問／阿里雲 Token Plan（個人／Solo） | 服務端返回的小時／日／周／月窗口 | 百鍊 CLI 的獨立控制台登錄 |
| 智譜／Z.AI Coding Plan | 5 小時、周、工具月額度及重置時間 | Harness 當前配置的 API Key |
| OpenRouter | Key 消費上限剩餘金額、已用金額 | Harness 當前配置的 API Key |
| SiliconFlow | 賬戶餘額 | Harness 當前配置的 API Key |
| OpenAI Codex 舊版訂閱路由 | 套餐窗口剩餘百分比 | 尚未過期的 Codex OAuth 登錄 |
識別口徑上有幾個要點：
- 只識別相應官方 HTTPS 域名；自定義代理和沒有接入餘量接口的服務商明確顯示「暫不支持」。
- OpenAI 普通 API／新版直連 OAuth 不會被當作舊版 Codex 查詢。
- 服務商接口變化時顯示失敗，插件不使用本地 Token 用量推算餘額。
- 額度由賬戶、Key 或套餐共享，不是每個模型獨立擁有；不同幣種不累加，同一賬戶經不同認證路由返回的餘額也不累加。
- OpenRouter 未設置 Key 消費上限不代表賬戶有無限餘額。
安裝與啓用¶
安裝命令來自 README，可讓 Harness Agent 執行：
安裝插件：github:zhangmin510/dsh-model-quota#v1.2.1
對應的 plugin_manager 操作是 install_bundle，target 爲上述 GitHub 安裝標識。安裝影響當前 profile 的全部會話並持久保留；升級後若提示需要重啓，應重啓 Harness。也可以克隆倉庫後以目錄絕對路徑安裝；本地目錄安裝鏈接源碼目錄，需要保留該目錄。
典型用法¶
啓用後打開 設置 → 模型餘量 即可查看已配置服務商的額度，頁面上按需點擊刷新。其中千問 Token Plan 的授權與推理 Key 是兩套機制，模型調用的 API Key 不能代替控制台授權。插件複用百鍊 CLI，不讀取瀏覽器 Cookie、不自動打開登錄頁、也不直接讀取 CLI 憑據文件。按下面三步配置：
1、安裝百鍊 CLI：
npm install -g bailian-cli
本插件驗證版本爲 2.8.2，該版本的 usage token-plan --output json 會返回個人套餐的滾動窗口。
2、使用與模型 Key 相同的阿里雲賬戶，在瀏覽器完成獨立配置的登錄：
bl auth login --console --config model-quota-console --console-site domestic
這裏使用獨立配置 model-quota-console，因爲控制台登錄可能創建普通百鍊 API Key，需要避免覆蓋已有的 Token Plan 模型配置。國際站使用對應國際控制台登錄；查詢區域取自已配置的 Token Plan 端點。
3、在插件頁面點擊「刷新余量」。只返回月度窗口的套餐僅顯示月度額度；缺失窗口不補零、不推定無限；無消費數據或無窗口時顯示「未返回額度」。企業／Team 彙總積分池不在此適配器支持範圍內。
頁面會顯示來源提醒：套餐額度來自該 CLI 配置所登錄的控制台賬戶，無法僅憑推理 Key 自動覈驗是否同一個賬戶。若提示找不到 CLI，給 tokenPlan.cliPath 設置可執行文件絕對路徑；登錄過期時按頁面顯示的命令重新授權即可，插件不會自動刷新登錄或切換 CLI 活動配置。
插件通過 Bundle patch（cordis.patch.yml）提供默認值，全部字段在插件加載時驗證，修改配置應通過 Loader 的正常配置流程，不直接手工寫 profile 文件。主要配置項如下：
| 字段 | 默認值 | 限制／用途 |
|---|---|---|
requestTimeoutMs |
12000 |
額度 HTTP 請求超時，100–120000 毫秒 |
concurrency |
4 |
同時查詢的服務商數，1–8 |
tokenPlan.cliPath |
bl |
百鍊 CLI 可執行文件路徑 |
tokenPlan.profile |
model-quota-console |
已授權的 CLI 配置名稱 |
tokenPlan.timeoutMs |
20000 |
CLI 查詢超時，100–120000 毫秒 |
tokenPlan.maxOutputBytes |
262144 |
每個 CLI 輸出流的內存上限，1024–1048576 字節；不寫磁盤 |
tokenPlan.graceMs |
1000 |
託管進程樹終止寬限期，0–10000 毫秒 |
安全與生命週期¶
插件裏有一個與頁面共用查詢實現的只讀 Agent 工具 model_quota；工具結果由 Harness 記錄到會話，頁面查詢不自動寫入會話。返回值包含服務商、模型、金額／百分比、時間、CLI 來源配置名稱和有限錯誤代碼，不含密鑰、令牌及上游原始錯誤正文。
HTTP 入口遵循 Harness Connection 的 Host／Origin 和瀏覽器認證檢查；服務商 HTTP 請求禁止重定向。密鑰只在 Host 側通過當前 credential service 解析，Codex 憑據只讀且不刷新。CLI 通過無 shell 的固定只讀參數調用，環境不繼承模型 Key、雲憑據、Cookie 或 SSH agent；查詢超時或取消會終止並等待插件擁有的 CLI 子進程退出。卸載會中止 HTTP 查詢並等待已開始的操作結束。
適用場景與注意¶
適合在 DSH 中同時使用多個模型服務商、需要定期確認餘額和套餐窗口的開發者。幾點注意：
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證文件。
- 只做額度查詢，不負責充值、切換模型或自動降級；額度不足時仍需到對應服務商側處理。
- 服務商接口變化或鑑權失敗時顯示失敗，不會用本地統計值替代真實額度。
- 目錄頁與 GitHub 倉庫見下方鏈接，安裝前可對照 README 確認最新支持範圍。
插件目錄頁：https://www.skillhub.cn/plugins/zhangmin510/dsh-model-quota
GitHub 倉庫：https://github.com/zhangmin510/dsh-model-quota
