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

前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在开发或使用 DSH 的过程中，实时掌握 API 余额是一个基础需求。市面上常见的做法是依赖本地估算，这种方式容易受价格表变动影响，且往往不够精确。dsh-balance 插件直接调用 DeepSeek 官方的 GET /user/balance 端点，以账户币种显示真实余额，并在侧边栏提供即时反馈。

核心功能¶

该插件主要提供以下能力：

• 官方数据核实：直接调用官方 API 端点，核实 API key 后返回真实余额。
• 即时推送：使用 SSE 长连接推送数据，1 秒内上屏；另有 15 秒轮询作为兜底机制。
• 低余额告警：余额低于阈值时，数字变橙色。
• 中英双语：文案跟随界面语言自动切换。
• 零依赖：无 npm 运行时依赖。

安装¶

在终端中执行以下命令安装插件：

dsh plugin --profile web add @pengpeng6845/dsh-balance

配置与使用¶

安装后，需要在 profile 的 cordis.patch.yml 文件中按 id 覆盖配置。同时，确保环境变量 DEEPSEEK_API_KEY 已正确设置。

在 cordis.patch.yml 中添加以下配置：

- id: balance
  config:
    balanceEnabled: true              # 是否轮询官方余额端点
    balanceApiKeyEnv: DEEPSEEK_API_KEY # 余额 API key 的凭据引用（环境变量名）
    balanceBaseUrl: https://api.deepseek.com
    balanceRefreshMs: 60000           # 兜底轮询间隔（毫秒）
    lowBalanceAlert: 5                # 低余额警戒线（账户币种单位）

显示与状态¶

• 界面：显示在侧边栏底部，一行扁平原生风格（无卡片、无边框）。
• 状态：网络失败后退避期，数据灰化显示，但仍保留上次成功值。标签页不可见时自动暂停轮询。

注意事项¶

• 余额以账户币种显示，不做任何汇率换算。
• 不做成本估算，只显示真实数据。
• 该插件以 dsh 进程权限运行，安装前应检查源码与许可证。

总结¶

dsh-balance 是一个轻量级工具，适合需要精确监控 API 余额的用户。其零依赖和官方数据源保证了数据可靠性。

• 维护者：PengPeng6845
• 许可证：MIT
• 目录页：https://www.skillhub.cn/plugins/PengPeng6845/dsh-balance
• 源码：https://github.com/PengPeng6845/dsh-balance