前言¶
用 DeepSeek Harness（DSH）跑会话时，Platform 账户里还剩多少可用余额，往往要切到浏览器打开用量页才能确认。对经常调模型、关心扣费进度的开发者来说，这一步打断工作流。社区插件 dsh-plugin-balance-indicator（维护者 jeremytenjo，分类：客户端）把当前登录账户的剩余余额显示在 DSH 左侧边栏底部、账户行上方，并支持定时刷新与一键跳转用量页。下面按定位、能力、安装与用法说明。
这是什么¶
插件全名对应仓库 jeremytenjo/dsh-plugin-balance-indicator，在 SkillHub 目录页 可查到条目。它在 Harness 界面里读取已登录 DeepSeek 账户的 Platform 钱包余额，以 ¥12.34 或 $12.34 形式展示；数据来自 Host 侧账户服务，不在浏览器里存放密钥或 token。
核心功能¶
根据仓库 README，已核实的能力包括：
- 侧栏底部余额徽标：位于左侧边栏 footer，与账户行、Plugins 控件同一行；徽标只占内容宽度，排在 Plugins 启动器之前（
order: -1）。侧栏收折为 56px 窄轨时徽标隐藏，展开后立刻恢复显示（客户端缓存仍保留上次读数）。 - 赠金与主余额分离：悬停 tooltip 列出各币种钱包、有正余额的 bonus 钱包、最近一次成功刷新时间，以及点击提示；赠金不会静默并入主余额数字。
- 刷新策略：TanStack Query 在挂载、每 60 秒、窗口重新获得焦点或网络重连时拉取；Host 对成功读数做 20 秒合并缓存。徽标旁的刷新按钮强制
refresh=1绕过 Host 缓存，读取过程中图标旋转，且不会误开用量页。 - 点击跳转：已登录且余额加载成功时，点击徽标打开账户提供的
usageUrl（缺省为https://platform.deepseek.com/usage）。 - 明确状态：未连接 DeepSeek 账户显示
Sign in；查询失败显示Unavailable（点击重试）；首次加载显示Balance…；失败时不展示虚假的零余额。 - 中英文界面：跟随 Harness 语言设置。
- Host 路由：浏览器通过
GET /__dsh/deepseek-balance访问本机 loopback；Host 调用ctx.deepseekAccount.getBalance，仅返回钱包金额与链接 JSON，不暴露凭证。
环境与依赖¶
- DeepSeek Harness 0.2.1-rc.2（README 标明插件针对该版本构建）。
- 须在 Harness Settings → Account 中登录 DeepSeek 账户；余额来自 Platform 会话。仅配置 API Key、未登录 Platform 账户时无法读取余额。
- Host 需能访问
platform.deepseek.com。
安装与启用¶
官方 README 给出的安装步骤如下。先将仓库克隆到本地，再按 profile 加入插件（desktop 需换成 dsh --profile <name> --dump-config 中显示的名称）：
git clone https://github.com/jeremytenjo/dsh-plugin-balance-indicator.git
dsh plugin --profile desktop add ./dsh-plugin-balance-indicator
重启 Host 或 reload 页面后，打开或新建会话。徽标出现在左侧边栏底部、账户行上方。README 也提到可手动把包目录以 link: 写入 profile 的 dependencies 并加入 dsh.profile.bundles，但更推荐上述 dsh plugin add 命令。
插件 无需额外配置项；Platform 域名由 Harness 账户提供方决定，插件跟随而非硬编码 API Host。
典型用法¶
README 用表格归纳了徽标状态与点击行为，可对照自测：
| 状态 | Footer 徽标 | 点击徽标 |
|---|---|---|
| 已登录，余额已加载 | ¥12.34 |
打开 Platform 用量页 |
| 含赠金 | ¥12.34（悬停看赠金明细） |
打开 Platform 用量页 |
| 未登录 | Sign in |
— |
| 查询失败 | Unavailable |
重试 |
| 首次加载 | Balance… |
— |
任意状态下均可使用徽标旁的刷新按钮；若已有轮询在进行，点击刷新会取消并以强制读数重新开始。网络错误发生在已成功加载之后时，界面保留上次已知金额，而不是清空。
适用场景与注意¶
适合：已在 DSH 中登录 DeepSeek Platform 账户、希望在写 agent / 跑会话时快速扫一眼余额、必要时点开用量或充值页的用户。
注意：
- 插件以当前 DSH Host 进程权限运行，安装前请自行审阅 源码 与 MIT 许可证（
package.json版本 1.0.0）。 - SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；条目分类为「客户端」，星标以目录为准（当前为 0），不代表官方背书。
- 仅 API Key、无 Platform 登录态的场景下插件无法提供余额，这是账户模型限制，不是配置遗漏。
结尾¶
经过上面的步骤，你可以在 DSH 侧栏底部持续看到 Platform 剩余余额、赠金明细与刷新时间，减少反复打开用量页的切换成本。更多信息见 SkillHub 目录页 与 GitHub 仓库。
