dsh-ibka-balance — DeepSeek API 余额监测（常驻卡片）
一个为 DeepSeek Harness (dsh) Web 界面编写的常驻余额监测插件： 在聊天输入框下方的统计栏里实时显示 DeepSeek API 账户余额，每 5 分钟自动刷新，余额过低时变色提醒。
本插件最初由一轮 AI 辅助开发会话产出，随后打包为常驻插件并发布到社区。Architecture: Host 端通过credentials服务取 API Key，经subprocess+curl请求https://api.deepseek.com/user/balance，注册 HTTP 路由/api/ibka-balance；Client 端用浏览器原生window.fetch轮询并渲染在conversation.composer.dock插槽。
功能
- 🟢 实时显示总余额（
total_balance，多币种求和） - 🔄 每 5 分钟自动刷新 + 手动 ⟳ 刷新按钮
- 🟠 < ¥10 变橙色 · 🔴 < ¥5 变红色 · 账户不可用变红
- ℹ️ 悬停显示充值余额 / 赠金余额明细
- 🔒 API Key 只在 Host 端，绝不出进程、不进浏览器
安装（手动）
- 将本仓库的
dsh-ibka-balance目录复制到你的 profile 的 node_modules 下：
~/.dsh/profiles/web/node_modules/dsh-ibka-balance/
- 在
~/.dsh/profiles/web/cordis.patch.yml末尾追加：
- insert:
- id: ibka-balance
name: 'dsh-ibka-balance'- 重启 DeepSeek Harness App（web 模式暂不热更新配置），必要时刷新浏览器页面。
依赖：curl（macOS 自带）、DEEPSEEK_API_KEY 凭据（已存在于 ~/.dsh/.credentials.yaml 或环境变量）。
卸载
删除 cordis.patch.yml 中对应的 insert 行，并删除 node_modules/dsh-ibka-balance 目录，重启即可。
原理
| 层 | 职责 |
|---|---|
| Host | inject: ['webServer', 'credentials'] 等待服务就绪；webServer.register 两个精确路由：GET /api/ibka-balance（余额）、POST /api/ibka-balance/log（客户端自诊断上报，写入工作区 balance-card-report.txt） |
| Client | window.__ModuleLoader__.load 打包的浏览器模块；注册 conversation.composer.dock 插槽条目（防重复注册），window.fetch 轮询，window.setInterval 定时 |
许可证
MIT © phonejoy
