余额胶囊 g65tph4ycm-svg/dsh-balance-pill

dsh-balance-pill

DeepSeek Harness（DSH）插件：界面右下角常驻一枚余额胶囊，实时显示当前登录的 DeepSeek 账户余额。点击展开详情，余额偏低时自动变色。

给 DeepSeek Harness 用的悬浮角落胶囊，显示你已登录的 DeepSeek 账户余额 —— 不用填 API Key。

特性

- 不用填 API Key：直接读 DSH 已登录的 DeepSeek 账户钱包（deepseekAccount），和你实际调用模型的是同一个账户。
- 不轮询：连上就推一次，每轮对话结束推一次，打开面板/点刷新再拉一次。
- 低余额提醒：默认 ¥10 变黄、¥5 变红，悬停有说明。
- 一点即达：详情卡里直接跳平台「充值」「用量」页。
- 不落盘：不保存任何余额历史或用量数据。

界面

胶囊在右下角，收起时只显示金额：

● ¥12.07

点开是一张卡片：总可用余额、充值余额、赠金、账户状态、更新时间，以及「刷新 / 去充值 / 用量」三个按钮。

安装

要求：DSH Desktop 或 dsh web，并已在设置里登录 DeepSeek 账号（模型 provider 为 deepseek-account）。

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

然后把克隆下来的目录装进 DSH：

- 让 agent 执行 plugin_manager 的 install_bundle，target 指向该目录的绝对路径（已验证）；
- 或使用 Plugins 页面提供的本地目录安装入口（若你的 DSH 版本提供）。

安装完成后刷新页面，右下角就会出现胶囊。卸载用 remove_bundle 指向 dsh-balance-pill。

配置阈值

插件自带默认阈值，想改就覆盖 profile 的 cordis.patch.yml：

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

改完刷新页面生效。

工作原理

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

- index.js（Host 半）：读取钱包余额，合并赠金与充值钱包，按币种合计；用 Server-Sent Events 推给页面。监听 agent/status，每轮对话 idle 时刷新一次。
- client.js（Client 半）：注册到 shell.overlay，渲染胶囊与详情卡，样式只依赖 --dsw-alias-* 主题变量。

隐私

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

已知限制

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

License

MIT