Paired: GitHub #311 ↔ GitCode #172

🚀 背景描述

要做什么:为 core 主循环新建运行预算机制,轮次与时间两个维度。两个维度同构(预算+临近收尾提示+到期终止+未配置零变化),合并为一个预算框架承接;时间维度需求来自 #190,经评审决定并入本特性。

当前现状(各分支均存在,非特定版本问题):

1. 轮次维:固定 5 轮硬顶。主循环以固定 5 轮为硬上限(遗留配置默认值同为 5),达到上限无论任务是否有实质进展都直接报错返回;循环不支持任务级保底轮次声明,也不在执行中跟踪进度,任务稳步推进也不会获得额外轮次。固定硬顶是复杂任务失败的第一大来源。
2. 时间维:没有墙钟总预算。一次主循环执行中,模型请求重试、流式响应读取与工具执行叠加,可使整次运行远超调用方预期;调用方只能在框架外设置任务级超时——既无法在截止前引导模型利用已有信息形成阶段性结论,也无法获知本次运行的剩余预算。

针对上述痛点引入:轮次维"保底轮次可配、有进展自动加时、停滞只提示、安全阀兜底";时间维"总预算可选、临近截止收尾、到期可识别终止"。

设计思路

按"痛点 → 机制"设计,两个维度共享同一预算框架(预算状态随单次执行隔离、提示同通道、终止同路径、事件同族):

划层与并存规则:

• overlay rail(ReplanRail、ProactiveConvergenceRail 等)的终止权优先:rail 判定终止时任务必须终止,预算机制不得以保底未用尽、自动延长或剩余时间预算为由推翻,也不抑制 rail 的停滞干预。
• autoharness 的会话级预算(时间/费用)是 CI 层 overlay,不管主循环单次执行,与本特性不重叠。
• 两维并存:独立计数/计时,任一维先触发即生效;时间到期是硬边界——若安全阀已进入收尾序列(指令已注入、交卷轮待执行)时时间预算到期,到期终止优先,交卷轮不再派发。两个维度的提示消息来源必须可区分。

涉及到的对外API

新增 YAML 配置项,只增量演进,不改既有轮数配置项的名称、默认值与语义:建议轮数(保底)、硬上限、检查点节奏参数、总时间预算、临近截止阈值。

干预通道复用既有对话引导消息注入,不发明旁路通道。单次模型请求的时限收紧经单次调用超时参数(超时分层 #171)接线,本特性消费该通道。

预算与进度事件对外可见:轮次维(保底生效/检查点评估/延长/停滞提示/安全阀触发与终止)与时间维(总预算生效/临近提示/到期终止含原因)均以事件或轨迹字段产出,供轨迹与监控消费。

测试设计与测试计划

• 轮次维:建议轮数声明与默认值兜底;保底内零干预;有进展自动延长与检查点间隔拉长;连续停滞提示注入且任务不被终止;安全阀收尾流程(指令注入、交卷轮、终止)顺序正确;存量显式上限任务硬截断不变;未声明新配置任务行为逐字节不变;rail 终止优先。
• 时间维:总预算生效且逐次执行隔离;到期后不再派发新工作;单次调用与重试等待时限按剩余预算收紧;临近截止提示仅一次且不污染后续会话;到期终止原因可识别、与取消可区分、同步流式一致、产出可读、在途工具尽力取消;两维并存互不抑制;时间到期优先于交卷轮。
• 计划:轮次维保底与兼容铁律先行 → 进度跟踪与停滞提示 → 安全阀 → 时间维预算与到期语义 → 两维并存回归。