前言¶
在使用 DeepSeek Harness (DSH) 进行开发时，监控 API 余额和了解当前的定价时段（高峰与闲时）是日常操作的一部分。dsh-balance 插件解决了这两个问题，通过在 Web 界面提供一个常驻小部件，让你无需切换页面即可掌握余额状态和定价档期。
这是什么¶
dsh-balance 是一个由 qianmoyishu 维护的 DSH 插件。它为 DSH Web 界面提供了一个常驻小部件，用于实时显示 DeepSeek API 的余额，并根据北京时间的高峰与闲时定价规则提供视觉提示。
核心功能¶
- 常驻可拖动小部件
小部件默认显示在界面右上角。你可以按住头部将其拖动到任意位置，位置会自动保存到浏览器的 localStorage 中，刷新或重启服务后依然存在。它挂在shell.overlay根级插槽，不会占用侧边栏插槽，也不会与其他插件（如宠物）的位置冲突。 - 收起与展开
点击小部件头部的「–」可以将其收起，此时显示为一个圆点，仅展示总余额和高峰档期符号；点击「▸」则展开显示完整信息。 - 余额显示
小部件展开后，会显示总余额、充值余额、赠送余额以及最后更新时间。 - 自动刷新与倒计时
小部件每 60 秒自动刷新余额数据。对于高峰时段，会显示距离切换到闲时或下一个高峰时段的倒计时，鼠标悬停可查看完整的时段说明。 - 高峰时段提示
根据配置的 PEAK_WINDOWS（默认为北京时间 09:00-12:00 和 14:00-18:00），实时显示当前档期：
- 红色：高峰时段
- 绿色：闲时半价时段 - 服务端代理
余额查询通过服务端代理接口/api/balance进行。DEEPSEEK_API_KEY 仅在服务器进程内解析，不会下发到浏览器端，保证了密钥安全。
安装与启用¶
- 安装插件
在终端中执行以下命令进行安装：
dsh plugin --profile web add "https://github.com/qianmoyishu/dsh-balance/releases/latest/download/dsh-balance-0.2.1.tgz"
- 配置 API 密钥
在 DSH 的 Web 界面中，前往“设置” → “模型”页面，或者在环境变量中配置DEEPSEEK_API_KEY。未配置时，小部件会提示但不会报错。 - 重启服务
安装或更新插件后，必须重启 dsh web 服务并刷新页面，插件才会生效。
典型用法¶
- 拖动位置
按住小部件头部，将其拖动到屏幕上你认为最方便查看的位置。 - 收起查看
点击头部「–」收起小部件，快速查看当前总余额和是否处于高峰时段。 - 展开查看
点击头部「▸」展开小部件，查看详细的余额明细和剩余时间。
适用场景与注意¶
- 适用场景：需要在开发过程中持续监控 DeepSeek API 余额，并希望直观了解当前是否处于高定价时段的开发者。
- 时区依赖：高峰时段的计算基于 Asia/Shanghai 时区，不依赖本机系统时区。
- 自定义配置：如需修改高峰时段的定义，需编辑源码
lib/client.js顶部的PEAK_WINDOWS常量。 - 开发环境：在本地源码开发模式下，修改代码后需要重启 dsh web 才能生效。
结语¶
dsh-balance 提供了直观的余额监控和定价提示，减少了手动查询和切换页面的开销。插件由社区开发者维护，遵循 MIT 许可证。更多细节可参考插件目录或源码仓库。
