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.
Listed
3
Usage
Bundle verified
Preview
What it does
Permanent composer-dock balance card: real-time DeepSeek API account balance with 5-minute auto-refresh, a manual refresh button, and low-balance color warnings.
Best for
- DeepSeek API users who want their account balance permanently visible below the Web composer.
- Users who need five-minute refreshes, manual refresh, and visual warnings for low balances.
- Workflows that benefit from seeing total balance and recharge-versus-grant details without leaving DSH.
Not ideal for
- Users who do not use a DeepSeek API account or lack a DEEPSEEK_API_KEY credential.
- TUI and other non-Web interfaces, since the card is registered in a Web composer slot.
- Environments without curl or users seeking one-command plugin installation; the documented setup is manual.
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
Frequently Asked QuestionsFAQ
Use the verified command dsh plugin --profile default add github:ibka512/dsh-ibka-balance in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.
Compatibility follows the bundle and profile status shown above. If a profile is not detected, keep the plugin disabled there and check the repository documentation before enabling it in production.
The GitHub link and activity metadata are the source of truth for releases and maintenance. Revisit this page after a new release to confirm the catalog has observed the latest version.