前言¶

用 DeepSeek Harness（DSH）做对话或智能体开发时，账户余额往往要切到设置或网页控制台才能看到。长时间跑任务、试模型时，余额是否够用并不直观。dsh-balance-badge 是社区维护者 eatone9254 发布的客户端插件，在主界面输入框右下角挂一枚余额胶囊，登录后自动拉取平台余额，悬停可看明细，点击可立即刷新。下面介绍它的能力、安装方式与使用注意。

这是什么¶

dsh-balance-badge 在 DSH 主界面右下角显示 DeepSeek 账户余额角标，不占用主布局、不挡输入操作。插件分类为客户端；Host 半几乎为空，不向会话注册工具、不写会话状态。数据走 DSH 自带的账号通道：客户端调用 remote.account.getBalance()，由宿主用已登录凭据向平台查询后回传渲染，插件内除该接口外不自行发 HTTP 请求，也不读取或保存 API Key。

核心功能¶

角标注册在窗口浮层 shell.overlay，固定在右下角；浮层点击穿透，只有胶囊接收鼠标事件。

自动刷新：启动读一次，之后每 60 秒一次；窗口重新可见、连接重建时会补一次。点击胶囊立即刷新；悬停显示充值余额、赠金余额和刷新提示。

状态展示：已登录显示形如 余额 ¥7.19 的高对比度数字；未登录显示「登录后查看」；查询失败显示红色「暂不可用」，并保留上一次金额，下次刷新成功后会恢复。配色取自 --dsw-alias-* 主题变量，深浅色随 DSH 主题切换；文案中英双语，跟随 DSH 语言设置。

安装与启用¶

DSH 要求 >=0.2.1-rc.2（README 注明在 0.2.1-rc.2 桌面端实测）。Node 引擎要求 >=22（见 package.json）。

推荐从 npm 安装：在 DSH 插件安装界面填写包名：

dsh-balance-badge

钉版本可填：

dsh-balance-badge@1.0.0

从 GitHub 安装：

github:eatone9254/dsh-balance-badge#v1.0.0

仓库根目录即完整包，tag 内可直接运行，无需本地构建。

本地压缩包：在插件源码目录执行 npm pack，将生成的 dsh-balance-badge-1.0.0.tgz 放到运行 DSH 的机器上，在安装界面填该文件的绝对路径。

安装完成后，打开侧边栏 插件 →「已安装插件」，找到 余额角标，打开开关即可生效。

典型用法¶

三种显示状态：

首次读取在后台进行，读取期间会显示「读取中…」。角标最多有约 60 秒缓存；若与网页控制台数字不一致，点击胶囊即可立即刷新。

适用场景与注意¶

适合已在 DSH 登录 DeepSeek 账号、希望在主界面随时看到余额的开发者。未登录时角标只会提示「登录后查看」，需到 设置 → 账号与余额 完成登录。

插件以当前 DSH 进程权限运行，安装前应自行查看 GitHub 仓库 源码与 MIT 许可证。DSH 生态主张「一切皆插件」；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。

常见问题：持续「暂不可用」可点击重试，多为平台接口暂时不可达或登录态失效；只注册一个 shell.overlay 条目，不覆盖内置界面；单个很小的客户端模块，README 说明不会拖慢启动。

结尾¶

经过上面的步骤，你可以在 DSH 主界面右下角常驻余额角标，减少切后台查账的次数。更多信息见目录页 https://www.skillhub.cn/plugins/eatone9254/dsh-balance-badge 与源码 https://github.com/eatone9254/dsh-balance-badge。