遇阻与恢复
Driver 的设计哲学是:能修的自己修,修不了的明确停。停下不是故障,而是把决定权交还给你。本页帮你快速判断「为什么停」与「下一步做什么」。
启动阶段常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 驱动按钮灰禁,提示「提案正在填写中」 | 内容就绪门:proposal.md / tasks.md 仍是模板空壳 | 等 Agent 填写完提案;或人工补齐后按钮自动恢复 |
| 弹窗中「确认启动」不可点 | 没有已打开的 Agent 会话 | 点「打开一个 Agent」,Driver 不使用无头会话 |
| 无法启用多 Agent Review | 已打开的 Agent 少于 2 个,或评审 Agent 与主 Agent 相同 | 再打开一个不同类型 / 会话的 Agent |
| 提示已有驱动在运行(driver-already-active) | 同项目同一时刻只允许一个活跃驱动 | 等待完成,或在控制行停止当前驱动 |
| 多模块项目无法启动 | 未选择目标模块 | 在面板先选定要驱动的模块 |
停因五分类
驱动中途停下时,面板横幅会给出停止原因。按类别对应的恢复动作:
| 类别 | 典型停因 | 恢复动作 |
|---|---|---|
| 🟡 人类确认门 | 半自动模式下的各道门(合并授权、部署、smoke、归档);全自动模式下这些门由 standing 授权自动放行,通常不会在此停下 | 审阅后点「确认放行」,流程继续 |
| 🔴 未绿代码硬红线 | loop-exhausted:修复轮次耗尽仍未通过测试 | 只有「接管修代码」或「中止」两个选项——接管后人工修复,测试变绿再继续;任何模式(含全自动)都不会自动放行未绿代码 |
| 🔴 Agent 会话异常 | Agent 标签被关闭、会话失联、完成握手超时 | 重新打开 Agent,点接管重启;看门狗已排除误判,真停即真异常 |
| 🔴 命令执行失败 | verify / smoke / 部署命令非零退出且自愈轮次耗尽 | 查看时间线中的失败摘要,人工修复后接管重启 |
| 🔴 流程配置问题 | Overlay 配置不合法、门禁定义冲突 | 打开流程配置编辑器修正,校验通过后重启驱动 |
blocked 驻留态的三个控件
驱动停在 blocked 时,面板常驻三个操作:
- 横幅 — 停因的人话描述与发生阶段;
- 停止 — 结束本次驱动运行(提案状态保留,可稍后重启);
- 接管重启 — 以当前状态为起点重新驱动;已完成的阶段不会重跑(完成判据以产物为准)。
评审门相关
- 评审驳回不是停止:Driver 会自动派主 Agent 处置意见并交复审,只有轮次耗尽且冲突策略为「停下让我裁决」时才停;
- 评审收敛前归档入口显示「等待评审收敛」,属正常持锁状态;
- 想复盘评审过程:生命周期日志页展开对应轮次的「评审原文 / 处置原文」。
还是判断不了?
打开提案生命周期日志页看结论横幅与时间线——每次停止都有明确的停因记录与发生位置。把结论横幅内容发给团队或社区,是最高效的求助方式。