
jelly-000/dsh-balance-monitor
80最近提交 2026年8月14日
dsh-balance-monitor DSH 插件
一个极简的DeepSeek Harness (DSH)插件,在侧边栏底部显示DeepSeek API余额、比例条和当日花费。样式使用官方设计令牌,克制内敛。余额通过服务端获取,浏览器端仅看到数字,保证API key安全。
如何安装 dsh-balance-monitor DSH 插件
dsh plugin --profile web add "github:<you>/dsh-balance-monitor#main来源命令需要人工核对。复制不会执行命令。
dsh-balance-monitor DSH 插件数据来源
dsh-balance-monitor DSH 插件快照日期:2026年8月16日
discovered
dsh-balance-monitor DSH 插件能做什么
- 通过GET https://api.deepseek.com/user/balance实时获取余额
- 当日花费计算:以当天首次查询余额为基线,减去当前余额
- 比例条按余额比例显示蓝→琥珀→红三色渐变
- 每60秒自动轮询,切换标签页时立即刷新
- 上游失败时保留上次数据并变淡标记,不闪错误
- 可折叠为36px圆形,显示紧凑金额和tooltip
dsh-balance-monitor DSH 插件适合哪些场景
- 监控DeepSeek API余额,避免在高频使用中意外中断
- 追踪每日API花费,控制预算
- 不离开DSH界面即可快速查看余额
- 通过颜色条直观预警余额不足
dsh-balance-monitor DSH 插件适合谁
- 使用DSH调用DeepSeek API的开发者
- 管理多个DeepSeek账户并需要余额可见性的团队
- 希望在侧边栏获得轻量、无侵入余额监控的重度用户
dsh-balance-monitor DSH 插件的限制
- 仅支持DeepSeek API,不兼容其他模型提供商
- 需要自备有效的DeepSeek API密钥并配置在DSH凭证中
- 目前仅适用于Web UI模式(profile web)
dsh-balance-monitor DSH 插件的仓库 README 摘录
以下文字摘自 dsh-balance-monitor DSH 插件的上游仓库 jelly-000/dsh-balance-monitor 的 README,版权归原作者,仅作引用。
DeepSeek 账户余额,直接显示在 dsh 侧边栏底部。 一个极简的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 插件:在侧边栏底部(设置上方)显示你的 DeepSeek API 账户余额、一条细的余额剩余比例条,以及当天已花费的金额。样式完全使用官方设计令牌,克制内敛。 <p align="center"> <img src="docs/preview/balance-wide.png" alt="侧边栏底部余额卡片" width="280"> </p> ## 功能 | 功能 | 实现 | |---|---| | 实时余额 | 服务端调用 `GET https://api.deepseek.com/user/balance`,使用 `$DSH_HOME/.credentials.yaml` 中的 `DEEPSEEK_API_KEY`(环境变量优先) | | 今日花费 | 当天首次成功查询的余额记为基线(持久化在 `$DSH_HOME/storages/balance-monitor.json`);花费 = `max(0, 基线 − 当前)`。充值不会让数字变负 | | 比例条 | 当前余额 ÷ 当日基线,蓝 → 琥珀 → 红 三档渐降 | | 位置 | 注册在官方 `sidebar.footer.action` 槽位 —— 设置上方,零 hack | | 折叠态 | 收起后变为 36px 圆形,显示紧凑金额 + tooltip | | 健壮性 | 60s 轮询 + 切回标签页时刷新;上游失败时保留上次数据(变淡标记 stale),不闪错误 | ## 安装 浏览器端 bundle 是手写的 classic script,**无构建步骤**,git 安装无需 prepare 脚本: ```sh dsh plugin --profile web add "github:<you>/dsh-balance-monitor#main" ``` 或从 npm(发布后): ```sh dsh plugin --profile web add dsh-balance-monitor ``` 然后重启 Web UI(`dsh --profile web`)。卡片出现在展开的侧边栏底部、设置按钮上方。 ## 工作原理 一个插件行同时承担两种角色(`dsh.bundle` patch + `dsh.client` 浏览器注册表声明): - **服务端半**(`lib/index.js`)—— 在 `ctx.connection` 上注册 `/balance` RPC 通道(loopback 信任围栏)。每次调用读取 API key、查询余额
阅读完整 README仓库许可: MIT
dsh-balance-monitor DSH 插件常见问题
如何安装这个插件?
在终端中执行 `dsh plugin --profile web add "github:jelly-000/dsh-balance-monitor#main"`,然后重启DSH Web UI(`dsh --profile web`)。余额卡片会出现在展开的侧边栏底部、设置按钮上方。
如何配置DeepSeek API密钥?
插件会从DSH凭证文件 `$DSH_HOME/.credentials.yaml` 中读取 `DEEPSEEK_API_KEY` 字段。同时支持环境变量 `DEEPSEEK_API_KEY`,环境变量优先级更高。请确保在启动DSH前已设置好密钥。
余额多久更新一次?
插件每60秒轮询一次DeepSeek余额API。当切换回DSH浏览器标签页时也会立即刷新。如果API调用失败,会保留上次数据并以变淡样式标记为过时。
我的API密钥安全吗?
安全。API密钥永远不会离开服务端。浏览器端仅通过loopback RPC通道接收余额数值。插件不收集任何遥测数据,唯一网络请求是官方DeepSeek余额接口。
这个插件支持其他AI模型吗?
不支持。它专为DeepSeek API设计,调用DeepSeek余额接口并使用DeepSeek API密钥。无法用于OpenAI、Claude等其他模型提供商。