前言¶
在 DeepSeek Harness（DSH）里长时间对话或跑任务时，账户里的充值余额和赠送余额会随调用消耗。若要在网页里核对，往往需要切到账户设置页，和当前 composer 的工作流是分开的。
dsh-token-balance 由社区维护者 feiniao1933 发布，归类为联网工具类插件。它在消息输入框下方的状态行（与上下文占用指示同一行）增加一枚余额胶囊，通过已登录账户的 Host Remote 拉取余额并定时刷新，无需自行配置 API Key。
这是什么¶
dsh-token-balance 是一个 DSH bundle 插件：Client 侧在 conversation.composer.dock 插槽渲染 UI；Host 侧仅通过 webserver/index-inject 下发刷新间隔配置。余额数据来自 ctx.get('remote.account').getBalance(...)，不读取、不保存、不外发 API Key。
当前 npm 包尚未发布，需从 GitHub 仓库安装。包版本为 1.0.1，许可证为 MIT。社区目录页：https://www.skillhub.cn/plugins/feiniao1933/dsh-token-balance；源码与说明：https://github.com/feiniao1933/dsh-token-balance。
核心功能¶
下面介绍插件在界面上提供的能力，均对应 README 中的说明。
- 显示账户可用总额（充值余额 + 赠送余额），并保持更新。
- 鼠标悬停可看明细：总额、充值余额、赠送余额、最后更新时间，以及刷新提示。
- 点击胶囊可立即刷新。
- 自动刷新时机：挂载时、默认每 30 秒、标签页重新可见或获得焦点时、当前会话一轮结束时。
- 未登录时显示「未登录」；读取失败显示「余额不可用」，并自动重试最多 3 次。
- 使用宿主主题变量，跟随明暗主题；内置中英文文案。
金额展示规则与账户设置页一致：截断到分，正的不足一分显示为 <¥0.01，多币种钱包用 + 连接。胶囊上是合计，悬停 tooltip 里分开列出。
安装与启用¶
npm 正式包尚未发布。先在终端用你的 profile 名称（下文示例为 web）从公开 Git 仓库安装：
dsh plugin --profile web add github:feiniao1933/dsh-token-balance
若希望安装结果可复现，可固定到某一提交：
dsh plugin --profile web add git+https://github.com/feiniao1933/dsh-token-balance.git#<commit>
将 <commit> 换成目标提交的 SHA。按宿主要求重启 DSH 或刷新页面后，在已登录 DeepSeek 账户的 Web 客户端 composer 下方应能看到余额胶囊。将来 npm 发布后，README 称也可使用：
dsh plugin --profile web add dsh-token-balance
包内声明了 dsh.bundle.patch，与 dsh plugin add 安装流程兼容。package.json 中 engines.dsh 要求 >=0.2.2-rc.1；README 记载在 macOS 上对 DSH 0.2.2-rc.1 做过测试。
配置¶
默认刷新间隔为 30 秒。若需调整，在对应 profile 的 cordis.patch.yml 中覆盖 token-balance 行：
- id: token-balance
config:
refreshIntervalMs: 30000 # 5000–3600000
refreshIntervalMs 取值范围为 5000–3600000 毫秒。修改后按你的部署方式重新加载配置或重启相关进程。
典型用法¶
安装并登录 DeepSeek 账户后，无需额外命令行操作：
- 在 composer 下方状态行查看总额胶囊。
- 悬停查看充值、赠送分项与更新时间。
- 需要即时数据时点击胶囊触发刷新。
插件不暴露独立的 HTTP 路由，也不增加运行时依赖；余额查询完全走 Host 已有的 account/getBalance Remote。
适用场景与注意¶
适合经常在 DSH Web 界面里对话、希望在同屏留意账户余额是否充足的开发者。不适合未使用 DSH、或不在 Web client 上使用 composer dock 的环境。
安装前建议通读仓库源码与 MIT 许可证。插件在当前 DSH 进程与已登录会话的权限下运行，会通过 Host Remote 访问账户余额接口；请确认这符合你对本机或部署环境的信任边界。社区插件目录（SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-token-balance 把 DeepSeek 账户余额收进 composer 状态行，减少切页核对的开销。安装与配置项以 README 为准；遇到问题可在 GitHub Issues 反馈。
