dsh-balance-pill：DeepSeek Harness 余额胶囊插件

前言¶

在 DeepSeek Harness（DSH）里使用模型时，经常会需要知道当前账户的余额。手动去平台页面查看既麻烦，又容易错过余额不足的时机。DSH 的理念是「一切皆插件」，通过插件可以给主程序增加细颗粒度的 UI 交互。这个插件就是在 DSH 的 Web 或 Desktop 界面右下角，常驻一枚胶囊，实时显示当前登录的 DeepSeek 账户余额。

是什么¶

dsh-balance-pill 是一个 DeepSeek Harness 插件，维护者为 g65tph4ycm-svg。它的核心功能是在 DSH 的界面右下角显示一个悬浮胶囊，胶囊里是当前登录的 DeepSeek 账户余额。点击胶囊可以展开详情卡片，里面包含总可用余额、充值余额、赠金、账户状态、更新时间等信息，以及「刷新 / 去充值 / 用量」三个按钮。余额偏低时胶囊会自动变色（默认 ¥10 变黄、¥5 变红），悬停时会有提示说明。

核心功能¶

不需要填写 API Key：插件直接读取 DSH 已登录的 DeepSeek 账户钱包（deepseekAccount），显示的余额与实际调用模型时使用的账户一致。
不使用轮询：采用 Server-Sent Events（SSE）推送方式，连接建立后由 Host 进程推送余额快照，每轮对话结束后推送一次，打开面板或点击刷新按钮时也会拉取一次。
低余额提醒：默认阈值 ¥10 变黄、¥5 变红，悬停提示，可通过配置修改阈值。
一点即达：详情卡片提供直接跳转到平台「充值」「用量」页面的链接。
不落盘：不保存任何余额历史或用量数据，只在内存中处理和显示。

安装与启用¶

安装前需要满足以下条件：
- 使用 DSH Desktop 或 dsh web；
- 已在 DSH 设置里登录 DeepSeek 账号，且模型 provider 为 deepseek-account。

安装步骤如下：

克隆插件仓库到本地：

git clone https://github.com/g65tph4ycm-svg/dsh-balance-pill.git

将克隆下来的目录安装到 DSH：
- 让 agent 执行 plugin_manager 的 install_bundle，target 指向该目录的绝对路径；
- 或者使用 DSH 的 Plugins 页面提供的本地目录安装入口（若你的 DSH 版本提供该入口）。
安装完成后刷新页面，右下角就会出现胶囊。

如需卸载，使用 plugin_manager 的 remove_bundle，指向 dsh-balance-pill。

配置阈值¶

插件自带默认阈值，如需修改，可以在 profile 的 cordis.patch.yml 中覆盖配置：

- id: dsh-balance-pill
  name: 'dsh-balance-pill'
  config:
    warnBelow: 20
    dangerBelow: 8

修改后刷新页面即可生效。

工作原理¶

插件分为 Host 半和 Client 半：

Host 半（index.js）：
调用 deepseekAccount.getBalance() 获取钱包余额；
合并赠金与充值钱包，按币种合计；
通过 Server-Sent Events 推送余额快照到浏览器；
监听 agent/status，当状态为 idle 时触发一次刷新。
Client 半（client.js）：
注册到 shell.overlay，渲染胶囊与详情卡；
样式只依赖 DSH 的主题变量 --dsw-alias-*，不引入额外样式文件。

通信流程如下：

┌──────────── Host ────────────┐        ┌────────── Browser ──────────┐
│ deepseekAccount.getBalance() │        │ client.js                   │
│        ↓                     │  SSE   │  shell.overlay 里的胶囊      │
│ /dsh-balance-pill/stream ────┼───────→│  单次连接，持续接收快照       │
│ agent/status → idle 触发刷新  │        │  点开卡片时 POST 请求刷新     │
└──────────────────────────────┘        └─────────────────────────────┘

隐私与限制¶

隐私：
- 余额请求全部在 Host 进程里完成，浏览器只拿到数字和两个平台链接；
- 自定义的 SSE 路由只绑定 DSH 自己的本机监听地址，且不返回 CORS 头，跨站页面无法读取内容；
- 插件不读取、不存储你的 API Key 或登录令牌。

已知限制：
- 没有用量接口：DeepSeek 目前只开放了余额查询，插件只能显示钱包余额，无法提供 token 用量、请求数或消费明细；
- 扣费有延迟：平台余额到账通常比对话结束晚几秒，刚聊完时看到的数字可能还未更新；
- 只在 Web/Desktop 场景生效：纯 CLI 场景没有可渲染的界面；
- 文案只有中文：运行时文案暂未接入 DSH 的 locale 服务，插件标题/描述已提供中英两份。

适用场景与注意¶

这个插件适合在 DSH Web 或 Desktop 界面中需要持续关注 DeepSeek 账户余额的开发者或用户。如果你习惯在 DSH 里连续对话，使用这个插件可以减少手动查看余额的频率，也能更早发现余额不足的情况。

在使用前，建议：
- 检查插件源码与许可证（MIT）是否符合你的使用场景；
- 确认你的 DSH 版本支持本地目录安装入口；
- 理解插件只在 Web/Desktop 界面中提供可视化交互，CLI 场景无效果。

结语¶

dsh-balance-pill 为 DSH 用户提供了一个轻量级、无需 API Key 的余额查看方案。它通过 SSE 推送和主题变量实现低侵入式 UI，既满足了实时查看余额的需求，又保持了隐私安全。如果你经常在 DSH 中使用 DeepSeek 模型，可以考虑安装这个插件来提升使用体验。

目录页：https://www.skillhub.cn/plugins/g65tph4ycm-svg/dsh-balance-pill
GitHub：https://github.com/g65tph4ycm-svg/dsh-balance-pill