dsh-plugin-relay-quota

DeepSeek Harness (dsh) 插件：查询任意 OpenAI 兼容中转（new-api / one-api / OpenAI legacy billing 形状）的余额与用量。/quota 一次看所有已配置中转，agent 也能通过 quota_check 工具自己查。

同系列：cost-ledger（本地花费台账）、session-insights（跨会话统计）、transcript（会话归档）、price-aware（官方端点的余额与预算门禁）。本插件补的是中转站这块 price-aware 够不到的面。

功能

• /quota：逐个中转输出"已用 / 上限 / 剩余 + 占比条 + 耗尽/低于10% 标记"，可选列出该中转的模型清单。
• quota_check 模型工具：agent 在大任务开始前自查额度。
• 容错：端点缺字段输出 ? 而不是猜数；1e8 哨兵上限识别为"无上限"；某个中转挂了只影响自己那一行。

数据来源（已对真实中转验证）

• GET /v1/dashboard/billing/subscription → hard_limit_usd / soft_limit_usd（USD 元）
• GET /v1/dashboard/billing/usage → total_usage（美分，OpenAI legacy 形状，new-api/one-api 均克隆了它）
• 可选 GET /v1/models

配置

- 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   # key 放环境变量，不落配置
            listModels: true

安装

克隆或 npm 安装到 profile 的 node_modules；从源码安装需要先构建：npm install 会经 prepare 脚本自动产出 lib/。

验证状态

• 端点形状已对真实 new-api 中转用 curl 验证（含 1e8 哨兵、美分换算）。
• 纯函数解析/渲染有 node --test 测试；host 接线与其他已 mount 验证的同系列插件同构。
• 未在运行中的 dsh 里 live mount 验证本插件自身。