前言¶

在 DeepSeek Harness（DSH）裏跑 Agent 時，模型賬號往往分散在 DeepSeek、豆包、千問、混元或自建中轉站。要確認「還能不能繼續調 API」，常見做法是分別登錄各控制台或自己寫腳本輪詢餘額接口。插件 dsh-multiplatform-balance（維護者 bjzkhy，GitHub 倉庫 bjzkhy/dsh-multiplatform-balance）把這件事做成 DSH 的 Skill 與 Tool：在本地配置密鑰後，由 Agent 只讀查詢已配置平臺的餘額，未配置的平臺會明確返回未配置狀態，不會虛構數字。

這是什麼¶

dsh-multiplatform-balance 是 DeepSeek Harness 的 Skill 插件，分類屬於聯網工具。它向 Agent 註冊 multiplatform-balance skill 和 get_multiplatform_balances 工具，支持一次查全部已配置平臺，或只查單個平臺；內置約 60 秒緩存，且只做查詢，不會充值或修改賬戶。許可證爲 MIT（見倉庫 README）。

核心功能¶

下面這些是 README 中寫明的能力，安裝後可在對應 profile 的配置裏按需啓用平臺。

1. Skill / Tool 註冊：Skill 名爲 multiplatform-balance；工具名爲 get_multiplatform_balances，可選參數 provider（例如 deepseek、doubao、qwen、hunyuan）。
2. 內置平臺類型：DeepSeek；豆包 / 火山引擎（type: volcengine）；千問 / 阿里雲百鍊（type: aliyun）；混元 / 騰訊雲（type: tencent）；以及 type: custom 的自定義 HTTP 餘額接口。
3. 查詢範圍：豆包、千問、混元側查詢的是雲賬號級餘額，不是單個模型 SKU 的餘額。
4. 緩存與邊界：默認 balanceCacheTtl 爲 60 秒，減少頻繁請求；未配置的平臺返回 configured: false。
5. 全局選項：可在插件配置裏設置默認貨幣（如 currency: "CNY"）及各平臺條目下的 currency。

安裝與啓用¶

Web 場景下，在終端執行官方文檔給出的安裝命令：

dsh plugin --profile web add dsh-multiplatform-balance

若使用 DSH 桌面端，把 --profile web 換成當前環境對應的 profile，例如 desktop。

插件以當前 DSH 進程的權限運行，並會按配置訪問各雲廠商或自定義 HTTP 接口。安裝前建議閱讀倉庫源碼與 MIT 許可證，確認密鑰只寫入本地 profile 配置、不會提交到版本庫。

配置 balance¶

在所用 profile 的 cordis.patch.yml 中，爲插件 id dsh-multiplatform-balance 增加 config，核心是 balance 映射（鍵名即 Agent 側可選的 provider 別名）。下面示例來自 README，密鑰需替換爲你自己的值：

- id: dsh-multiplatform-balance
  config:
    currency: "CNY"
    balanceCacheTtl: 60
    balance:
      "deepseek":
        type: deepseek
        apiKey: "sk-..."
        currency: "CNY"
      "doubao":
        type: volcengine
        accessKey: "AKLT..."
        secretKey: "..."
        region: "cn-north-1"
        version: "2022-01-01"
        currency: "CNY"
      "qwen":
        type: aliyun
        accessKeyId: "LTAI..."
        accessKeySecret: "..."
        currency: "CNY"
      "hunyuan":
        type: tencent
        secretId: "AKID..."
        secretKey: "..."
        region: "ap-beijing"
        currency: "CNY"

說明：密鑰僅保存在本地配置文件中，注意不要泄露或誤傳到公開倉庫。

自定義 HTTP 餘額接口¶

若餘額由自建或第三方中轉站提供，可增加 type: custom 條目：

balance:
  myproxy:
    type: custom
    endpoint: "https://你的中轉站/api/balance"
    headers:
      Authorization: "Bearer sk-xxx"
    valuePath: "data.balance"
    currency: "CNY"

valuePath 使用點號路徑從 JSON 響應中取值，例如 data.balance、balance、data.amount。

Agent 典型用法¶

配置完成後，模型或用戶可通過 Skill multiplatform-balance 或調用 Tool get_multiplatform_balances 查詢餘額。需要只看某一平臺時，傳入可選參數 provider，取值與 balance 下的鍵一致（如 deepseek、doubao、qwen、hunyuan）；省略則查詢所有已配置平臺。

適用場景與注意¶

適合：在 DSH 對話或自動化流程裏，讓 Agent 在調模型前或運維巡檢時彙總多平臺賬戶餘額；已有各平臺 API 密鑰或雲賬號 AK/SK，並願意寫在 profile 的 cordis.patch.yml 中。

注意：

• 插件依賴聯網訪問各廠商 OpenAPI 或你配置的 endpoint，需保證 DSH 運行環境出網正常。
• 未配置的平臺不會返回假餘額，只會標記 configured: false。
• 社區插件目錄 SkillHub 條目 與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬關係；星標與版本以倉庫當前狀態爲準（package.json 中版本爲 0.1.0）。

結尾¶

dsh-multiplatform-balance 把多平臺餘額查詢收斂成 DSH 內的一個 Skill 與 Tool，配置一次即可在 Agent 側只讀拉取 DeepSeek、豆包、千問、混元及自定義 HTTP 源。進一步瞭解可查看 SkillHub 目錄頁 與 GitHub 倉庫 README。