dsh-balance：DeepSeek Harness 侧边栏余额监控插件

前言¶

DeepSeek Harness（DSH）采用插件化架构。在使用 Web profile 进行开发或调试时，需要频繁查看 API 余额。手动刷新页面查看既低效又不直观。dsh-balance 插件解决了这个问题，将余额直接嵌入侧边栏，提供实时的额度监控。

插件介绍¶

dsh-balance 是一个 DeepSeek Harness Web 插件，用于在侧边栏底部显示 DeepSeek API 余额。该插件由 eka3os 维护，解决了在开发过程中实时监控 DeepSeek API 剩余额度的问题。

核心功能¶

1. 余额显示：在侧边栏设置区域附近同时显示 CNY 和 USD 余额。
2. 官方接口：通过 DeepSeek 官方 API 端点读取余额数据。
3. 安全设计：API Key 仅在服务端使用，浏览器端仅接收规范化后的余额数值。
4. 自动刷新：每 60 秒自动刷新一次余额，保持数据最新。
5. 状态反馈：在加载中、无余额或请求失败时显示 --。
6. 安装方式：支持直接从 GitHub 仓库安装。

安装与启用¶

在安装前，请确保本地已安装 DeepSeek Harness 且版本不低于 0.1.0-rc.7，并已启用 web profile。

1. 执行安装命令：

dsh plugin --profile web add github:eka3os/dsh-balance

2. 安装完成后，需要重启 Web profile 以加载插件：

dsh web

dsh plugin 命令会将包安装到指定的 profile，并根据插件声明的配置自动激活。

典型用法¶

插件使用 DEEPSEEK_API_KEY 作为凭据引用。你需要提前配置好该密钥。

方式一：通过环境变量配置（单次运行）¶

在启动 DSH Web 时通过环境变量传入 Key：

DEEPSEEK_API_KEY=sk-your-key dsh web

方式二：通过本地凭据文件配置¶

将 API Key 写入 DSH 的本地凭据文件：

# 文件路径为 $DSH_HOME/.credentials.yaml
DEEPSEEK_API_KEY: sk-your-key

配置完成后，侧边栏底部将出现余额显示区域。

适用场景与注意¶

1. 版本要求：需要 DeepSeek Harness >=0.1.0-rc.7。插件版本为 0.1.0。
2. Profile 限制：该插件仅在 web profile 下工作。
3. 安全建议：API Key 或凭据文件不应提交到 Git 仓库。
4. 分发渠道：该插件仅通过 GitHub 分发，未发布到 npm。
5. 源码审查：在安装社区插件前，建议查阅其 GitHub 仓库（https://github.com/eka3os/dsh-balance）的源码与许可证（MIT）。

结尾¶

dsh-balance 插件通过在侧边栏提供直观的余额展示，简化了开发调试流程。对于需要频繁监控 API 资源的开发者而言，这是一个实用且安全的选择。