dsh-plugin-relay-quota: Read Balances and Usage from Any OpenAI-Compatible Relay

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 仓库
• 插件目录页