前言¶
在 DeepSeek Harness 裏切換多個 AI 提供商時，額度往往分散在各家控制台、CLI 或本地憑據裏，很難在寫 Harness 的同一屏裏一眼看完還剩多少。手動打開網頁查配額，或分別跑 mmx quota show 之類命令，會打斷開發節奏。dsh-quota-hub（額度中心）把多家提供商的 5 小時窗口、每週額度、餘額等彙總到 DSH 側邊欄，用半圓形彩虹拱做總覽，並可選配套 macOS 菜單欄應用 QuotaBar。下面介紹它是什麼、能讀哪些數據、如何安裝與日常使用。
這是什麼¶
dsh-quota-hub 是 Wldeinsamkeit 維護的 DeepSeek Harness 可視化插件：在側邊欄實時展示 AI 提供商額度，核心 UI 是「每道弧代表一家 AI、按剩餘額度填充」的半圓彩虹；全滿即表示各家額度都較充足。社區目錄 skillhub.cn 將其歸類爲趣味換裝類插件；源碼與說明見 GitHub 倉庫，許可證爲 MIT。插件以 DSH 的 Web 客戶端形式注入側邊欄佈局（package.json 中聲明依賴 dsh 引擎 >=0.1.7）。
核心功能¶
側邊欄總覽與交互¶
半圓彩虹拱上，每條弧對應一個已配置的提供商，填充比例反映當前所選維度下的剩餘額度。點擊可在 5 小時額度 與 每週額度 之間切換，切換與打開時帶有加滿動畫。鼠標懸浮任意弧，可查看該家的詳細信息：雙窗口剩餘、用量、重置時間等。
展開詳情後，每個提供商一張卡片；每條額度類型（5 小時、每週、餘額、日請求等）單獨一條分檔色進度條：剩餘 90% 以上爲綠，70–90 爲黃，30–70 爲藍，低於 30 爲紅。
刷新與配置¶
數據默認每 10 秒自動刷新，也支持手動觸發立即採集。README 說明爲零配置：密鑰從本機 DeepSeek Harness 憑據庫（~/.dsh/.credentials.yaml）、~/.codex/auth.json（Codex/ChatGPT）以及已登錄的 mmx（MiniMax）讀取，文檔明確寫「任何密鑰都不上傳」。
數據來源（README 表格）¶
| 提供商 | 指標 | 方式 |
|---|---|---|
| Z.ai / 智譜 Coding Plan | 5 小時 + 每週 credits | 官方配額端點（Coding Plan Key） |
| MiniMax | 5 小時 + 每週（百分比） | mmx quota show / 官方接口 |
| Codex · ChatGPT | 5 小時窗口 + 每週窗口 | 官方用量端點（OAuth） |
| DeepSeek | 預付餘額 | 官方 balance 接口 |
| Gemini · AI Pro | CLI 日請求 | 手工記錄（官方無額度 API） |
配套 macOS QuotaBar¶
倉庫內 companion-quota-bar/ 提供同一套數據的 macOS 菜單欄版（小彩虹圖標 + 半圓彩虹彈窗），與側邊欄插件共用同一份 state.json，細節見倉庫內 companion-quota-bar/README.md。
安裝與啓用¶
DeepSeek Harness 生態裏插件可通過市場或命令行安裝；本插件收錄進 Plugin Market 後，可在 Plugins → Plugin Market 搜索 quota 一鍵安裝。當前 README 給出的命令行方式爲：
dsh plugin --profile <profile> add https://github.com/Wldeinsamkeit/dsh-quota-hub
將 <profile> 換成你實際使用的 DSH profile 名。README 還提到手動方式：在 Harness 插件管理裏用 install_bundle 指向插件目錄（需自行取得倉庫內容，本文不展開 clone 步驟）。
安裝完成後，插件按 package.json 配置在 Web 客戶端立即注入側邊欄相關模塊，無需在插件內再填一份密鑰列表。
典型用法¶
- 在 DSH 中裝好插件並保證本機已有對應提供商憑據（Harness 憑據庫、Codex OAuth、
mmx登錄等）。 - 打開 Harness 側邊欄中的額度中心視圖，默認看到半圓彩虹總覽；需要看周額度時點擊切換 5 小時 / 每週。
- 懸浮某條弧覈對重置時間與用量；需要分項進度條時展開詳情卡片。
- 若 10 秒刷新不夠及時，使用界面上的手動立即採集（具體入口以插件 UI 爲準）。
- 若在 macOS 上使用 QuotaBar，按
companion-quota-bar/README.md配置，使菜單欄與 DSH 側欄讀取同一份state.json。
適用場景與注意¶
適合經常在 DSH 裏混用智譜 Coding Plan、MiniMax、Codex/ChatGPT、DeepSeek 等、又希望在本機一眼看清額度窗口的開發者。Gemini · AI Pro 的日請求爲手工記錄，不能指望與其它家一樣的自動 API 配額。
插件隨當前 DSH 進程運行，讀取本機憑據與調用官方端點；安裝前應自行瀏覽 GitHub 源碼 與 MIT 許可證，確認行爲符合你的安全策略。社區目錄站點與 DeepSeek / 幻方無官方從屬關係，不等同於官方應用商店。
結尾¶
dsh-quota-hub 把多提供商額度收進 DSH 側邊欄的半圓彩虹與分檔進度條，並支持 5 小時 / 每週切換與本地零配置憑據讀取；需要菜單欄常駐時可選用同倉庫的 QuotaBar。進一步瞭解可訪問 目錄頁 與 GitHub：Wldeinsamkeit/dsh-quota-hub。
