前言¶

在 DeepSeek Harness 里查账户余额，默认路径是打开 Settings → Account。若你长时间开着会话、又需要留意充值余额是否够用，反复进设置页会打断工作流。社区插件 dsh-plugin-balance-badge 在界面里放一枚始终可见的「余额胶囊」，数字与设置页里的 Topped-up balance 一致，并自行刷新，属于 DSH「一切皆插件」思路下的纯客户端展示层扩展。

下面介绍它做什么、如何安装，以及使用时需要注意的环境与权限。

这是什么¶

dsh-plugin-balance-badge 由维护者 reg4916 发布，分类为客户端插件：在 Harness 侧边栏区域展示 DeepSeek 账户充值余额，不新增 Host 服务、不提供工具、也没有独立配置项。数据来自 Harness 已有的 DeepSeek 账户 Remote，与 Settings → Account 同源，而不是另接一套 provider API。

核心功能¶

数字与设置页一致¶

插件读取 ctx.remote.account 链路：本地凭证状态 → 已登录时调用 getBalance（携带 version、locale、timezoneOffsetSeconds）。Host 侧经 accountController → deepseekAccount，对应平台接口 GET /api/v0/users/get_user_summary 中的 normal_wallets / bonus_wallets。界面上显示的充值余额（Topped-up balance）与设置页相同；Bonus balance 仅在 tooltip 中单独展示（且仅在大于零时显示），不会加进充值余额数字。

自动刷新与手动刷新¶

刷新策略在 README 中写得很具体：

• 页面加载时拉一次；
• 页面可见时每 60 秒轮询；
• 窗口重新获得焦点时立即刷新；
• 本地存储的账户凭证变化时（登录、登出、授权轮换）立即刷新；
• 点击胶囊可主动刷新。

实现上使用插件内共享 poller（单飞、最短间隔 15 秒、过期结果丢弃、页面隐藏时暂停）。开发者可在 client.js 中调整 POLL_MS / MIN_GAP_MS。

状态展示¶

加载中显示 …；未登录或不可用时显示 --；刷新失败时保留上次已知金额并给出 stale 提示，不会伪造为 0。

布局与本地化¶

• macOS 桌面版：胶囊在窗口条（traffic lights 旁），通过 shell.overlay 的 balance-badge 槽位固定。
• Web / Windows / Linux：放在侧边栏底部 Settings 行旁（sidebar.footer.action，随 rail 布局适配）。

文案支持 en / ru / zh，样式使用 Harness 主题 token，随当前主题与语言切换。

环境要求¶

• DeepSeek Harness 0.2.x，且已具备 DeepSeek 账户功能（能正常打开并渲染 Settings → Account 的同一能力）。

安装与启用¶

推荐从 npm 安装预构建包，无需拉仓库、无需 allowBuilds 审批。在 Settings → Plugins → Add plugin 中可粘贴下列任一标识：

dsh-plugin-balance-badge
github:reg4916/dsh-plugin-balance-badge
github:reg4916/dsh-plugin-balance-badge#v1.0.0

npm 包名为 dsh-plugin-balance-badge；若需固定尚未发布的 commit，再用 GitHub spec。

桌面端由应用自身 profile 管理插件，上述 GUI 路径（或由智能体通过 plugin_manager 的 install_bundle，目标为 dsh-plugin-balance-badge 或 github:reg4916/dsh-plugin-balance-badge）是支持路径。

非托管 profile 的 CLI 安装示例：

dsh plugin --profile <profile> add dsh-plugin-balance-badge

安装后若 profile 的 HMR 未运行，需重启应用一次；之后客户端插件改动可由运行中的页面热更新。

卸载时：从 profile 的 package.json 去掉依赖与 bundle 名，删除 node_modules/dsh-plugin-balance-badge（若手改 lockfile 则同步清理），再重启应用。

典型用法¶

安装并启用 bundle 后无需额外配置。日常使用即观察侧边栏（或 macOS 窗口条）上的余额胶囊；需要确认 bonus 或更新时间时，将指针悬停在胶囊上查看 tooltip；余额看起来过旧时点击胶囊强制刷新。

插件 Host 半部 index.js 仅 export function apply() {}，不参与业务逻辑；展示由浏览器侧的 client.js 通过 Harness 模块表注入。

适用场景与注意¶

适合：经常在 Harness 里跑会话、希望一眼看到与官方设置页一致的充值余额，又不想反复打开 Account 的用户或智能体开发者。

注意：

• 插件以当前 DSH 进程权限运行，会走你已登录的 DeepSeek 账户凭证；安装前请阅读 GitHub 仓库 源码与 MIT 许可证。
• 未登录或账户 Remote 不可用时只显示 --，不能替代官方计费或充值页面做财务决策。
• 社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系；版本与安装方式以仓库 README 与 npm 包为准（当前 package 版本为 1.0.1）。

结尾¶

dsh-plugin-balance-badge 把 Settings → Account 里的充值余额搬到常驻 UI，自动刷新、状态诚实、无配置负担。若要进一步了解实现细节或参与贡献，见仓库 README 与 test/contract.test.mjs 中的契约测试说明。

• 目录页：https://www.skillhub.cn/plugins/reg4916/dsh-plugin-balance-badge
• GitHub：https://github.com/reg4916/dsh-plugin-balance-badge