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 端，绝不出进程、不进浏览器

安装（手动）

1. 将本仓库的 dsh-ibka-balance 目录复制到你的 profile 的 node_modules 下： ~/.dsh/profiles/web/node_modules/dsh-ibka-balance/

2. 在 ~/.dsh/profiles/web/cordis.patch.yml 末尾追加：

   - insert:
       - id: ibka-balance
         name: 'dsh-ibka-balance'
   

3. 重启 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