AI 余额悬浮监控Badegg404/dsh-api-balance

dsh-api-balance

DSH 插件 · 在 DeepSeek Harness 会话标题栏悬浮显示多个 AI 平台的账户余额与用量。

DSH Plugin License: MIT

English

一个面向 DeepSeek Harness（DSH） 的持久化 Web 插件：在页面右上角标题栏（「Session log」按钮左侧）挂一个小胶囊，实时显示所选平台的账户余额；点开展开下拉卡片，内含「余额监控」与「用量监控」两个 tab —— 余额显示账户/额度余额，用量显示近 30 天费用或 token 配额。可切换平台、填写 API Key 并手动刷新。

特性

- 多平台统一：一个插件查询多个 AI 供应商余额，平台在 UI 里切换
- 双 tab：「余额监控」显示账户余额；「用量监控」显示近 30 天费用 / token 配额 —— 两个 tab 各自独立保存平台、API Key 与刷新
- 持久化：平台 / API Key / 附加参数存入 DSH 凭据库（~/.dsh/.credentials.yaml，权限 0600），重启不丢
- 实时刷新：30 秒自动轮询 + 手动刷新
- 安全：Host 路由仅接受 loopback 请求；API Key 永不回传前端、不写日志
- 主题适配：全部样式走 DSH 主题 token，跟随明暗主题
- 易扩展：新增平台只需在 Host 的 PROVIDERS 数组里加一条声明，前端自动渲染对应表单

支持平台

余额

| 平台 | 接口 | 附加参数 |
| --- | --- | --- |
| AGICTO | POST /v1/enterprise/account | uuid（账户 UUID） |
| DeepSeek | GET /user/balance | — |
| OpenRouter | GET /api/v1/credits | — |
| Moonshot (Kimi) | GET /v1/users/me/balance | — |
| 硅基流动 SiliconFlow | GET /v1/user/info | — |
| MiniMax | GET /v1/token_plan/remains | — |
| 阶跃星辰 StepFun | GET /v1/accounts | — |
| xAI (Grok) | GET /v1/billing/credits | — |

用量

| 平台 | 接口 |
| --- | --- |
| OpenAI | GET /v1/organization/costs |
| 智谱 GLM | GET /api/monitor/usage/quota/limit |
| Together AI | GET /v1/billing/usage |
| Anthropic (Claude) | GET /v1/organizations/cost_report |

各平台余额接口可能随官方调整，解析失败时请以其官方文档为准；新增平台见下文「扩展新平台」。

架构

Host（Node 进程）                     Client（浏览器）
───────────────                     ──────────────
lib/index.js                         lib/client.js
├─ GET  /balance/providers          标题栏胶囊 + 下拉卡片（双 tab）
├─ GET  /balance/status               ├─ 余额 tab：余额显示
├─ GET  /balance/usage                ├─ 用量 tab：30天费用/配额
├─ POST /balance/config               ├─ 平台下拉选择
├─ POST /balance/usage-config         ├─ API Key 输入
├─ POST /balance/clear                └─ 附加参数（按平台动态渲染）
└─ POST /balance/usage-clear
│
└─ credentials 服务（~/.dsh/.credentials.yaml）
BALANCE_PROVIDER / BALANCE_API_KEY / BALANCE_EXTRA
USAGE_PROVIDER  / USAGE_API_KEY  / USAGE_EXTRA

Host 通过 webServer 注册 loopback-only 的 /balance/* 路由，读取凭据库后请求对应平台的余额或用量接口；Client 直接 fetch 同源路由，用 React.createElement 渲染挂件（含余额/用量双 tab，__ModuleLoader__ 打包格式，无需构建步骤）。

安装

方式一：dsh plugin 命令

dsh plugin --profile web add https://github.com/Badegg404/dsh-api-balance.git

方式二：手动安装

1. 把本仓库放到本地（如 ~/.dsh/profiles/web/plugins/dsh-api-balance/）
2. 编辑 ~/.dsh/profiles/web/package.json：

{
"dependencies": {
"@Badegg404/dsh-api-balance": "file:plugins/dsh-api-balance"
},
"dsh": {
"profile": {
"bundles": [
// ...已有 bundles...
"@Badegg404/dsh-api-balance"
]
}
}
}

3. pnpm install，然后重启 DSH。

使用

1. 打开一个会话，标题栏「Session log」左侧出现胶囊
2. 「余额监控」tab：选余额平台 → 粘贴 API Key（AGICTO 还需填账户 UUID）→ 保存并查询；余额显示在胶囊与 tab 里，30 秒自动刷新
3. 切到「用量监控」tab：选用量平台（如 OpenAI）→ 粘贴 API Key → 保存并查询；显示近 30 天费用（智谱为 token 配额），同样自动刷新

展示

┌─ 标题栏 ───────────────────────────────────────────┐
│ 会话标题…        [● 余额监控 12.34 USD] [Session log] │
└────────────────────────────────────────────────────┘
│ 点开
▼
┌─ 账户监控 ──────────────────────┐
│ [ 余额监控 ] [ 用量监控 ]         │
├─────────────────────────────────┤
│ 平台        [AGICTO          ▾] │
│ AGICTO 余额  ¥ 4.9974451        │
│ API Key     [••••••••]          │
│ 账户 UUID   [a1b2c3...        ] │
│ [ 保存并查询 ]  [清除]  [刷新]    │
└─────────────────────────────────┘

扩展新平台

在 lib/index.js 的 BALANCE_PROVIDERS（余额）或 USAGE_PROVIDERS（用量）数组中追加一条声明，前端表单会自动渲染：

{
id: "myplatform",
label: "My Platform",
currency: "USD",                        // 显示用货币符号（可选）
extraFields: [],                        // 附加参数（如 agicto 的 uuid）
request: {
method: "GET",
url: "https://api.example.com/v1/balance",
headers: { "Authorization": "Bearer {key}" },   // {key} → API Key
// body: '{"uuid":"{uuid}"}',                    // 需要时启用，{字段名} → 附加参数
},
parse(res) {
// 余额平台：返回 { balance: "12.34" }（或 { balance: null, error: "..." }）
// 用量平台：返回 { summary: "近30天费用: $1.23" }（或 { summary: null, error: "..." }）
},
}

request.headers / request.body 中的 {key} 与 {} 占位符会在请求前被替换；用量平台还可使用 {start_date} / {end_date} / {start_ts} / {end_ts} / {start_iso} / {end_iso}（自动计算近 30 天窗口）。

License

MIT