@deepseek-ai/dsh-agent-budget/command

English | 中文

@deepseek-ai/dsh-agent-budget/command 为持久 agent（智能体）预算服务提供一条供用户直接使用的 /budget 命令。它不会启动模型轮次。命令输入和输出以不会呈现给模型的 command/run 和 command/done 事件记录，因此查看或增加预算不会改变模型提示词，也不会使可复用的前缀缓存失效。

本包组合会加载该命令，并禁用面向模型的预算工具。agent 只会经历准入结果：只要仍有额度，工作就会继续；硬上限耗尽后，系统会拒绝新的提供方调用，以及受保护且会启动资源的工具。

命令

Token 参数以百万 Token 为单位，因为一棵 agent 树可以合理地消耗数百万 Token。

命令	结果
/budget	显示已用、已预留、总额、剩余额度、截止时间、状态和核算准确性
/budget set 3	创建默认的全树硬上限，额度为 3,000,000 Token
/budget set 0.5 session soft 30m	创建会话范围的 500,000 Token 上限，截止时间为 30 分钟
/budget add 1	向现有账户追加 1,000,000 Token
/budget extend 2h	将现有截止时间延长 2 小时；如果已过期，则从当前时刻起算

Token 小数最多保留 6 位，因此 /budget add 0.000001 会精确追加 1 Token。时长支持 ms、s、m 或 h。

只有账户所属的实时 agent 精确实例才能增加 Token 或延长时间。子 agent 可以从继承的树账户消耗额度并查看该账户，但不能追加额度。追加额度可以恢复已耗尽或已过期的账户，但绝不会清除 uncertain 用量。

组合方式

请在 @deepseek-ai/dsh-agent-budget 和共享命令服务之后加载该命令。

- name: '@deepseek-ai/dsh-agent-budget'
  config:
    fallbackMaxOutputTokens: 8192
    guardedToolNames: [subagent, subagent_fork, workflow, ralph]
    modelTools: false
    managementCommandName: budget
- name: '@deepseek-ai/dsh-agent-budget/command'
  config:
    defaultScope: tree
    defaultEnforcement: hard

defaultScope 控制 /budget set <million-tokens> 简写形式的范围。defaultEnforcement 决定系统是记录超额（soft），还是拒绝新工作（hard）。

managementCommandName: budget 告知预算服务，该组合确实提供 /budget，因此硬准入错误可以包含有效的恢复指引。未包含该命令的组合应当省略此配置。

该命令依赖 Host 提供的已认证命令来源。它不是模型工具，也不是独立的 HTTP 或浏览器 API。

模型体验

人类 /budget 控制

模型看到的内容

什么都看不到。/budget 通过已认证的人类命令路径运行，只记录不会呈现给模型的命令事件。本包组合还会禁用可选的预算模型工具。

Token 影响

该命令不会向模型请求添加工具 schema、提示词或对话消息。结果对用户可见，但不消耗模型 Token。

KV Cache 影响

查看或增加预算不会改变可复用的提示词前缀。准入检查在模型请求之外读取持久账本。

已知限制与暂缓事项

• 现有账户只能增加额度或延长时间。尚未实现降低额度、替换、重置、关闭或对账不确定用量。
• 命令运行后会显示当前的持久账户，但不会在对话中持续流式更新计数器。
• 只有提供人类命令适配器的应用才会暴露 /budget。