余额监控挂件 syagain-zsx/dsh-balance-widget

dsh-balance-widget

在 DeepSeek Harness 顶部工具栏（Session log 旁）显示 各供应商 API Key 的剩余余额 的挂件插件，支持 多个 Key、多个供应商切换查看。

功能

- 顶部右上角胶囊按钮：直接显示当前所选 Key 的余额（如 ¥110.00 / $10.81），点击展开面板
- 多供应商：内置 DeepSeek / OpenRouter / Moonshot / Kimi / SiliconFlow / OpenAI 预设，另有「自定义」可填任意余额查询 URL
- 多 Key：面板内可切换、添加、删除多个 API Key，每个 Key 单独查询余额
- 隐藏金额：面板里的 👁 / 🙈 开关可一键隐藏金额（顶栏按钮与面板金额都变为 ••••），保护隐私
- 币种适配：CNY→¥、USD→$、EUR→€、GBP→£、JPY→¥ 等，顶栏与面板金额符号跟随币种自动切换
- 余额详情：总余额 / 充值余额 / 赠送余额 / 币种 / 可用状态 / 更新时间
- 隐私：API Key 只保存在宿主机（profile 的 settings.yaml），浏览器端只收到打码的 sk-…••••…；余额查询由宿主侧完成（规避浏览器 CORS）

安装

方式一：GitHub 一键安装（推荐）

dsh plugin --profile web add github:syagain-zsx/dsh-balance-widget

装完重启 dsh web 即可。上面的 --profile web 换成你自己的 profile 名。

方式二：手动安装

1. 把本仓库放到 <profile>/node_modules/dsh-balance-widget/
2. 在 <profile>/package.json 的 dsh.profile.bundles 里加入 "dsh-balance-widget"
3. 重启 dsh web

原理

- 宿主 index.js：注册 balance-widget 设置段（持久化 Key + 隐藏开关），注册 /balance RPC 通道（keys / query / save / remove / select / setHide），由宿主 fetch 各供应商余额接口
- 浏览器 lib/client.js：在 conversation.session.header.utilities 插槽挂载按钮 + 面板，经 connection.rpc.call('/balance', …) 与宿主通信

供应商余额接口

| 供应商 | 接口 |
| DeepSeek | GET https://api.deepseek.com/user/balance |
| OpenRouter | GET https://openrouter.ai/api/v1/credits |
| Moonshot（moonshot.cn） | GET https://api.moonshot.cn/v1/users/me/balance |
| Kimi（moonshot.ai） | GET https://api.moonshot.ai/v1/users/me/balance |
| SiliconFlow | GET https://api.siliconflow.cn/v1/user/info |
| OpenAI | GET https://api.openai.com/v1/dashboard/billing/credit_grants |
| 自定义 | 任意 URL，通用解析常见 balance/total_balance/available_balance 等字段 |

Moonshot / Kimi 两个平台（moonshot.cn 国内站、moonshot.ai 国际站）的 Key 互不通用；查询时主端点 401 会自动回退到另一个端点，所以选哪个都能查到余额。

文件结构

dsh-balance-widget/
├── index.js # 宿主插件（设置段 + /balance RPC + 供应商解析） ├── lib/ │ └── client.js # 浏览器插件（顶栏按钮 + 面板 UI） ├── cordis.patch.yml # bundle 补丁（自动 insert 插件行） ├── package.json # dsh.client / dsh.bundle 声明 └── README.md

常见问题

查不到余额 / 报 401：确认 Key 对应的平台与供应商一致（如 Kimi 国内站 Key 应选 Moonshot（moonshot.cn））。Moonshot/Kimi 已做双端点自动回退，通常无需手动区分。

单位是美元：Moonshot / Kimi / OpenAI / OpenRouter 的余额接口单位均为 USD，属正常。

License

MIT