ibka512/dsh-ibka-balance
常驻余额监测卡片:DeepSeek API 余额实时显示,每 5 分钟自动刷新,过低变色提醒。A permanent composer-dock card showing your DeepSeek API account balance with auto-refresh and low-balance warnings.
已收录
3
Usage
Bundle 已验证
预览
功能介绍
输入框下方常驻余额卡片:实时显示 DeepSeek API 账户余额,每 5 分钟自动刷新,支持手动刷新,余额过低自动变色提醒。
适合
- 希望在 Web 输入框下方常驻查看账户余额的 DeepSeek API 用户。
- 需要每五分钟自动刷新、手动刷新和低余额颜色提醒的用户。
- 希望不离开 DSH 即可查看总余额及充值余额、赠金余额明细的工作流。
不适合
- 不使用 DeepSeek API 账户或没有 DEEPSEEK_API_KEY 凭据的用户。
- TUI 和其他非 Web 界面;该卡片注册在 Web 输入区插槽中。
- 缺少 curl 的环境,或希望通过单条插件命令完成安装的用户;文档提供的是手动安装流程。
README
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
常见问题常见问题
在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:ibka512/dsh-ibka-balance。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。
兼容性以页面上展示的 bundle 与 profile 状态为准。如果某个 profile 尚未检测到,请先保持禁用,并在生产启用前阅读仓库文档。
GitHub 链接和 activity 元数据是 release 与维护状态的来源。新版本发布后重新查看本页,确认目录已经观察到最新版本。