步数预算提醒 randerous/dsh-turn-budget

dsh-turn-budget

面向 DeepSeek Harness 的可选步数预算收敛提醒。

可选的步数预算收敛提醒：当 agent 单轮超过配置的步数上限时，插件追加一条带来源归属的提醒，让模型收敛收尾。仅建议性质——绝不拒绝或改写步骤，因此不会死锁循环。默认组合不启用；通过 profile overlay 启用。

是 @deepseek-ai/dsh-turn-meta（每步元数据）的姊妹篇，guard 组里的第二个"第一个插件"式示例。

配置

- id: turn-budget
name: '@deepseek-ai/dsh-turn-budget'
config:
maxSteps: 12 # 可选单轮步数预算；默认 12 remindEvery: 4 # 可选超出后的提醒节奏；默认 4 enabled: true # 可选总开关；默认 true

maxSteps 与 remindEvery 必须是正整数；其他值导致插件加载失败。默认值下，第 13、17、21… 步各收到一次提醒。

提醒语义

插件以 { prepend: true } 前置一个 agent/pre-step 监听器并先委托下游。当前步数从持久化会话日志（turn/start + step/start）推导，因此跨恢复与重放。当推导步数超出 maxSteps 且超出量为 remindEvery 的倍数时，追加一条带来源的 UserMessage；拒绝或预算内步骤不记录。

每条提醒使用精确的 snapshot 来源 { kind: 'plugin', plugin: 'turn-budget', form: 'snapshot', sections: [{ name: 'turn-budget', text: }] }。./invariant 伴生插件校验该形状、将命名的步数与开放步数边界比对，并让任何"步数未超预算"的提醒失败。

模型体验

模型所见

每个超预算节奏点一行：

[turn-budget] turn= step= exceeds the -step budget. Wrap up the remaining work now: prefer one decisive action and finish the turn.

Token 影响

每个节奏点一行短文本，直到压缩将其遮蔽。

KV 缓存影响

无：提醒不携带后续准备步骤依赖的状态。

已知限制与待办

- 预算按轮计算，暂无按会话预算。可仿照 dsh-turn-meta 统计 prior_turns 的方式扫描 turn/start 计数实现。
- 提醒仅建议文本；硬性停止需要单独的 guard 策略。