自动识别当前模型厂商(内置 7 家),在输入框内显示余额或配额,未内置厂商可配置自定义接口。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:jacujay/dsh-model-balance
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
自动识别当前模型厂商,在输入框内直接显示余额 / 配额——模型名称左侧一个小按钮,悬停查看、点击刷新。没有公开余额接口的厂商,可在设置页添加自定义接口兜底。
为 DeepSeek Harness(DSH web)而生。
特性
- 自动识别厂商——从 DSH 配置读取当前默认模型的 provider,先按 provider id 匹配、再按 baseURL 域名兜底;自定义 id(如
minimax-cn)也能命中。 - 内置厂商——DeepSeek、Moonshot/Kimi、MiniMax、阶跃星辰、智谱(仅配额)、硅基流动、OpenRouter。
- 两类结果——金额余额(接口提供时含现金/赠金明细)与配额(MiniMax / 智谱只给用量计划,不给钱)。
- 输入框按钮——原生输入行里、模型名称左侧的小
◈图标。悬停弹出浮层,点击刷新;错误 / 无接口 / 配额态各有颜色。 - 设置页——设置 → 余额查询:列出内置厂商,并可为任意 provider 添加自定义余额接口(URL + 响应字段路径 + Bearer/裸 Key 鉴权 + 显示名)。
- Key 安全——API Key 全程在 Host 侧通过 DSH 凭据库解析,绝不到达浏览器;自定义接口配置持久化到
~/.dsh/dsh-model-balance.json,不含任何密钥。 - 秒级生效——Host 通过同源 HTTP 路由应答,刷新页面即用,无需重启。
安装
需要 DSH web。可从插件市场安装,或:
# 从 GitHub 安装
dsh plugin --profile web add github:jacujay/dsh-model-balance
然后刷新浏览器页面。
内置厂商
| 厂商 | 接口 | 类型 |
|---|---|---|
| DeepSeek | /user/balance |
余额(CNY) |
| Moonshot / Kimi | /v1/users/me/balance |
余额 |
| MiniMax | /v1/token_plan/remains |
配额(按模型 %) |
| 阶跃星辰 | /v1/accounts |
余额 |
| 智谱 GLM | /api/monitor/usage/quota/limit |
仅配额 |
| 硅基流动 | /v1/user/info |
余额 |
| OpenRouter | /api/v1/auth/key |
余额(USD)/ 无限 |
New API 兼容中转站
New API 的 Token 用量接口是 /api/usage/token,使用和模型调用相同的 API Key,不需要数字用户 ID 或单独的 Access Token。在 设置 → 余额查询 添加自定义接口:
- URL:
https://你的中转站.example.com/api/usage/token - 响应字段路径:
data.total_available - 鉴权方式:
Bearer Token - 显示名称:可选
插件会自动识别 New API 的 token_usage 响应;unlimited_quota 为 true 时显示无限额度,否则显示剩余额度、总额度和已用额度。
其它厂商:在 设置 → 余额查询 添加自定义接口。API Key 仍来自 DSH 凭据(provider 的 apiKeyEnv),自定义 URL 由 Host 侧携带调用。
隐私与安全说明
- 余额请求由本地 DSH Host 携带厂商 API Key 发出;Key 不离开本机、不进浏览器。
- 设置页只保存接口元数据(
~/.dsh/dsh-model-balance.json),不含密钥。 - Host 路由挂在 DSH web 服务器上,同源 HTTP;写操作(保存/删除自定义接口)带同源校验。
- 自定义接口 URL 由用户提供、可能指向任意地址,保存前请自行确认。
开发
# 无构建步骤——Host 是纯 ESM(lib/index.js),Client 是手写 __ModuleLoader__ bundle(client/client.js)
node --check lib/index.js
node --check client/client.js
许可证
MIT
链接
同类插件
bowenliang123/dsh-context★ 1831
DSH 上下文洞察面板:Context 仪表盘 + /context命令 + Context 浏览器,查看 Context的分类组成、内容详情、演进趋势、压缩/注入事件、统计等一站式 Context 全生命周期管理。
Han-1413141/dsh-cost-meter★ 369
会话与当日 API 费用统计、预算图框(已用%)、官方余额、历史看板,支持峰谷计价与官方价格一键同步。
wssfk12138/dsh-damage-pulse★ 237
在 DSH Web 界面追踪 DeepSeek Token 用量、单次与会话费用及账户余额,并显示缓存感知的扣费动画。
zh667/TokenLedger★ 202
侧边栏用量面板:把 Token 归属到实际服务该请求的中转站,站点从已有的 provider 配置中读出,无需额外配置;含今日/本月/累计三窗口、按站点与模型下钻、一年活跃度热力图,以及 New API / Sub2API / DeepSeek 余额。
Ychris12138/dsh-usage-stats★ 169
多供应商用量看板:按供应商/模型统计 Token 与日期下钻,统一展示账户余额,并追踪 OpenCode Go / Z.ai 订阅额度。
PolinniZhong/dsh-personal-center★ 118
DeepSeek Harness 个人中心:跨会话用量统计、按模型成本估算、全局自定义指令、外观全局字号、数据驱动的桌面宠物(位图/矢量皮肤)与会话状态概览,纯本地离线运行。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。