前言¶
在 DeepSeek Harness（DSH）里长时间跑会话或编排任务时，账户余额会随模型调用持续消耗。界面其他位置的用量统计与钱包金额未必同步，要到平台侧单独查看既打断工作流，也容易在余额偏低时毫无察觉。下面介绍的插件把余额固定在 Web GUI 底部状态栏，并可在低于阈值时给出提醒，适合已用 DeepSeek 账号登录 DSH 的桌面用户。
这是什么¶
dsh-balance-monitor 由维护者 kousenlee 发布，分类为联网工具，在 SkillHub 目录 与 GitHub 均可找到。插件面向 DeepSeek Harness Web GUI：通过 DSH 自带的账户能力读取平台钱包金额，在界面底部展示实时余额，并支持低余额阈值与可选的系统通知。许可证为 MIT，当前 package 版本为 1.0.0。
核心功能¶
常驻余额条¶
DSH 各视图底部有一条细长状态栏，默认约每 60 秒刷新一次，窗口重新获得焦点或页面变为可见时也会再次拉取。显示形如 ● Balance ¥x.xx：绿点表示读取成功；琥珀色表示最近一次失败，仍显示上一次成功值；红点并带 Low 徽章表示可用总额已低于你设定的阈值。
详情面板与手动刷新¶
点击状态栏可打开面板：上方展示充值余额、赠送额度、可用总额及最后更新时间，并提供 Refresh now；下方是提醒相关设置（阈值、自动刷新间隔、提醒开关等）。
低余额提醒¶
默认阈值为 ¥5.00。当可用总额低于阈值时，状态栏变红并显示 Low；应用内会出现类似 Low balance: ¥4.19 left, below the ¥5.00 threshold. 的提示；若浏览器已授予通知权限，还可选择发送操作系统级通知。
设置与持久化¶
阈值、自动刷新间隔（30 秒 / 1 / 5 / 10 分钟）、应用内提醒与系统通知开关，既可在状态栏面板中修改，也可在 Settings → Balance reminder 中配置。偏好保存在当前浏览器的 localStorage，刷新页面或重启应用后仍保留。界面语言随 DSH 中英文设置切换。
数据与展示规则¶
余额经 ctx.remote.account.getBalance(...) 由 DSH Host 向 DeepSeek 平台查询，插件不接触、不存储、不传输登录令牌。可用总额 = 充值余额 + 赠送额度（同币种）；赠送额度先扣，再扣充值钱包。多币种时不做换算，面板可按数据切换 CNY / USD。读取失败不会显示为零，而是保留上次成功值并标明陈旧。
环境与前提¶
- DeepSeek Harness 桌面 0.2.2-rc.1 或兼容版本。
- 须使用 DeepSeek 账号 登录；仅 API Key、无账户登录的安装无法读取账户余额，状态栏会显示为未登录状态。
安装与启用¶
插件以当前 DSH 进程权限运行，安装前建议阅读仓库源码与 MIT 许可证。以下命令均出自项目 README。
方式 A：在 DSH 会话中由 Agent 安装（推荐，无需重启）¶
在任意 DSH 会话中请 Agent 安装该插件，或直接调用工具：
plugin_manager install_bundle target = github:kousenlee/dsh-balance-monitor
返回结果中 application: applied 表示插件已在运行中的 GUI 立即生效。
方式 B：CLI 安装后重启应用¶
# 桌面版 CLI 通常位于：
# <DSH install>\resources\runtime\cli\bin\dsh.cmd
dsh plugin --profile desktop add github:kousenlee/dsh-balance-monitor
随后在 <DSH_HOME>/profiles/<profile>/package.json（默认 %USERPROFILE%\.dsh）的 dsh.profile.bundles 中加入 "dsh-balance-monitor"，并重启 DeepSeek Harness。仓库提供的 install.ps1 可自动化该流程。
方式 C：本地开发（Windows PowerShell）¶
维护者在 README 中说明了从克隆仓库执行 install.ps1 的方式；在 macOS 或 Linux 上宜采用方式 A 或方式 B，插件本身为跨平台。
典型用法¶
- 安装并登录 DeepSeek 账号后，在各页面底部观察
● Balance ¥x.xx及圆点颜色含义。 - 点击状态栏打开面板，查看充值/赠送/总额与最后更新时间，需要时点 Refresh now。
- 在面板或 Settings → Balance reminder 中修改阈值并按 Enter 确认；若当前余额已低于新阈值，会提醒一次，同一低余额周期内后续提醒至少间隔 30 分钟。
- 按需开启应用内提醒与系统通知，并选择自动刷新间隔。
适用场景与限制¶
适合：已在 DSH 桌面版用 DeepSeek 账号登录、希望在 GUI 内持续感知钱包余额并在偏低时收到提醒的开发者或日常用户。
不适合或需注意：
- 仅 API Key 场景无账户余额可读。
- 提醒依赖 GUI 页面处于打开状态，应用完全关闭时不会告警。
- 轮询最快 30 秒，平台侧无客户端缓存；余额与 DSH 其他位置的用量统计可能略有差异。
- LiveShare 等非所有者共享视图无
account远程权限，不会挂载余额条。 - 设置按浏览器配置文件保存，不跨设备同步。
卸载可在 DSH Agent 中执行：
plugin_manager remove_bundle target = dsh-balance-monitor
或使用 uninstall.ps1 并重启应用。
结尾¶
dsh-balance-monitor 把 DeepSeek 账户余额接到 DSH Web GUI 底部，用可配置的阈值与刷新策略降低「余额耗尽才发现」的风险，同时明确不持有登录令牌、仅通过 Host 查询钱包金额。更多说明与截图见仓库 README；安装可从 SkillHub 目录页跳转，或直接使用上述 github:kousenlee/dsh-balance-monitor 规格。
- 目录页：https://www.skillhub.cn/plugins/kousenlee/dsh-balance-monitor
- GitHub：https://github.com/kousenlee/dsh-balance-monitor
