前言¶
在 DeepSeek Harness（DSH）的 composer dock 中，内置的 token 和 cache pill 已经能展示用量，但账户余额与本次会话花费目前没有直观的展示位置。频繁切换页面或刷新会话时，容易错过余额变化或超支风险。dsh-balance-indicator 旨在在 dock 中直接呈现账户余额和会话花费，方便在对话过程中随时掌握资金状态。
是什么¶
dsh-balance-indicator 是一个 DeepSeek Harness 客户端插件，由 IamrrrED 维护。它在 composer dock 中与内置的 token/cache pill 并列，显示账户余额（包括多币种）以及当前会话的花费情况。
核心功能¶
- 在 composer dock 中渲染余额与会话花费行，与内置 pill 并列
- 支持多币种余额显示，货币顺序与对齐由插件控制
- 会话花费基于“首次成功读取”与当前余额的差值计算，基准线按钱包（group:currency）在 sessionStorage 中保持，刷新页面不重置
- 提供手动刷新（↻）按钮，以及充值链接（[Top up]）
- 负余额以“符号前减号”形式显示（例如 -$0.010），零值显示为 0.000（阈值由小数位数决定）
- 货币符号来自本地映射（CNY → ¥, USD → $），缺失则显示货币代码
- 行为零值处理：余额四舍五入后若为 0.000，则不显示该货币的列；多币种中最大的零值会显示为 0.000
- 自动刷新间隔为 15 秒，不随对话轮次触发；同一时间只允许一个请求，避免请求堆积
安装与启用¶
GitHub 仓库未提供官方安装命令，请从仓库页面获取并使用本地或项目指定的方式安装。安装前建议检查源码与许可证（MIT）。
典型用法¶
- 安装后，在 DSH 界面的 composer dock 中即可看到“余额行”与内置 pill 并列
- 点击 ↻ 可强制刷新余额与会话花费
- 点击 [Top up] 会打开充值页面（链接来源见下方说明）
适用场景与注意¶
- 适合需要在对话过程中实时关注账户余额与会话花费的开发者
- 插件以客户端权限运行，请确保信任来源，安装前检查源码与许可证
- 插件依赖 DSH 的 remote.account.getBalance 服务，需在 DSH 进程中正确声明命名空间服务（示例见下）
技术细节¶
- 使用 slot
conversation.composer.dock注入 - Spec:
remote.account.getBalance - 在客户端插件中需正确声明注入依赖，示例：
const inject = ['slots', 'remote', 'remote.account', 'locale']
- 基准线以
sessionStorage中的topped:CNY、granted:USD等键按钱包保存，确保页面刷新后仍延续会话花费 - 自动刷新不依赖对话轮次，避免长时间对话导致数据陈旧；请求超时为 20 秒，间隔为 15 秒，自动避免重叠请求
结语¶
dsh-balance-indicator 在 DSH 的 composer dock 中为账户余额与会话花费提供了直观的展示，适合需要在对话过程中持续监控资金状态的用户。更多信息请参见：
- 仓库：https://github.com/IamrrrED/dsh-balance-indicator
- 目录页：https://www.skillhub.cn/plugins/IamrrrED/dsh-balance-indicator
