前言¶
在使用 DeepSeek Harness 进行智能体开发或模型调试时，经常需要在不同模型提供商之间切换（例如从 DeepSeek 切到 OpenRouter 或 Kimi）。如果在切换模型时能直接看到对应提供商的账户余额，能更直观地控制成本。
dsh-balance 插件正是为此设计的。它是一个轻量级组件，会自动出现在侧边栏底部（设置按钮右侧），显示当前模型所属提供商的余额。
插件定位¶
dsh-balance 是一个「Provider-aware balance chip（提供商感知余额芯片）」。它不依赖任何运行时环境，也不修改 DeepSeek Harness 的核心代码，属于独立的插件包。
核心功能¶
这个插件主要解决「如何在侧边栏快速查看当前模型提供商的余额」这一问题。
-
自动切换提供商
插件会读取当前会话的模型路由（如deepseek,openrouter,moonshotai,zhipu,minimax等），并显示对应提供商的余额。切换模型时，余额芯片会自动更新。 -
DeepSeek 峰谷计费感知
对于 DeepSeek 提供商，插件会识别当前的计费窗口：- 峰时（红点）： 周一至周五，北京时间 09:00–12:00 和 14:00–18:00。
- 非峰时（绿点）： 其他时间。
这有助于开发者避开高价时段。
-
零依赖与轻量级
- 零运行时依赖：依赖项为空，仅使用 Harness 提供的平台模块和 React。
- 体积小：打包后约 11 kB（gzip 压缩后）。
- 无核心修改：属于树外包，不会修改 Harness 的源码或 CSS。
-
实时刷新与容错
- 自动刷新：每 60 秒自动刷新一次余额。
- 手动刷新：点击芯片即可立即刷新。
- 优雅降级：如果密钥缺失或上游接口出错，芯片会显示为「Balance —」的静默样式，并在悬停提示中显示原因，不会破坏界面布局。
使用方法¶
安装插件后，操作非常简单：
* 查看余额：在侧边栏底部找到余额芯片，它会根据当前选中的模型自动显示对应提供商的余额（如 OpenRouter 的剩余积分或 Kimi 的可用余额）。
* 查看详情：鼠标悬停在芯片上，可以看到余额的详细拆解（例如：总额、赠送金额、充值金额）。
* 刷新数据：点击芯片即可手动触发刷新。
注意事项与适用场景¶
- 无需配置：安装后无需任何配置项，开箱即用。
- 安全机制：密钥仅在主机端解析，浏览器端仅接收标准化的余额数值，不会直接接触敏感凭证。
- 兼容性：如果模型路由不在支持列表中（包括自定义提供商 ID），插件会回退显示 DeepSeek 的余额，而不是报错。
- 界面适配：当侧边栏收窄至 56px 宽度时，芯片会自动折叠以节省空间。
结语¶
dsh-balance 是一个为了提升开发效率而生的工具。它通过极简的代码实现了多提供商余额的统一展示，特别适合需要在多个 AI 服务商之间频繁切换的开发者。更多细节请查阅项目主页。
