前言¶
在使用 DeepSeek Harness（DSH）进行智能体开发或接口测试时，随时掌握账户余额变化是一项基础需求。虽然 DSH 的基础功能提供了一定的统计，但缺乏一个轻量级、悬浮式的实时监控入口。dsh-balance-bubble 正是为了解决这个问题而生的。
插件介绍¶
这是一个由 Jescoi 维护的 Cordis 插件，专为 DSH 的 Web 界面设计。它会在界面右上角悬浮一个半透明的“玻璃态”气泡，实时显示 DeepSeek 账户余额，并每隔 20 秒自动刷新数据。
核心功能¶
- 实时余额同步：插件采用 Host 和 Browser 分离的架构。Host 端通过
ctx.credentials读取 API Key，调用官方接口获取余额，并在ctx.webServer上暴露GET /dsh-balance路由。Browser 端则注册气泡组件，每 20 秒轮询该接口获取最新数据。 - 液态玻璃视觉：气泡采用半透明浅蓝圆形设计，具备背景模糊、顶部光泽高光以及柔和内阴影效果，呈现液态玻璃质感。
- 自由拖动与自适应：气泡支持鼠标拖拽，位置会自动限制在窗口范围内。当浏览器窗口大小改变时，气泡会按比例缩放以保持相对位置。
- 状态同步控制：气泡右上角提供关闭按钮；侧边栏底部（位于 Cordis 插件条目上方）提供“余额”切换开关。两者状态实时同步。
- 低余额告警：当余额低于阈值（默认 5 CNY）时，气泡会变红并出现脉冲环，即便气泡处于隐藏状态也会强制重新显示。
- 暗色模式适配：监听
theme/change事件，在暗色主题下自动调整颜色和文字对比度。
安装与启用¶
该插件仅支持 DSH 的 Web Profile。
- 执行安装命令：
dsh plugin --profile web add dsh-balance-bubble
- 重启 DSH 进程，插件会自动加载。
配置与使用¶
- 显示/隐藏：点击气泡上的关闭按钮，或使用侧边栏底部的“余额”开关进行切换。
- 余额阈值修改：目前插件没有提供设置 UI。如需调整低余额警报阈值，需直接编辑
lib/client.js中的totalBalance < 5条件。 - API Key：插件不存储密钥，而是从 DSH 的凭据服务中读取
DEEPSEEK_API_KEY，与设置页面中配置的 Key 共用。
已知限制¶
- 位置不持久：气泡的拖拽位置在页面刷新后会重置为默认位置。
- 仅限 Web 界面：目前仅支持 Web Profile，不支持 TUI 界面。
- 硬编码配置：低余额阈值等配置项目前硬编码在代码中，暂未开放配置界面。
总结¶
dsh-balance-bubble 通过极简的 UI 设计，解决了 Web 界下实时监控余额的需求，适合需要频繁调用 API 的开发者使用。
- 仓库：https://github.com/Jescoi/dsh-balance-bubble
- 目录：https://www.skillhub.cn/plugins/Jescoi/dsh-balance-bubble
