前言¶
在 DeepSeek Harness（DSH）桌面端里开发或日常使用，往往需要留意官方账号的充值余额和用量。常见做法是切到浏览器打开官网，或依赖记忆里的上次查询结果，打断当前工作流。DSH 生态里插件可以扩展客户端 UI；dsh-balance-bar 由社区维护者 fegnze 发布，属于客户端类插件，在原生侧栏账号入口上方增加一条余额栏，并支持在 DSH 内嵌打开官方用量页，而不替换原有账号入口、不改核心代码。
下面按定位、行为、安装与注意点说明该插件，事实以 GitHub 仓库 README 与 package.json 为准。社区目录页见 SkillHub：fegnze/dsh-balance-bar；该站点为独立社区目录，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-balance-bar（npm 包名 dsh-balance-bar，当前版本 0.1.2，MIT 许可证）是社区桌面插件，不是 DeepSeek 官方产品。它占用 DSH 原生 sidebar.footer.action 插槽，在现有账号入口上方显示余额；不注入额外定位 DOM，也不启动独立服务。
peer 依赖与引擎要求 DSH 为 0.2.0-rc.2 或 0.2.1-rc.2；README 写明在 DSH 0.2.0-rc.2 桌面上已验证余额栏与内嵌官方用量页。无需 API Key，使用当前已登录 DSH 的官方账号。
核心功能¶
余额展示与刷新¶
- Host 通过
deepseekAccount.getBalance()与当前登录态取数，不读取凭据，也不把凭据传给前端。 - 前端约每 10 秒读一次；Host 按需向上游查询，最短间隔 30 秒，并发请求会合并。页面隐藏时暂停轮询，窗口回到前台时再查，仍遵守缓存间隔；不是服务端实时推送。
- 充值余额与赠送余额不相加：主栏显示充值余额；tooltip 显示赠送余额与更新时间。钱包为空时显示
—，不伪造 0 余额。 - 侧栏折叠时余额栏隐藏，原账号入口仍可点击。
点击打开用量页¶
点击余额栏时，与原生按钮相同，经 globalThis.dshPlatform.open('usage', bounds) 在 DSH 内嵌官方用量页，不打开外部浏览器。插件提供返回按钮、视口尺寸同步与关闭清理；凭据仍由原生桥接管理。桌面桥接不可用或账号未登录时，入口禁用；该桥接依赖当前桌面版本，升级后需重新确认。
账号切换与失败态¶
Host 监听账号变化并清空缓存，用 generation 丢弃切换前仍在途的响应；登出后最迟在下一次成功读取时反映到前端。网络失败会清空前端金额；上游 Host 失败则保留旧金额并标明显式过期指示。
本地 API 与安全边界¶
本地路由 /myspace-balance-bar/api 仅允许 loopback、合法 Host、同源 Origin/Fetch Metadata 及自定义请求头；仅支持本地浏览器，不提供 CORS。插件不收集账号凭据、不上传余额、不提供充值操作。
卸载插件时会清理请求、订阅、定时器、样式与注册项；上游服务不接受取消参数，已发起的请求只能在完成后丢弃结果。
安装与启用¶
通过 DSH 插件管理器 安装 npm 包 dsh-balance-bar。仅需当前 DSH 已登录的官方账号，不要在 Web profile 安装，仅支持桌面 profile。
安装前请禁用或卸载旧本地包 myspace-dsh-balance-bar，二者共用路由与插槽标识，不可同时启用。包内已带原生 ModuleLoader Client，无需构建。升级后建议重启 DSH，避免 Host 模块缓存仍跑旧代码。
开发时可使用 link 指向本地绝对路径，例如：
link:/absolute/path/to/dsh-balance-bar
禁用该 bundle 后余额栏即消失。
典型用法¶
日常使用无需额外配置：安装并启用后，在侧栏账号入口上方即可看到余额栏；悬停可看赠送余额与更新时间；点击栏位在 DSH 内打开官方用量页。
仓库提供的校验命令（用于开发或贡献者自测）：
npm test
node --check src/client.js
测试覆盖余额缓存、请求合并、失败态、登出与账号切换、卸载时丢弃在途响应、请求来源校验等；README 说明验收测试不会把用户登出。
适用场景与注意¶
适合：长期在 DSH 0.2.0-rc.2 / 0.2.1-rc.2 桌面端工作、希望侧栏一眼看到充值余额、并希望在应用内查看官方用量统计的用户或智能体开发者。
务必知晓：
- 插件以当前 DSH 进程权限运行；安装前请自行查看源码与 MIT 许可证，确认接受其行为。
- 余额为轮询，非实时推送；官方用量页上的统计也可能有延迟。
- 内嵌页依赖当前桌面桥接，普通浏览器环境不支持同等导航。
- 加载态仅显示居中 spinner，无说明文字；系统偏好减少动效时 spinner 不旋转。
engines要求 Node>=22。
结尾¶
dsh-balance-bar 在不大改 DSH 的前提下，把官方账号充值余额和用量查询接到侧栏与内嵌页，适合需要少切窗口的桌面用户。目录与讨论入口：SkillHub 插件页、GitHub：fegnze/dsh-balance-bar（问题与源码）。
