r0bert001/dsh-balance-plugin

README 摘要

dsh-model-balance 在 DeepSeek Harness Web 界面中实时显示 DeepSeek 账户模型余额的插件。 插件在会话页头部（标题下方）显示一个余额胶囊：当前总余额、更新时间点、 状态圆点（绿 = 正常 / 黄 = 获取中 / 红 = 失败），并带一个手动刷新按钮。 把鼠标悬停在胶囊上可以看到充值 / 赠送余额的明细。 工作原理 - 宿主端 （ lib/index.js ）：每 intervalMs （默认 60 秒）用配置的凭证 调用 GET {baseURL}/user/balance ，缓存快照，并通过 webServer 注册一个 exact 路由 /api/model-balance 提供给浏览器。该接口 永远不会暴露 API Key 。 - 浏览器端 （ lib/client.js ）：每 30 秒轮询该路由（页面重新可见时立即 刷新），把快照渲染到 conversation.session.header.utilities 插槽。 凭证解析与官方 DeepSeek LLM 适配器一致：先走 credentials 服务（Web 的 「模型」设置页写入的 Key，即 $DSH HOME/.credentials.yaml ），再回退到启动 环境变量 DEEPSEEK API KEY 。 DEEPSEEK BASE URL 可覆盖 API 地址。 安装 安装后重启 Web 服务（ dsh web ）并刷新页面即可生效： 配置 编辑 $DSH HOME/profiles/web/cordis.patch.yml 覆盖行配置： 验证 - 接口： curl http://127.0.0.1:3080/api/model-balance 应返回 {"state":"ok","data":{...},"fetchedAt":...} 。 - 组成检查： dsh --profile web --dump-config 中应包含 model-balance 行。 说明 - 默认绑定为 127.0.0.1 ，余额接口只返回余额数据；如需更严格的访问控制， 可自行在宿主端加鉴权。 - 移除插件： dsh plugin --profile web remove dsh-model-balance ，然后重启。

分类