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.

Bundle 已验证 MIT JavaScript 未知
Bundle 已验证

已收录

3

Usage

Bundle 已验证

版本未知
语言JavaScript
许可证MIT
在 GitHub 查看

预览

功能介绍

输入框下方常驻余额卡片:实时显示 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 端,绝不出进程、不进浏览器

安装(手动)

  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

常见问题常见问题

在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:ibka512/dsh-ibka-balance。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。