前言¶
DeepSeek Harness (dsh) 是智能体开发环境，使用 DeepSeek 模型时，随时查看账户余额是基础需求。balance-dock 是一个专为 dsh 设计的常驻 Web 插件，由开发者 Cao-zhi-hao 维护。它解决了动态插件刷新即失效的问题，通过常驻机制在会话输入框下方提供实时的余额状态显示。
核心功能¶
- 常驻持久：刷新页面或重启进程后依然存在，无需手动激活。
- 安全取数：API 密钥仅存在于 Host 端，浏览器只通过同源接口
/ds-balance获取数据。 - 自动刷新：默认每 60 秒刷新一次，支持手动刷新。
- 主题适配：自动适配 dsh 的明暗主题。
- 多币种：支持 CNY、USD、EUR 符号显示。
安装与启用¶
前置要求¶
- 已安装并运行 DeepSeek Harness (dsh)。
- 已配置
DEEPSEEK_API_KEY（通常位于$DSH_HOME/.credentials.yaml）。
安装¶
推荐使用 dsh 内置命令安装，它会自动处理插件注册：
dsh plugin --profile web add balance-dock
验证¶
重启 dsh 进程后，访问 http://127.0.0.1:<port>/ds-balance 接口，应返回包含余额信息的 JSON。在任意会话页面，输入框下方应显示余额状态条。
注意事项¶
- 该插件依赖 Host 端的
DEEPSEEK_API_KEY。 - 若采用手动安装方式，必须在
profiles/web/cordis.patch.yml中添加插件行，并重启 dsh 进程。 - 仅支持 CNY、USD、EUR 符号显示。
结语¶
balance-dock 通过常驻插件机制，让余额查看变得无缝且安全。
