细化 Direct 租约重构规范与实施计划

补充操作准入、失败隔离与回合清理的目标行为更新重构里程碑及合同工作的范围边界新增租约简化实施顺序、验收场景与回滚计划
2026-10-04 04:34:01 +01:00
parent bee7ffcc07
commit 60282ae0fb
3 changed files with 131 additions and 10 deletions
@@ -159,6 +159,19 @@ UI 编辑器的“分析参考图”步骤、Rust 命令 `suggest_ui_design_sema
 - 原生执行控制的精确协议与许可持久化，在对应里程碑评审后落地；不得提前宣布这一项已完成。
 - 不修改 Provider 的 maxRetries；不减少引擎或任意代码执行的合法能力，不引入平行 Agent 框架，不改公开 API/数据库，不提交私密运行记录。

+### Direct 操作控制简化提案（2026-10-03，待实现）
+
+本节记录租约重构的目标行为；当前代码仍采用下节的执行租约与返修批次。实施范围与验收见[重构里程碑](../project-memory/plans/【里程碑】Direct合同与租约机制重构-2026-10-03.md)。本提案不改变 Codex 的工具调度、模型循环或图片工具的等待返回方式。
+
+- 普通操作开始前，宿主检查原回合是否活动、时间预算是否足够、并发容量是否可用，并执行原有权限、路径及资源约束。交付合同是否存在、前一个工具是否成功不构成普通操作的准入条件。
+- 操作成功、失败或取消后结算占用与用时，返回真实结果，由 Agent 决定后续操作。移除全局 Draining、执行/返修批次计数及对应重试门禁；验证输入变化只使相关证据失效，不使无关工作停顿。不新增租约到期续租、Agent 释放租约或独立后台任务接口。
+- 保留原时间预算数值与累计口径、并发上限及回合身份。回合关闭、取消或时间耗尽后拒绝新操作，取消自有在途工作并核实本地进程退出；等待资源锁后的写入及每次新增付费提交仍核验原回合权限。操作记录清除不能代替执行结束证明。
+- 普通工具失败和资源级结果不确定不终止整个回合；资源自身的幂等、operation ID、恢复及对账继续有效，不能因客户端取消而推断远端取消，也不能盲目重复付费。宿主控制状态损坏或无法确认自有执行器退出仍按实际控制失败处理。
+- 交付复核与操作准入分离。本次仅解除合同存在性的操作门禁；合同何时创建、验收项及视觉/玩法判据在合同工作中另行处理。`validation.maxRuns` 暂保留现有交付复核次数用途，不再用于执行/返修批次；时间配置不变。
+- 同回合重试或进程重启不刷新预算；仅保留预算、回合归属、必要退出记录和资源自身恢复所需的持久状态，不恢复旧租约为可执行权限。旧版本未结束状态须先确认旧执行器退出，不能通过直接删除账本解除控制。
+
+验收至少覆盖失败图片与长命令并存时无关写入成功、连续工具失败不触发返修次数限制、所有退出路径释放并发占用、关闭后零新增执行/付费提交、迟到写入被拒绝，以及远端不确定任务不重复提交。该提案尚无实现或运行时验收证据。
+
 ### 宿主验收与执行许可合同

 - 正式 GUI 和 CLI 的共同 Direct 回合入口建立宿主控制状态，绑定 canonical 项目路径、稳定 clientTurnId 和原始用户输入摘要；宿主私有目录保存权威账本并独占该回合，项目 `.agent` 仅允许保存展示副本。配置或项目侧文件被改写、工具切换、Provider 重试和进程重启不得刷新同一回合的预算。