前言¶
在长时间运行的智能体任务中，账户余额往往会在模型还在正常工作时被耗尽。这类失败通常不会表现为突发中断，而是模型持续工作直到无法支付下一次请求。AI查余额（dsh-your-balance）是 DeepSeek Harness 的一个插件，它让模型在执行过程中能看到当前账户余额，提供 check_balance 工具，在每个步骤后注入余额快照，并将配置的阈值转化为具体的输出预算和停止策略。
插件定位¶
AI查余额是一个独立的 DeepSeek Harness 插件，由维护者 LzdqesjG 开发。它不属于 DeepSeek 官方产品，旨在解决智能体长时间运行时因余额不足而静默失败的问题。
核心功能¶
1. check_balance 工具¶
插件注册了一个 check_balance 代理工具，调用 Host 的可选 deepseekAccount 服务，返回充值钱包、赠送钱包、按币种的汇总，以及主币种的可用总额和当前状态（ok / low / critical）。
如果用户未登录、仅使用 API Key，或者平台端点不可用，工具会返回明确的“不可读”结果，而不是伪造零值。
示例输出：
AI查余额：查询结果
状态：充足
主币种：CNY
可用合计：CNY 10.7562
钱包明细：
- CNY：充值 3.0838；赠送 7.6723；合计 10.7562
2. 每步余额快照¶
插件在 Host 注册了 agent/pre-step 监听器。当开启自动注入时，每次用户消息或工具执行后，会追加一条带来源的用户角色上下文消息：
【AI查余额 · 自动余额快照】
状态：充足
主币种：CNY；可用合计：CNY 10.7562
钱包：
- CNY：充值 3.0838；赠送 7.6723；合计 10.7562
阈值：较低 2.5 CNY / 0.3472 USD / 0.2976 EUR；严重不足 0.25 CNY / 0.0347 USD / 0.0298 EUR。
本币种判定：低于 2.5 CNY 进入省电模式；低于 0.25 CNY 视为严重不足。
采样时间：2026-10-23T23:58:31.855Z
快照是持久会话历史的一部分，不是 transient UI 装饰。为避免重复调用平台，10 秒缓存适用于多工具回合。
3. 策略提示¶
自动注入开启时，系统提示中会包含一个策略说明，明确模型在不同余额级别下的行为：
| 级别 | 行为 |
|---|---|
ok |
正常工作。 |
low |
进入省电模式：答案简洁，工具调用最少，不添加填充内容。 |
critical |
停止 productive 工作。先写入/更新 GOAL.md，保存可恢复状态，然后回复一条简短的充值消息并停止本回合。 |
unknown |
不要猜测余额；在需要时重试 check_balance。 |
当用户回合恢复余额后，会被告知阅读 GOAL.md 并从保存状态继续。
4. 设置与阈值¶
在 Settings → AI查余额 页面可配置：
- 自动注入余额：开关。关闭时工具仍然可用，但不会注入快照或策略提示。
- 低余额阈值：CNY / USD / EUR。
- 严重不足阈值：CNY / USD / EUR。
- 汇率关联转换：开启后，修改一种币种会根据内置参考汇率计算其他两种币种。
- 实时余额预览：钱包明细、主币种总额、当前状态徽章、刷新与保存反馈。
默认阈值：
| 级别 | CNY | USD | EUR |
|---|---|---|---|
| Low | 1.50 | 0.25 | 0.20 |
| Critical | 0.25 | 0.05 | 0.045 |
内置参考汇率：1 USD = 7.2 CNY，1 EUR = 8.4 CNY。插件会计算主币种（转换后总额最高的币种）并使用该币种的阈值进行判定。
设置保存在 $DSH_HOME/your-balance/config.json。未设置 DSH_HOME 时使用 ~/.dsh。写入操作为原子（临时文件 + 重命名）。
安装与启用¶
从 GitHub 安装：
dsh plugin --profile <profile> add github:LzdqesjG/dsh-your-balance
从本地检出安装：
dsh plugin --profile <profile> add /absolute/path/to/dsh-your-balance
或使用 DSH 插件管理器，将目录作为 bundle 安装。
安装后刷新 Web 页面，打开 Settings → AI查余额 进行配置。
典型用法¶
- 安装插件后，在 Settings 中开启“自动注入余额”，调整低余额和严重不足阈值。
- 在对话中，模型会在每步后收到带状态的余额快照。
- 当余额进入
low状态，模型会自动进入省电模式，减少输出和工具调用。 - 当余额进入
critical状态，模型会写入GOAL.md并回复一条充值消息，停止 productive 工作。 - 余额恢复后，新回合会被告知阅读
GOAL.md并继续。
适用场景与注意¶
适合需要长时间运行、多步骤协作的智能体场景，尤其是对成本敏感的项目。
注意事项：
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- DeepSeek 平台账户 API 目前仅暴露 CNY 和 USD 钱包；EUR 阈值用于转换和展示，如出现 EUR 钱包将启用。
- 策略是模型引导，不是硬预算执行层；模型仍可选择不遵循。
- 自动注入会在每个符合条件的步骤增加 token，如上下文成本高于收益可关闭。
总结¶
AI查余额通过工具、快照和策略提示，将余额状态显式地纳入模型的上下文，使其在余额充足时正常工作，在余额不足时主动切换行为或停止 productive 工作，避免静默失败。配置简单，本地持久化，不涉及账号凭证或平台 API 密钥的存储。
- 目录页：https://www.skillhub.cn/plugins/LzdqesjG/dsh-your-balance
- GitHub：https://github.com/LzdqesjG/dsh-your-balance
