前言¶
用 DeepSeek Harness（DSH）做日常開發時，ChatGPT、Gemini、Grok（Cursor）和 DeepSeek 往往分散在不同頁面或客戶端裏查額度。插件 dsh-quota-card（維護者 bangyu888-cmd）把四家服務的剩餘額度、重置倒計時和 DeepSeek 賬戶餘額收攏到側欄底部、登錄名上方的一張卡片裏，按需刷新，並在本地做閾值告警着色。
這是什麼¶
dsh-quota-card 是面向 DSH Web 側欄的額度展示插件（npm 包名 dsh-quota-card，當前版本 0.3.0，MIT 許可證）。它在瀏覽器裏渲染 UI，由各 Provider 對應的取數邏輯在 Host 進程執行；敏感憑據不進入瀏覽器。社區目錄頁：SkillHub · dsh-quota-card；源碼與說明：GitHub · bangyu888-cmd/dsh-quota-card。
展示的四個服務¶
下面表格概括卡片上的內容與數據來源（與 README 一致）。
| Provider | 展示內容 | 數據來源 | 需要的一次性準備 |
|---|---|---|---|
| ChatGPT | 每週剩餘 % + 重置倒計時 | chatgpt.com/backend-api/wham/usage |
運行過 codex login，存在 ~/.codex/auth.json |
| Gemini | 每週 / 5 小時剩餘 % + 重置倒計時 | Google Cloud Code retrieveUserQuotaSummary |
Antigravity 令牌：~/.gemini/antigravity-cli/antigravity-oauth-token |
| Grok Bot | 每週剩餘 % + 重置倒計時 | Cursor GetSandUsageStatus |
用戶級 Cursor API Key：CURSOR_API_KEY（~/.dsh/.env 或環境變量） |
| DeepSeek | 賬戶餘額（¥） | DSH 已登錄賬號 deepseekAccount.getBalance() |
在 DSH 內登錄 DeepSeek 賬號 |
懸停某一行可查看該服務的全部時間窗口（例如 Gemini 的每週與 5 小時）。未知或失敗時顯示「—」，不僞造爲 0。
交互與設置¶
- 自動刷新：默認每 60 秒拉取一次；頁面隱藏時暫停。右上角 ↻ 可立即刷新。
- 倒計時：每秒本地走表，依據各服務真實的重置時間。
- 顏色告警：剩餘 ≤ 30% 變黃、≤ 10% 變紅（可在設置中調整）；DeepSeek 餘額默認 ≤ ¥10 變黃、≤ ¥3 變紅。
- 齒輪設置（彈層，改完即生效）：
- 按 Provider 開關顯示（關閉後不再發請求）；
- 刷新間隔：30 / 60 / 120 / 300 秒；
- 百分比與餘額告警閾值；
- HTTP 代理：全局默認值，並可按 Provider 覆蓋；留空表示直連，例如http://127.0.0.1:7890；
- 恢復默認。
設置保存在瀏覽器 localStorage 鍵 dsh-quota-card:settings，不上傳服務端；代理 URL 僅隨本機取數請求發給 Host。
安全與隱私¶
- API Key、OAuth 令牌只在 Host 進程讀取和使用，不進入瀏覽器。
- ChatGPT / Antigravity 令牌只讀，不寫回登錄文件；Grok Bot 用 Cursor Key 換取短期訪問令牌。
- 請求統一 15 秒超時，錯誤信息脫敏。
插件以當前 DSH 進程權限訪問本機文件與環境變量；安裝前應自行查看源碼與 MIT 許可證，確認是否符合你的安全策略。
安裝與啓用¶
需要 DSH 0.2.2 及以上，且低於 0.3.0（package.json 中 engines.dsh 爲 >=0.2.2-0 <0.3.0-0）；Node ≥ 20。
推薦從 npm 安裝到指定 profile：
dsh plugin --profile <profile> add dsh-quota-card
若在本地開發本倉庫，可用絕對路徑安裝：
dsh plugin --profile <profile> add /absolute/path/to/dsh-quota-card
也可以在 DSH 內打開「插件 → 發現」，搜索 dsh-quota-card 一鍵安裝。
安裝後刷新頁面；若插件更新了 Host 側代碼，需重啓一次 DSH。
典型用法與前置準備¶
按你實際使用的 Provider 完成下表對應項，卡片纔會顯示有效數字。
| Provider | 一次性準備 |
|---|---|
| ChatGPT | codex login，確認 ~/.codex/auth.json 存在 |
| Gemini | 準備好 ~/.gemini/antigravity-cli/antigravity-oauth-token；若令牌在系統鑰匙串中，可先導出一次：security find-generic-password -s gemini -a antigravity-acp -w > ~/.gemini/antigravity-cli/antigravity-oauth-token |
| Grok Bot | 在 ~/.dsh/.env 或環境中設置 用戶 Cursor API Key（CURSOR_API_KEY，不能是 admin:* 類 team key） |
| DeepSeek | 在 DSH 內完成 DeepSeek 賬號登錄 |
日常使用時打開側欄即可掃一眼額度；閾值變色後可在齒輪裏調高刷新頻率或單獨配置代理（例如僅 ChatGPT 走本機代理）。
已知限制與適用場景¶
- ChatGPT、Grok Bot、Gemini 依賴非公開接口，上游字段或鑑權變更時可能失效；卡片會顯示可讀錯誤，不會編造額度。
- 展示的餘額與額度僅供參考，不是計費依據。
適合同時在 DSH 裏編排多模型、又需要一眼確認「這週還剩多少」的開發者。若你只做單一平臺、或不願在本機存放 OAuth / API Key，可只開啓 DeepSeek 餘額一欄，或暫不安裝。
社區插件目錄 SkillHub 爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；DSH 本身也遵循「一切皆插件」的擴展方式。
結尾¶
dsh-quota-card 把四家服務的額度、倒計時與 DeepSeek 餘額固定在側欄，Host 側讀憑據、瀏覽器側只做展示與 localStorage 設置，並支持按 Provider 代理與閾值告警。安裝命令以 README 爲準：dsh plugin --profile <profile> add dsh-quota-card。
- 目錄頁：https://www.skillhub.cn/plugins/bangyu888-cmd/dsh-quota-card
- GitHub：https://github.com/bangyu888-cmd/dsh-quota-card
