dsh-api-meter

dsh-api-meter

多供应商 API 用量 / 余额监控插件，用于 DeepSeek Harness (DSH)。

实时展示你已接入的所有 LLM / 视觉提供方的余额、额度窗口与重置时间，按 Provider 自动发现、按 API Key 去重、按用量直观可视化。

特点

• 动态 Provider 发现：从 llm-pi-ai / llm-deepseek / vision-toolkit 配置命名空间 + pi-ai 目录 baseUrl 自动收集，无需手工登记
• 按 API Key 去重：同一账户的多个入口（如 LLM provider + 视觉 provider 共用同一 key）只显示优先级最高的那张卡
• 余额适配器：内置 DeepSeek (/user/balance)、MiniMax (/v1/token_plan/remains)、Moonshot (/v1/users/me/balance)；通用 JSON 路径可自定义
• 用量进度条（Kimi 风格）：fill = 已用量（空条 = 剩余多，更直观）；"已用 X% · 剩余 Y% · X 小时后（YYYY-MM-DD HH:mm）"消除歧义
• 双入口：设置 → 插件 → API 用量 tab，对话区顶部视图环也有API 用量页签（和插件商店同位）
• Agent 工具：api_meter —— 在对话中问"我的余额多少"即可自动查询
• 后台刷新：可配置间隔（默认 5 分钟），缓存 + 失败降级，单 provider 失败不影响其他
• 安全：API Key 仅在服务端经 ctx.credentials.resolve 解析，绝不出现在浏览器响应中

安装

dsh plugin --profile web add "github:BigAdam-h/dsh-api-meter"

然后重启 dsh web，刷新浏览器。在设置 → 插件 → API 用量 标签或对话区顶部视图环即可看到。

配置

默认在 patch 层提供最小配置（provider 枚举 + 5 分钟刷新）。如需新增自定义通用 meter，编辑 ~/.dsh/profiles/web/cordis.patch.yml：

- id: api-meter
  name: dsh-api-meter
  config:
    refreshIntervalMinutes: 5
    requestTimeoutMs: 15000
    backgroundRefresh: true
    genericMeters:
      - provider: my-gateway
        displayName: My Gateway
        balanceUrl: https://gateway.example.com/v1/balance
        balancePointer: data.balance
        apiKeyEnv: MY_GATEWAY_KEY

适配器已验证

Provider	端点	支持
DeepSeek	GET {base}/user/balance	✅
MiniMax	GET {origin}/v1/token_plan/remains	✅（国内 + 国际 anthropic-protocol 路由）
Moonshot/Kimi	GET {origin}/v1/users/me/balance	✅
New API / Sub2API 中转	通用 balanceUrl + balancePointer	✅
其他	通用 balanceUrl + balancePointer	✅

兼容性

• DeepSeek Harness web profile
• @deepseek-ai/dsh >= 0.1.0-rc.6
• DSH 客户端 Cordis 限制：媒体类（视觉/音频）block 会被 DSH 丢弃，文本/结构化结果正常显示

License

MIT