前言¶

在 DeepSeek Harness（DSH）里查余额，默认路径是打开 设置 → 账号与余额。写 agent、调模型或长时间挂着会话时，如果只想确认钱包还剩多少，每次进设置页会打断当前操作。社区插件 dsh-show-balance 把余额嵌进对话区底部 dock：一格数字常驻状态栏，点开可看充值、赠金与合计，数据来源与官方账号页一致。

下面介绍插件定位、显示逻辑、安装启用方式，以及使用时需要注意的权限与版本前提。

这是什么¶

dsh-show-balance 由 stefanohe（Stefano’s AI Lab）维护，npm 包名同为 dsh-show-balance，在 SkillHub 目录中归类为客户端插件。README 标明适用于 deepseek-harness-v0.2.0-rc.2；当前发布版本为 0.2.0-rc.2（MIT 许可证）。

一句话：在浏览器 UI 的 conversation.composer.dock 插槽增加一个格子，展示已登录账号的钱包余额；未登录或读数失败时不渲染任何内容，避免展示过期或凭空数字。

核心功能¶

状态栏格子¶

• 位置：内置「会话统计」条目的左侧；若已安装输入统计类插件（README 中的 prefill-speed cell），则显示在该格子的左侧。
• 内容：钱包余额，保留两位小数（不展示 Platform 的完整精度）。
• 交互：单击格子在上方弹出面板（portal 挂到 body）；Escape、点击面板外或再次单击格子可关闭。

弹出面板中的行¶

多币种账号：按币种分别汇总，用 + 连接（例如 10.00 CNY + 1.00 USD），不做汇率换算。没有赠金钱包时，面板只显示充值一行；赠金为 0.00 仍会显示（与出货账号页隐藏零赠金的行为不同）。

单位随 UI 语言变化：CNY 在英文界面为 CNY，中文为 元；其他币种保留 ISO 代码。切换界面语言后即时生效，无需重装。

数据从哪来¶

与 设置 → 账号与余额 相同链路：ctx.get('remote.account') → getBalance(metadata)。浏览器不发送凭据，由 Host 附上已保存的授权；余额约 每 30 秒 重新读取。未登录或读取失败时返回 null，格子不显示内容。

安装与启用¶

插件面向 DSH 的 desktop profile，目录为 <DSH 主目录>/profiles/desktop。README 建议使用 pnpm 11.7.0。

若尚未安装 pnpm：

npm install -g pnpm@11.7.0

方式 A：从 npm 安装¶

在对应 profile 目录执行（或通过 设置 → 插件 / agent 的 plugin_manager 工具安装）：

pnpm add dsh-show-balance

DeepSeek Harness 使用默认主目录时：

cd "$env:USERPROFILE\.dsh\profiles\desktop" ; pnpm add dsh-show-balance     # Windows
cd ~/.dsh/profiles/desktop ; pnpm add dsh-show-balance                      # macOS / Linux

确认该 profile 的 package.json 里 dsh.profile.bundles 已包含包名（经插件管理器安装时会自动写入）。

方式 B：从仓库脚本安装¶

适用于源码、离线或 npm 未提供的版本。在仓库根目录执行：

pwsh -File .\install.ps1               # Windows
sh ./install.sh                        # macOS / Linux
pwsh -File .\install.ps1 -From npm     # 安装 npm 已发布包

脚本会完成依赖与 manifest 写入（并备份所改文件），并提示后续步骤。

启用（两种方式共通）¶

1. 完全重启 DSH 应用——浏览器 bundle 在启动组合时快照，仅刷新页面不够。
2. 在左侧插件面板中将 dsh-show-balance 开关打开。

典型用法¶

安装并启用后，登录 DeepSeek 账号即可在对话区底部 dock 看到余额格。需要区分充值与赠金时，单击格子查看三行明细（有赠金时）或仅充值一行（无赠金时）。长时间开着 Harness 时，数字会按约 30 秒间隔自动刷新，无需手动进设置页。

未登录状态下格子为空，属预期行为。

适用场景与注意¶

适合谁：经常在 DSH 桌面端写 prompt、跑 agent，希望在 composer 旁一眼看到余额、且要与官方账号页数字一致的用户。

实现边界（README Notes）：

• 非官方插件，仅使用公开接口（account Remote 与 dock 插槽）。
• 赠金不计入状态栏 headline，与出货账号页的「充值 / 赠金」拆分一致。
• 插件以当前 DSH 进程权限运行；安装前请自行查看 GitHub 源码 与 MIT 许可证，确认可接受后再启用。

包结构参考：index.js（Host Loader 行）、client.js（浏览器侧格子与取数）、cordis.patch.yml（宿主 patch）。

结尾¶

dsh-show-balance 把账号余额搬进状态栏，读数路径与官方账号页相同，并区分充值、赠金与合计。若你已在用 DSH v0.2.0-rc.2 系桌面 profile，可按上文 pnpm 或安装脚本接入，重启后在插件面板打开即可。

• 目录页：https://www.skillhub.cn/plugins/stefanohe/dsh-show-balance
• 仓库：https://github.com/stefanohe/dsh-show-balance