前言¶
用 DeepSeek Harness（DSH）Desktop 写对话、跑 Agent 时，输入框下方状态栏里已有「轮/步」、token 用量、上下文占用等官方指标。账户里还剩多少充值或赠送额度，往往需要另开开放平台或账户页查看。社区维护者 MR-MaoJiu 的 dsh-account-balance（仓库 MR-MaoJiu/dsh-account-balance）在状态栏右侧增加余额徽章，交互方式与旁边官方三项一致：点一下展开详情。下面介绍它做什么、如何安装，以及使用时需要注意的限制。
这是什么¶
dsh-account-balance 是一个 DSH bundle 插件（Host 半边 + Client 半边），包名为 @local/account-balance，当前版本 1.0.0，MIT 许可。分类上属于客户端侧能力：只在 DSH Desktop（Web UI）的对话输入区状态栏渲染，不依赖额外 API Key，走 Harness 已登录账户的 ctx.remote.account 通道。
插件在 SkillHub 目录 可检索；社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
依据仓库 README，已核实能力如下。
状态栏与详情面板¶
- 挂载在
conversation.composer.dock（输入框下方 ambient 区域），id: account-balance、order: 2。 - 徽章显示实时余额；点击后与官方 pill 一样展开详情：合计、充值余额 / 赠送余额、更新时间、手动刷新、前往充值（跳转开放平台）；Esc 或点外部关闭。
刷新策略¶
- 挂载时拉取一次；之后每 60 秒刷新；页面切回前台立刻刷新；打开面板时若距上次超过 15 秒会补拉一次。
- 未使用
account.watch()长连接（避免额外授权）；因此「实时」精度受定时刷新与开放平台侧缓存影响，README 写明最慢约 60 秒。
展示与容错¶
- 多币种：CNY 为
¥、USD 为$，多币种用+连接；千分位、两位小数向下取整、<¥0.01与官方账户页一致。 - 状态：未登录显示「登录后查看余额」；接口失败显示「余额不可用」并给出原因，不拖垮整行状态栏。
- 主题与语言：样式使用 DSH 主题 token（
--dsw-alias-*）；中英文随界面语言切换。
安装与启用¶
前提：DSH Desktop（Web UI），且已在「设置 → 账户」登录。
本插件与其他本地 bundle 安装方式一致。README 给出的获取源码命令为：
git clone https://github.com/MR-MaoJiu/dsh-account-balance.git
随后在 Harness 左侧「插件 → 安装」中填入该目录的绝对路径；或由 Agent 调用 plugin_manager install_bundle，target 指向该目录。装完后刷新页面，状态栏右侧会出现余额徽章（Client bundle 在页面加载时装配）。
卸载：在「插件」页停用或移除 @local/account-balance，README 说明不会留下残余配置。
安装或更新后均需刷新页面；插件以当前 DSH 进程权限运行，安装前宜自行浏览源码与 MIT 许可证。
典型用法¶
安装并刷新后，无需额外配置项即可使用。
- 在对话界面输入框下方状态栏右侧查看余额摘要。
- 点击徽章打开详情，必要时点手动刷新或「前往充值」。
- 若显示「登录后查看余额」，先到「设置 → 账户」完成登录。
开发调试时，仓库无构建步骤，可直接改 client.js 后刷新页面；可用 README 中的检查命令校验语法：
node --check client.js index.js
node -e "JSON.parse(require('fs').readFileSync('package.json','utf8'))"
工作原理（简要）¶
| 方面 | 实现 |
|---|---|
| 数据 | Client 调用 ctx.remote.account.getBalance({ version, locale, timezoneOffsetSeconds })，对应 Host 的 deepseekAccount 服务 |
| 凭据 | 不读本地凭据文件，沿用 Harness 已登录通道 |
| 浮层 | createPortal 到 document.body，带视口 clamp，避免被 docked composer 裁剪 |
| 版本上报 | client.version 优先用 window.__DSH_BOOT__.release.version，取不到才退回插件版本 |
需要改刷新间隔时，可编辑 client.js 中的 REFRESH_INTERVAL_MS（README「自定义」节另有图标、布局、包名同步修改说明）。
适用场景与注意¶
适合：长期在 DSH Desktop 里对话或开发 Agent、希望一眼看到账户余额、又不想单独开账户页的用户。
不适合或尚未支持：
- DSH CLI：没有可用状态栏插槽，插件不会渲染。
- 余额推送：未实现变动推送；精度受 60 秒轮询与平台缓存限制。
- 验证范围：README 写明仅在 DSH Desktop / Web 上验证过。
结尾¶
dsh-account-balance 把 DeepSeek 账户余额放进对话状态栏，复用已有登录态，交互对齐官方状态 pill。获取与说明见 GitHub 仓库，目录页见 SkillHub。
