前言¶

DeepSeek Harness (DSH) 爲智能體開發提供了 Web 界面。在使用過程中，開發者通常需要同時監控 DeepSeek API 餘額、Kimi For Coding 的套餐餘量（含周限與 5 小時窗口）以及 ChatGPT (Codex) 的訂閱限流情況。dsh-quota-status 插件在一個極簡的卡片中聚合了這些信息，提供餘額狀態、進度條、重置倒計時以及波峯波谷電價提醒，解決了多窗口查看分散的問題。

插件簡介¶

名稱：dsh-quota-status
維護者：ruby1304
類別：聯網工具
許可證：MIT

這是一個 DeepSeek Harness (DSH) web 插件。它在一個極簡卡片裏實時顯示 DeepSeek API 餘額、Kimi For Coding 套餐餘量（周限 + 5h 滾動窗口）與 ChatGPT (Codex) 訂閱限流窗口。卡片包含剩餘量數值、進度條、重置倒計時，並針對 DeepSeek 的波峯波谷時段提供價格提醒。

核心功能¶

插件具備以下功能：

• 開箱即用：默認讀取環境變量 DEEPSEEK_API_KEY 與 KIMI_CODING_API_KEY。憑證通過 dsh credentials seam 傳遞，密鑰永不進入瀏覽器。
• 極簡卡片：固定寬度 260px。每個賬戶一行（狀態點 + 名稱 + 數值），展開詳情時寬度保持不變。卡片支持 hover 抬升陰影效果。
• 餘額分檔着色：根據 DeepSeek 餘額數值自動着色。綠 ≥100，黃 20–99，紅 1–19，灰 <1。
• 波峯波谷提醒：行內嵌入時段徽標（如高峯期）。展開詳情會顯示當前時段與距離切換的倒計時，每秒跟隨系統時鐘刷新。
• 點擊交互：點擊某一行原地展開該賬戶詳情（DeepSeek 充值/贈送拆分；Kimi 各窗口進度條、剩餘量與重置倒計時）。再點收起。
• 倒計時顯示：當 Kimi 或 ChatGPT 窗口耗盡（0%）且服務端提供重置時間時，收起態直接追加實時倒計時；未耗盡窗口保持百分比格式。
• 可拖動：按住卡片空白處可拖動到任意位置，位置記憶在瀏覽器本地。
• 自動刷新：默認 60 秒刷新一次。頁面隱藏時暫停，回到前臺立即刷新。
• 中英雙語：跟隨界面語言，自動適配深淺主題。
• 僅迴環 RPC：RPC channel 僅迴環可訪問（authority: loopback），確保數據安全。
• 插件配置卡片：在 DSH 的「設置 → 插件 → 插件配置」中可直接查看三類賬戶狀態，並在此處處理 ChatGPT 的 OAuth 登錄。

安裝與啓用¶

安裝插件需要使用 DeepSeek Harness 的 CLI。

dsh plugin --profile web add dsh-quota-status
dsh web

安裝後，dsh-quota-status 會作爲 bundle 自動通過 cordis.patch.yml 插入 quota-status 行。

典型用法¶

默認安裝後無需配置即可使用。如需調整刷新頻率、顏色閾值或添加 ChatGPT 監控，需在 ~/.dsh/profiles/web/cordis.patch.yml 中覆蓋配置。

配置示例¶

在配置文件中按行覆蓋 quota-status 節點：

- id: quota-status
  config:
    refreshMs: 30000          # 默認 60000，刷新間隔毫秒
    timeoutMs: 15000          # 上游查詢超時
    warnBalance: 30           # DeepSeek 餘額低於 30 變黃
    criticalBalance: 10       # 低於 10 變紅
    warnUsagePercent: 40      # Kimi 餘量低於 40% 變黃
    criticalUsagePercent: 15  # 低於 15% 變紅
    codexBinary: cliproxyapi  # 設置頁「登錄 ChatGPT」調用的程序
    codexConfigPath: ~/.cli-proxy-api/config.yaml
    providers:
      - id: deepseek
        label: DeepSeek
        kind: deepseek-balance
        credential: DEEPSEEK_API_KEY
        endpoint: https://api.deepseek.com/user/balance
      - id: kimi-coding
        label: Kimi Coding
        kind: kimi-usage
        credential: KIMI_CODING_API_KEY
        endpoint: https://api.kimi.com/coding/v1/usages
      # ChatGPT 訂閱（可選，需本地 CLIProxyAPI 網關已登錄 codex）：
      - id: codex-sub
        label: ChatGPT
        kind: codex-usage
        credential: ''        # codex-usage 無需 env 憑證
        endpoint: https://chatgpt.com/backend-api/wham/usage
        authDir: ~/.cli-proxy-api   # codex-*.json 所在目錄

數據源說明¶

• DeepSeek：GET https://api.deepseek.com/user/balance（可用餘額，無重置時間）。
• Kimi For Coding：GET https://api.kimi.com/coding/v1/usages（套餐周限 + 各窗口明細）。
• ChatGPT (Codex)：GET https://chatgpt.com/backend-api/wham/usage（訂閱限流窗口，憑證來自 CLIProxyAPI 本地 auth 文件）。

適用場景與注意¶

該插件適合需要頻繁監控 API 餘額和訂閱限流的開發者。在安裝前，請確保已正確配置 DeepSeek Harness 的 profile。

安全機制：
* API Key 只在宿主進程解析，不寫入響應、日誌或瀏覽器。
* Codex 訂閱的 OAuth token 只在宿主進程從 CLIProxyAPI 本地 auth 文件讀取。
* RPC channel 僅迴環可訪問。

開發與維護：
如需參與開發，可運行以下命令：

npm install
npm run typecheck
npm test
npm run build

結語¶

dsh-quota-status 通過極簡的卡片視圖和自動刷新機制，將 DeepSeek、Kimi 和 ChatGPT 的關鍵配額信息集中展示。它遵循 DeepSeek Harness 的“一切皆插件”理念，利用迴環 RPC 確保了密鑰安全，適合作爲開發環境的標配組件。

GitHub 倉庫