前言¶
在 DeepSeek Harness（DSH）里跑任务时，账户余额是否够用往往要到 DeepSeek 官网或账单页才能确认。侧栏只有账号头像，没有和计费相关的即时信息。任务跑完才发现余额不足，会打断开发节奏。
下面介绍社区插件 dsh-avatar-balance（维护者 adrian-atlas）：在侧栏底部、头像正上方增加一行全宽余额展示，并用颜色标记是否低于你设定的阈值；余额会在任务结束等时机自动刷新。插件分类为客户端，当前 GitHub 星标为 0，许可证 MIT，版本 1.0.1（以仓库 package.json 为准）。
这是什么¶
dsh-avatar-balance 是 DSH 的 Web 客户端插件：登录 DeepSeek 账号后，在侧栏脚注区域显示账户总余额（充值 + 赠送），并在余额旁给出状态标记。未登录时不显示。
与「偶尔打开账单页查余额」相比，它把余额固定在 Harness 界面内，并与任务生命周期、页面可见性挂钩刷新，适合长期在 DSH 里调试智能体、反复提交任务的开发者。
核心功能¶
展示位置与形态¶
- 余额行位于侧栏底部，紧挨账号头像上方。
- 一行全宽显示余额；旁边有状态标记：总额低于阈值时为琥珀色 ⚠，达到或高于阈值时为绿色 ✓。
- 鼠标悬停可查看余额明细（breakdown）。
- 侧栏收起时，改为圆形钱包按钮，不占全宽行。
可配置阈值¶
- 默认阈值为 20（单位与 DeepSeek 账户余额一致，以官方展示为准）。
- 点击状态标记可修改阈值；数值保存在本地（浏览器侧），不会上传到插件仓库以外的未知服务端——具体存储方式以实现为准，安装前建议阅读
client.js等源码。
余额刷新时机¶
README 列出的刷新策略如下：
- 页面加载时
- 任意任务结束后约 3 秒
- 页面处于可见状态时，每 2 分钟 一次
- 窗口重新获得焦点时
- 点击界面上的 ⟳ 刷新时
余额为账户级，同一 DeepSeek 账号下的各会话共享同一余额数据（由 DeepSeek 账户 API 决定，插件负责拉取与展示）。
安装与启用¶
环境要求（来自 README）：
- DeepSeek Harness 0.2.1-rc.3 及以上
- 已登录 DeepSeek 账户
在 DSH 中：Settings → Plugins → Install，填入下列标识（须与官方 README 一致，不要自行改写为 CLI 子命令）：
github:adrian-atlas/dsh-avatar-balance
安装完成后，客户端插件会按 package.json 中 dsh.client.immediately: true 在 Web 端加载；具体补丁见仓库中的 cordis.patch.yml。
典型用法¶
- 完成安装并登录 DeepSeek 账号后，打开 Harness Web 界面，侧栏底部应出现余额行与状态标记。
- 若标记为琥珀色，表示「充值 + 赠送」总额低于当前阈值；点击标记，在面板中调整阈值（默认 20），保存于本地。
- 跑完一次 DSH 任务后等待约 3 秒，观察余额是否更新；也可切换窗口焦点或点击 ⟳ 手动触发刷新。
- 收起侧栏时，通过圆形钱包按钮仍可访问余额相关入口（具体交互以当前版本 UI 为准）。
仓库 README 提供 assets/balance-ok.webp、balance-low.webp、threshold.webp 等截图，可在 GitHub 页面核对视觉效果。
适用场景与注意¶
适合谁
- 经常在 DSH 里提交任务、希望不用离开界面就能盯余额的开发者。
- 需要自定义「低余额」提醒线（本地阈值）的用户。
务必注意
- DSH 生态是「一切皆插件」；SkillHub 目录页 为社区收录站点，与 DeepSeek、幻方无官方从属关系，本文介绍不代表官方背书。
- 插件在当前 DSH 进程 / 浏览器上下文中运行，会代表已登录用户请求账户余额相关接口；安装前应阅读 GitHub 源码 与 MIT 许可证，确认行为符合你的安全策略。
- 阈值与展示样式依赖插件版本；升级 DSH 或插件后若异常，可对照
engines.dsh（>=0.2.1-rc.3）与 Release 说明。
结尾¶
dsh-avatar-balance 把 DeepSeek 账户余额和阈值状态放进侧栏头像旁，并在任务结束、定时、聚焦等时机刷新，减少「任务跑着跑着才发现没钱」的情况。
