前言¶
在 DeepSeek Harness（DSH）的 Web 界面里长时间跑对话或调试智能体时，充值余额和赠金往往要进 Settings → Account 才能看到。若你希望在主界面里随时掌握钱包合计，而不打断当前工作流，社区插件 dsh-balance-badge 把已登录账户的「充值 + 赠金」合计钉在侧栏底部，与设置入口相邻，始终可见。
下面介绍该插件的定位、能力与安装方式。事实以 GitHub 仓库 README 为准。
这是什么¶
dsh-balance-badge 由维护者 lxy7747-hash 发布，分类为客户端插件，面向带 Web UI 的 DSH 环境。它通过 Harness 内置的 account Remote 读取与 Settings → Account 相同来源的余额数据，在侧栏底部（Settings 上方）展示合计金额；不自行存储凭证、不上报遥测，除账户查询外不发起额外请求。
核心功能¶
- 合计展示：将充值余额与赠金余额合并为一行，例如
余额 ¥114.41。 - 悬停详情：鼠标悬停可看到合计、充值余额、赠金余额的拆分，以及最近一次刷新时间。
- 刷新策略：点击可立即刷新；此外每两分钟自动刷新，窗口重新获得焦点时也会刷新。
- 侧栏收起：侧栏折叠时变为 36×36 的
¥按钮，合计金额出现在 tooltip 中。 - 状态文案：未登录显示「登录后查看」/「Sign in to view」；读取失败显示「读取失败」/「Unavailable」，再次点击可重试。
- 语言：中英文界面文案随 Harness UI 语言切换。
实现上，client.js 以 Harness 模块加载器格式注册到 sidebar.footer.action 插槽，调用 ctx.remote.account.getBalance(...) 并传入 UI 语言与时区偏移；index.js 为空的宿主侧，cordis.patch.yml 负责插入插件行。许可证为 MIT（README）；package.json 中版本为 1.0.0。
安装与启用¶
在 Plugins → Add plugin 中填写 Git 地址：
https://github.com/lxy7747-hash/dsh-balance-badge
若对某一 profile 使用 shell 安装（桌面应用的 desktop profile 由应用管理，CLI 插件命令会被拒绝）：
dsh plugin --profile web add github:lxy7747-hash/dsh-balance-badge
安装后在 Plugins 中启用即可。无需构建步骤，无额外依赖。
典型用法¶
- 确认 DSH Web UI 版本为 0.2.1 或更高，且已挂载 account Remote（Web 应用默认提供）。
- 在 Harness Web 中登录 DeepSeek 账户（插件展示的是账户钱包，而非开放平台 API Key 余额）。
- 启用插件后，在侧栏底部查看合计；需要明细时悬停，需要最新数据时点击或等待自动/焦点刷新。
适用场景与注意¶
适合：经常在 DSH Web 里开发或调试、希望余额与主界面同屏、又不想离开当前会话去设置页的用户。
注意：
- 插件以当前 DSH 进程权限运行；安装前请自行查看源码与 MIT 许可证，确认符合你的安全与合规要求。
- 依赖已登录的 DeepSeek 账户与 Web 侧的 account Remote；未满足要求时只会显示对应提示，不会替代登录流程。
- 社区插件目录 SkillHub 条目 为独立生态站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-balance-badge 把账户钱包合计固定在 Web 侧栏底部，交互简单：看合计、悬停看拆分、点击刷新。若你需要在 Harness 里少切一层设置页，可按上文命令安装并在 Plugins 中启用。
- 目录页：https://www.skillhub.cn/plugins/lxy7747-hash/dsh-balance-badge
- GitHub：https://github.com/lxy7747-hash/dsh-balance-badge
