前言¶
在 DeepSeek Harness（DSH）裏跑智能體時，Codex 訂閱、Gemini 賬號池和平臺錢包往往是三套獨立入口：額度分散在別的插件設置頁裏，錢包又要另開界面查。長時間會話裏，你很難在不動鼠標的情況下判斷「這週還剩多少」「五小時窗口何時重置」「平臺餘額夠不夠」。dsh-quota-bar 是 GuoruiC 維護的客戶端插件，把這三類只讀指標收成窗口底部一條狀態欄；每個來源可單獨關閉，關掉後不再發起任何請求，適合只想盯其中一兩格的人。
這是什麼¶
插件全名 dsh-quota-bar（倉庫 GuoruiC/dsh-quota-bar），當前版本 0.3.0，許可證 MIT。分類爲 DSH 社區目錄裏的客戶端插件；GitHub 星標數爲 2（以倉庫頁面爲準）。
它不查上游、不持有賬號，只是已有數據來源的「儀表」：
| 格子 | 數據真正來自 | 你需要先做的 |
|---|---|---|
| Codex | dsh-codex-subscription 裏已登錄的 ChatGPT / Codex 賬號 |
在該插件裏完成 Codex 訂閱登錄 |
| Gemini | dsh-gemini-pool 賬號池裏已登錄的 Google 賬號 |
在該插件裏登錄 Google 賬號 |
| DeepSeek | DSH 平臺賬號充值錢包（充值 + 贈金） | 在 DSH 裏登錄平臺賬號 |
未安裝、未登錄或 token 過期時，對應格子顯示「未登錄 / 不可用」，屬於如實反映而非本插件故障。
核心功能¶
底部狀態條大致形態如下（示意，具體數值隨賬號變化）：
● Codex 周 54% · 5h 97% · 4 小時 33 分後重置 │ ● Gemini 周 100% · 5h 100% · 4 小時 35 分後重置 │ ● DeepSeek ¥106.04 更新於 18:49 ⟳ ⚙
額度與顏色
- Codex / Gemini：各顯示「周」與「5 小時」兩個窗口的剩餘百分比；重置倒計時取該來源最近的一個窗口。
- 顏色取兩窗口裏最低百分比：≥50% 綠、20–50% 琥珀、<20% 紅。
- DeepSeek：平臺錢包合計；有贈金時會標出「贈金 ¥x」。餘額顏色：≤0 紅、<¥20 琥珀、其餘綠。
交互
- 懸停可看完整明細（各窗口剩餘與重置時刻；錢包拆分充值 + 贈金）。
- 右側
⟳強制刷新已開啓的來源；平時 Codex / Gemini 每 60 秒、DeepSeek 每 10 分鐘自動刷新。
可選來源
- 狀態條
⚙或 設置 → 額度條 可開關各來源；關閉後既不顯示也不請求（Codex 不調 RPC、Gemini 不fetch、DeepSeek 不調賬號服務）。 - 開關保存在瀏覽器
localStorage（鍵名dsh.quota-bar.sources.v1）。 - 首次運行會探測一次，對返回「未登錄」的來源自動關掉，避免每 60 秒打失敗接口；之後不再自動改動。
- 三個全關時保留一行「額度來源已全部關閉」和
⚙。
隱私與權限（README 原文）
- 只讀：不寫數據、不改配置、不代替其他插件操作。
- 僅請求本機 DSH 的
/api/codex-subscription/usage、/antigravity/api/status，以及經宿主訪問的remote.account.getBalance；無第三方上報與遙測。 - 實現位於明文
lib/client.js，無混淆。
安裝與啓用¶
命令行安裝（須與 README 一致）：
dsh plugin add github:GuoruiC/dsh-quota-bar
裝完後重啓 DSH（bundle 在宿主啓動時裝配），界面底部應出現狀態條。
也可在 DSH 內 插件 → 發現 搜索 quota 或 dsh-quota-bar 從市場安裝。
環境要求：需要帶 shell.bottom 槽位與客戶端插件能力的 DSH；作者在 2026-11 的 DSH Desktop 構建上開發與驗證。被觀測的 Codex / Gemini 插件均爲可選依賴。
典型用法¶
- 按上節安裝並重啓 DSH。
- 在
dsh-codex-subscription、dsh-gemini-pool與 DSH 平臺賬號中完成你實際要用的登錄；不需要的來源可在額度條⚙裏直接關掉。 - 日常盯盤看底部條即可；需要即時數據時點
⟳。Codex 的 usage 有內部緩存，手動刷新纔會強制拉取。 - 換機器或清空瀏覽器緩存後，來源開關回到默認（三源全開 + 重新探測），需按需再關。
適用場景與注意¶
適合誰
- 經常在 DSH 裏切換模型、又不想反覆打開訂閱/池子設置頁查額度與餘額的開發者。
- 只用 DeepSeek 錢包、不用 Codex/Gemini 的人：關掉對應格即可零多餘請求。
安裝前建議
- 插件在 DSH 客戶端進程內以 Web 側腳本運行，會按已開啓來源訪問本機 DSH API 與賬號服務；安裝前可閱讀倉庫
lib/client.js與 MIT 許可證。 shell.bottom爲 root 級單佔位槽位；若其他插件也佔用底部槽位可能衝突。- 社區目錄 skillhub.cn 插件頁 與 GitHub 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係；星標、版本以倉庫爲準。
結尾¶
dsh-quota-bar 把 Codex、Gemini 額度與 DeepSeek 錢包收成一條只讀底欄，來源可選、關閉即停請求，適合作爲 DSH「一切皆插件」生態裏的輕量觀測組件。進一步瞭解可看 目錄頁 與 GitHub 倉庫。
