dsh-plugin-relay-quota：讀取任意 OpenAI 兼容中繼的餘額與用量

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在使用中繼（如 new-api、one-api）而非官方端點時，智能體開發者常面臨一個痛點：無法直接感知中繼站點的餘額與用量。dsh-plugin-relay-quota 插件通過讀取中繼的計費接口數據，解決了這一問題。它通過 /quota 命令和 quota_check 工具，讓 DSH 能夠查詢任意 OpenAI 兼容中繼的剩餘配額與已用用量。

功能說明¶

該插件主要提供以下能力：

• /quota 命令：逐個列出已配置的中繼，輸出“已用 / 上限 / 剩餘”數值，附帶百分比條以及“耗盡”或“低於 10%”的標記。支持可選列出該中繼的模型清單。
• quota_check 工具：供 Agent 在執行大任務前自查額度，防止任務因餘額不足而中斷。
• 容錯處理：
  • 端點返回數據缺字段時，輸出 ? 而非猜測數值。
  • 識別 1e8 爲“無上限”哨兵。
  • 某個中繼端點掛掉時，僅影響該行的顯示，不影響其他中繼。

安裝與啓用¶

本插件需在 @deepseek-ai/dsh@0.1.7-alpha.1 環境下運行，且系統需安裝 pnpm。

1. 安裝插件包
   使用以下命令將插件安裝到指定 profile：

    dsh plugin --profile web add github:121212165/dsh-plugin-relay-quota

2. 應用配置補丁
   將插件倉庫根目錄下的 cordis.patch.yml 內容並進 $DSH_HOME/profiles/web/cordis.patch.yml。

   • 注意：不要直接追加。該文件默認爲空數組，若直接追加會導致 YAML 文檔解析錯誤（報錯 end of the stream or a document separator is expected）。

3. 重啓服務
   配置層與客戶端均需重啓才能生效（客戶端按啓動時的配置下發內容生效，硬刷新瀏覽器無效）。

   驗證安裝是否生效：

    dsh --profile web --dump-config | grep dsh-plugin-relay-quota

典型用法¶

配置示例¶

在 cordis.patch.yml 的 insert 數組中添加如下配置：

- insert:
    - id: relay-quota
      name: dsh-plugin-relay-quota
      config:
        enabled: true
        providers:
          - name: my-relay
            baseUrl: http://localhost:3002/v1
            apiKeyEnv: RELAY_API_KEY
            listModels: true

查詢中繼額度¶

在對話中直接輸入：

/quota

這將列出所有中繼的餘額、上限、剩餘量及狀態條。

Agent 自查額度¶

Agent 可以調用 quota_check 工具。在執行大任務前，Agent 會自動檢查各中繼的剩餘額度，若餘額不足或低於閾值，任務邏輯通常會調整或中止。

注意事項¶

• 依賴環境：必須確保 pnpm 在系統 PATH 中，且 DSH 版本爲 0.1.7-alpha.1。
• 權限與安全：配置中的 apiKeyEnv 指定了環境變量名，建議不要將 API Key 直接寫在配置文件中，以免泄露。
• 驗證狀態：根據項目說明，端點數據格式已通過 curl 對真實中繼驗證，解析邏輯有單元測試覆蓋，但插件自身未在運行中的 DSH 進程中進行 live mount 驗證。
• 許可證：該插件遵循 MIT 許可證。

生態與鏈接¶

此插件由社區開發者維護，並非 DeepSeek 官方出品。作爲 DSH 生態的一部分，它與其他插件（如 task-forge、cost-ledger 等）共同構成了開發智能體的工具鏈。

• GitHub 倉庫
• 插件目錄頁