前言¶

DeepSeek Harness（DSH）把对话、设置和插件管理放在同一套 Web UI 里。要查账号余额，默认路径往往是进入 Account 设置页，侧栏在首页、对话页之间切换时也不会一直带着余额信息。若你经常在 DSH 里长时间开发或调试，需要随时确认余额、并在余额不足时尽快充值，来回切页面既打断节奏，也容易漏看。

下面介绍的 dsh-account-balance-badge 是社区维护的 DSH 客户端插件：在左侧边栏底部（Settings 上方、内置 Cordis 插件行下方）常驻一行余额，并提供应用内充值入口。插件托管在 GitHub，尚未上架 npm；社区目录页见 SkillHub 插件页，源码与安装说明以 NebulaXIX/dsh-account-balance-badge 为准。

这是什么¶

dsh-account-balance-badge 由 NebulaXIX 维护，当前 package 版本为 0.2.0，许可证 MIT。分类上属于 DSH 客户端插件：纯 JavaScript、无依赖、无构建步骤，通过 Cordis patch 把一行 UI 挂到侧栏 footer，在首页、设置、对话等视图下都保持可见，而不是藏在 Account 设置里。

它解决两件事：一是把已登录 DeepSeek 账号的余额（含充值钱包与赠金展示）固定在侧栏；二是在 Desktop 应用内一键打开官方充值页，返回后自动重新读取余额。纯浏览器 Web UI 则会在新标签页打开同一充值 URL。

核心功能¶

侧栏常驻与展示规则¶

• 在侧栏 footer 占满宽度的一行，位于 Settings 之上，随界面切换保持可见。
• 通过 Host 账号服务、经 Client Remote 的 account.getBalance 拉取数据；页面侧只收到钱包金额与格式化字符串，原始账号凭证不会进入浏览器。
• 按平台规则格式化货币：CNY 用 ¥、USD 用 $，两位小数与千分位；低于一分显示为 <¥0.01。若有正数赠金，会以小号 Bonus ¥x.xx 附注。
• 未登录时显示本地化「已登出」状态，充值按钮禁用；加载中、可重试失败等状态就地展示，不会伪造零余额。

刷新策略¶

首次挂载读一次；页面可见时每 60 秒刷新；窗口重新获得焦点、点击该行、从充值页返回时也会刷新。并发请求会去重。

充值（Top up / 充值）¶

• Desktop：通过 preload 的 dshPlatform 桥，在应用内原生 Platform 视图打开官方 DeepSeek 充值页，顶部有「Back to DeepSeek Harness」返回条；返回后重新读余额。
• 纯 Web UI：同一充值 URL 在新标签页打开。
• 充值页本身由 Desktop 持有 Platform 会话渲染，插件只负责返回条与视口矩形（open / setBounds / close）；加载失败时返回条仍可用，带本地化错误与 Retry，Esc 也可返回。

界面与主题¶

中英文文案随 DSH 界面语言切换；颜色使用宿主主题 token，浅色、深色以及侧栏收折为 36 px 窄轨时均可工作。宽侧栏时行高约 42 px，收折时以图标紧凑展示，无障碍名称与 tooltip 仍携带金额。Windows Desktop 在侧栏收折时会隐藏整个 footer（与 Settings、Cordis 行一致），此时余额行也会隐藏。

环境与要求¶

• DSH 版本：>=0.2.1-rc.2 <0.3.0-0（README 注明在 0.2.1-rc.2 上验证过）。
• 需要 profile 管理的 DSH 安装（Desktop 应用，或带 profile 启动的 dsh web），并启用随 Web UI 分发的插件（侧栏、locale、账号控制器为标准 Web 应用的一部分）。
• 应用内充值依赖 Desktop 应用；纯浏览器构建不支持内嵌原生视图。
• Node >=20（见 package.json engines）。

安装与启用¶

插件未发布到 npm，请用 Git 地址、Release tarball 或本地路径安装。Desktop 应用的 profile 由应用自行管理，仅支持在 Web UI 的 Plugins 里安装。

