在 DSH Web GUI 中，在会话页头部添加一个可视化的“余额芯片”，可以减少切换浏览器查看余额的需要。dsh-header-balance 插件通过在会话页头部显示账户余额，让余额查询与对话管理在同一页面完成。
这是一个由 lijunyu726 维护的客户端插件。它的核心作用是在会话页头部显示账户余额，点击即可跳转充值页面。
安装与启用¶
通过官方 CLI 安装：
dsh plugin --profile web add dsh-header-balance
重启 DSH 后，会话页头部就会出现余额芯片。
核心功能¶
- 余额显示：芯片显示总余额，视觉密度与“会话日志”按钮一致。
- 点击充值：点击整块芯片，打开
platform.deepseek.com/top_up。Electron 外壳会调用系统浏览器打开该链接。 - 手动刷新：芯片内有一个
↻按钮，点击可刷新余额（已阻止冒泡，不会误触充值跳转）。 - 自动刷新：挂载时、每 60 秒、窗口重新获得焦点时自动刷新。
- 悬停详情：鼠标悬停显示账户余额、赠送/充值拆分（赠金为 0 时自动省略该行）以及充值入口。
- 窄屏适配：手机端省略“余额”二字，只保留金额。
- 不可用告警：当
is_available为 false 时，给出明确提示，而非静默显示 ¥0.00。 - 失败可读：针对未配置 Key、Key 失效、余额不足、限流、超时、断网、响应异常等情况，各自给出对应的提示文案。
典型用法¶
- 查看余额：重启后，会话页头部会自动显示当前余额。
- 充值：点击芯片区域，直接跳转充值页。
- 刷新：点击芯片内的
↻图标刷新数据。 - 详情：鼠标悬停芯片，查看赠送与充值的拆分明细。
架构与安全¶
余额查询涉及 API Key，因此插件采用宿主侧逻辑：
- 宿主侧处理：API Key 与网络请求全部在宿主侧完成。Key 永不进入浏览器代码。
- 依赖服务：依赖宿主侧的
settings与credentials服务读取凭据。 - 远程调用：使用
connection.rpc.call调用accountBalance/balance接口，而非直接访问浏览器端的remote命名空间。
适用场景与注意¶
- 版本依赖：该插件只在 DSH 0.1.5 的槽位契约上验证过。
- 许可证：使用前请检查源码与许可证。
总结¶
dsh-header-balance 通过宿主侧逻辑确保了 API Key 的安全，同时提供了直观的余额查看与充值入口。它适合需要在 DSH 界面中快速监控 DeepSeek 账户状态的用户。
