RunLogosRunLogos

遇阻与恢复

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 时,面板常驻三个操作:

  1. 横幅 — 停因的人话描述与发生阶段;
  2. 停止 — 结束本次驱动运行(提案状态保留,可稍后重启);
  3. 接管重启 — 以当前状态为起点重新驱动;已完成的阶段不会重跑(完成判据以产物为准)。

评审门相关

  • 评审驳回不是停止:Driver 会自动派主 Agent 处置意见并交复审,只有轮次耗尽且冲突策略为「停下让我裁决」时才停;
  • 评审收敛前归档入口显示「等待评审收敛」,属正常持锁状态;
  • 想复盘评审过程:生命周期日志页展开对应轮次的「评审原文 / 处置原文」。

还是判断不了?

打开提案生命周期日志页看结论横幅与时间线——每次停止都有明确的停因记录与发生位置。把结论横幅内容发给团队或社区,是最高效的求助方式。