DeepSeek Harness 插件：dsh-balance-pill

前言¶

在 DeepSeek Harness（DSH）的 Web Profile 中开发或调试时，开发者通常需要频繁确认当前的 API 余额。打开仪表盘或刷新页面会打断工作流。dsh-balance-pill 插件通过在界面中直接嵌入一个始终可见的余额指示器，解决了这一痛点，无需跳转页面即可获取余额状态。

插件介绍¶

dsh-balance-pill 是一个 DeepSeek Harness Web 插件，由开发者 ivbrajkovic 维护，采用 MIT 协议开源。

其核心功能是在 DeepSeek Harness 的 Web 界面中显示当前的 API 余额。当会话打开时，余额指示器显示在会话头部；无会话时，它会固定在右上角。插件不提供图表或设置弹窗，仅作为一个轻量级的视觉组件存在。

核心功能¶

该插件具备以下功能：

位置显示：在有会话时位于会话头部；无会话时固定在右上角，确保始终可见。
余额轮询：每分钟自动轮询一次余额接口。
峰时/非峰时着色：根据当前时间是否处于配置的峰时范围内，显示红色（峰时）或绿色（非峰时）的背景色。
配置管理：通过 DSH 的 Settings 界面配置峰时规则，配置持久化到本地。

安装与启用¶

安装前请确保已配置 DEEPSEEK_API_KEY 并运行 DeepSeek Harness Web Profile。

使用以下命令安装插件：

    dsh plugin --profile web add github:ivbrajkovic/dsh-balance-pill

安装完成后，重启 Web Profile 并刷新浏览器页面。

如果需要固定特定版本，可以添加 commit hash：

dsh plugin --profile web add github:ivbrajkovic/dsh-balance-pill#<commit>

配置说明¶

插件的峰时规则通过 DSH 的设置界面进行配置，无需修改配置文件。

打开 Settings -> Plugins -> Plugin configuration。
展开并编辑 Balance pill peak hours 配置项。
设置时区（默认为 UTC）和峰时时间段（格式为 HH:MM - HH:MM，每行一个）。
保存设置。

配置数据会持久化到 ~/.dsh/settings.yaml（命名空间为 dsh-balance-pill）。插件的逻辑判断基于用户浏览器的本地时区，且配置更新后会立即生效（无需重启）。

配置结构示例如下：

{
  timezone: "UTC",
  peakHours: [
    ["01:00", "04:00"],
    ["06:00", "10:00"],
  ],
}

安全与架构¶

该插件在架构设计上注重安全性：

Host/Client 分离：API 密钥仅存在于 DSH 的 Host 进程中，仅用于本地接口请求，绝不会发送到浏览器。
数据传输：浏览器端只接收简化的数据格式 { "ok": true, "balance": 42.17, "currency": "CNY" } 或错误状态，无法获取敏感信息。
零依赖：Host 端使用 Node.js 内置的 fetch，无外部依赖；Client 端通过 DSH 的 dsh.client 加载。
权限控制：插件不直接读取文件或启动进程，仅调用 DSH 现有的 credentials 和 webServer 服务。

结尾¶

dsh-balance-pill 提供了一种轻量、安全且直观的方式，在 DeepSeek Harness 的开发环境中监控余额与使用时段。对于需要长期运行调试任务的开发者而言，它能有效减少查看余额的操作步骤。

GitHub: https://github.com/ivbrajkovic/dsh-balance-pill
目录: https://www.skillhub.cn/plugins/ivbrajkovic/dsh-balance-pill