在 DSH Web UI 中安装（推荐）¶

1. 在左侧边栏进入 Plugins。
2. 点击 Add plugin（或箭头 → Install a third-party plugin）。
3. 填写其一：
   - Git：github:NebulaXIX/dsh-account-balance-badge（跟踪 main），或 github:NebulaXIX/dsh-account-balance-badge#v0.2.0 固定版本
   - Release 包：本机 dsh-account-balance-badge-0.2.0.tgz 的绝对路径
   - 本地 checkout 的绝对路径
4. 点击 Install。
5. 安装完成后选择 Enable now；若 profile 支持 HMR 会立即重组，否则重启 DSH。余额行出现在侧栏 footer。

macOS 分步说明见仓库内 docs/INSTALL-macOS.md 与 docs/INSTALL-macOS.en.md。

使用 dsh CLI¶

需已安装 dsh CLI 与 pnpm，且至少启动过一次 DSH 以便目标 profile 存在。--profile 必填；desktop 保留给 Desktop 应用，CLI 示例使用 web profile：

# Git，跟踪 main
dsh plugin --profile web add github:NebulaXIX/dsh-account-balance-badge

# Git，固定 v0.2.0
dsh plugin --profile web add "github:NebulaXIX/dsh-account-balance-badge#v0.2.0"

# GitHub Release 附带的 tarball
dsh plugin --profile web add ./dsh-account-balance-badge-0.2.0.tgz

# 本地 checkout（CLI 下相对路径相对于当前工作目录）
dsh plugin --profile web add ./path/to/dsh-account-balance-badge

dsh plugin ... add 会把 bundle 写入 profile 列表，无需手改 patch。在 npm 正式发布前，不要使用 dsh plugin ... add dsh-account-balance-badge（仅包名）这种方式。

更新与卸载¶

第三方插件通过卸载再安装新版本升级。CLI 示例：

dsh plugin --profile web remove dsh-account-balance-badge
dsh plugin --profile web add "github:NebulaXIX/dsh-account-balance-badge#v<new-version>"

Web UI 可在 bundle 页 Uninstall 后重新安装。

典型用法¶

安装并启用后，无需额外配置文件：

1. 查看侧栏 footer 的钱包图标、本地化标签与当前余额（多钱包时按接口返回全部展示）。
2. 点击整行可手动刷新（另会自动按上文策略刷新）。
3. 登录状态下点击金额旁的 Top up（充值）：Desktop 内嵌官方充值页，Web 则新开标签；充值返回后余额会再读一次。
4. 侧栏收折时可通过 tooltip / 无障碍名称查看金额（Windows Desktop 收折 footer 隐藏时除外）。

实现概要（便于审源码）¶

适用场景与注意¶

适合谁： 长期在 DSH Desktop 或 profile 化 Web UI 中使用 DeepSeek、需要侧栏一眼看到余额并快速官方充值的开发者或重度用户。

安装前请自行核对： 插件以当前 DSH 进程权限运行，会调用账号服务的余额接口并在 Desktop 上触发 Platform 充值视图。安装前应阅读 仓库源码 与 MIT 许可证，确认符合你的安全与合规要求。DSH 社区目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。

局限： 未登录无法显示金额；纯浏览器无应用内充值；DSH 版本须落在 >=0.2.1-rc.2 <0.3.0-0 区间内。

结尾¶

dsh-account-balance-badge 把 DeepSeek 账号余额从设置页里「拎」到侧栏 footer，并尽量在 Desktop 内完成官方充值闭环，减少切页和漏看余额的情况。若你要安装或跟进版本，请以 README 为准：

• 社区目录：https://www.skillhub.cn/plugins/NebulaXIX/dsh-account-balance-badge
• GitHub：https://github.com/NebulaXIX/dsh-account-balance-badge
• 最新 Release：https://github.com/NebulaXIX/dsh-account-balance-badge/releases/latest