前言¶
DeepSeek Harness (DSH) 是一个插件化的开发环境。在使用过程中，开发者需要时刻关注 API 余额，避免因余额不足导致请求中断或产生额外费用。现有的 Web 界面缺少直观的余额展示入口。anonrttty/dsh-api-balance-displayer-plugin 旨在解决这一问题，它是一个轻量级、零构建的插件，能在会话头部右上角直接显示余额。
插件定位¶
- 名称: anonrttty/dsh-api-balance-displayer-plugin
- 定位: DeepSeek Harness API 余额显示插件
- 维护者: anonRTtty
- 许可证: MIT
核心功能¶
- 位置: 在会话头部右上角显示余额，样式与内置的“Session log”按钮保持一致。
- 手动刷新: 点击 ↻ 按钮可立即刷新余额数据。
- 自动刷新: 仅在页面加载（F5）时自动刷新一次。切换会话或视图不会触发刷新。
- 本地化 UI: 标签、加载状态及所有错误提示均跟随 DSH 的界面语言（英文/简体中文）。
- 错误提示: 网络或凭证错误时，胶囊会显示具体的错误原因（例如
Balance: Invalid API key）。 - 免费查询: 余额查询接口为免费接口，不消耗 API 令牌。
- 无冲突: 注册在添加槽位
conversation.session.header.utilities中，不会替换任何内置 UI。
安装与启用¶
使用官方 CLI 安装，插件会自动应用配置：
dsh plugin --profile web add github:anonRTtty/dsh-api-balance-displayer-plugin
安装完成后，重启 DSH 并在浏览器中强制刷新（Ctrl+Shift+R）即可生效。
典型用法¶
- 手动查看: 点击页面右上角的 ↻ 按钮，查看最新余额。
- 自动查看: 每次在浏览器中按 F5 刷新页面时，余额会自动更新。
