前言¶
DeepSeek Harness (DSH) 的插件生态允许用户根据需求扩展功能。在使用多供应商配置时，快速查看当前模型对应的余额状态是高频需求。dsh-balance-chip 旨在解决这一问题，通过在输入框工具栏提供可视化的余额圆环，让开发者无需切换页面或手动查询即可掌握额度情况。
是什么¶
dsh-balance-chip 是一个面向 DeepSeek Harness 的客户端插件，由开发者 O1dZ 维护，采用 MIT 许可证。它通过圆环、悬浮提示和实色详情面板展示余额，圆环位置位于模型选择器左侧。该插件随当前会话的模型选择自动刷新，每 60 秒更新一次数据，无需手动输入凭证即可读取余额。
核心功能¶
- 持久加载与状态管理：作为普通持久插件包，使用 bundle patch 在启动时加载。重启 Harness 无需重新创建动态脚本，模型切换后自动清除上一选择，避免数据混淆。
- 余额展示与刷新：显示当前供应商、模型、接口返回的余额明细、更新时间及手动刷新按钮。晚到的查询请求不会覆盖新的供应商数据，刷新失败时保留上次余额并标明过期。
- 主题适配与交互：圆环、悬浮提示和详情面板自动跟随深浅主题。详情面板可通过按
Esc键或点击外部区域关闭。 - 容错处理：将金额、币种与原始额度分开显示。插件不会将缺少凭证、权限不足、超时、不支持或异常回复当作零余额处理，确保数据准确性。
- 自动配置解析：自动使用所选供应商的已启用配置，无需用户再次手动输入 Key。
安装与启用¶
本项目尚未发布到 npm，需通过源码包安装。以下以 Windows 的 desktop profile 为例，其他系统请替换相应路径。安装前请确保已关闭 Harness，并准备好 Git 和 pnpm。
- 克隆仓库
在任意工作目录执行：
git clone https://github.com/O1dZ/dsh-balance-chip.git
- 添加到 Profile
保持在该目录，执行安装命令（不执行依赖安装脚本）：
pnpm --dir "$env:USERPROFILE\.dsh\profiles\desktop" add --ignore-scripts ("file:" + (Resolve-Path '.\dsh-balance-chip').Path.Replace('\', '/'))
-
配置 Bundle
打开该 profile 目录下的package.json，将dsh-balance-chip追加到dsh.profile.bundles数组中，并保留原有 bundle。 -
启动 Harness
完整启动 Harness 后打开会话并选择已配置的供应商模型。首次安装或宿主代码更新后，必须完整重启 Harness，网页刷新无法替换已加载的模块。
典型用法¶
- 查看余额：将鼠标悬停在输入框工具栏左侧的圆环上，查看简略余额；点击圆环或圆环可展开实色详情面板。
- 自动刷新：切换模型时，圆环会立即刷新显示新模型的余额；非切换状态下，每 60 秒自动更新一次。
- 手动刷新：点击详情面板中的刷新按钮可强制更新数据。
适用场景与注意事项¶
- 兼容版本：面向 Harness 0.2.0-rc.2。其他版本及操作系统尚未验证。
- 支持范围：支持 DeepSeek API（含自定义路由名）、DeepSeek Account、Moonshot（中国/国际）、SiliconFlow（中国/国际）、OpenRouter 以及自定义兼容网关。普通 OpenAI、Anthropic、Google 模型密钥及 OAuth 订阅配额未适配。
- 安全与隐私：余额请求只在宿主侧执行，Key 从 Harness 凭证服务解析，端点、凭证值和原始错误文本不进入客户端。请求只使用 GET，同源且禁止重定向，非本机明文 HTTP 不查询。
- 显示说明：CNY 圆环以 ¥50 为显示参考，USD 以 $10 为显示参考，不代表账户额度上限。
- 隐私保护：请勿在 Issue、PR、截图或日志中提交 Key、会话 Cookie、OAuth token、真实 profile 或账号信息。
总结¶
dsh-balance-chip 通过本地化插件的方式，在 DeepSeek Harness 中提供了直观的多供应商余额管理功能。它遵循 DSH 的插件化理念，利用宿主侧权限安全获取数据，适合需要频繁切换模型并监控额度的高级用户。更多细节可参考插件目录或源码仓库。
