前言¶

在 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。