RunLogos遇阻与恢复
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 配置不合法、门禁定义冲突 | 打开流程配置编辑器修正，校验通过后重启驱动 |
RunLogos 1.0.4 新增的停因
| 横幅停因 | 原因 | 处理 |
|---|---|---|
| 等待审批 / 晋级未满足 | 🔴 部署门禁硬停点：目标环境配置了 require_approval 而该版本未获批准，或配置了 promote_from 而该版本未在上游冒烟通过。任何模式（含全自动）都不会自动越过 | 在 环境面板 点「批准版本…」（或在终端运行 openlogos approve）；晋级未满足时先在上游环境用同一版本运行冒烟并通过。然后重新驱动 |
| 等你回答决策：C07 | 🟡 提案「决策澄清」还有未回答的问题，全自动档下 plan 门不会自动放行 | 点「回答决策」，在「⏸ 待你回答的决策」卡中选好答案后点「发送给 Agent」，同一次运行自动继续；也可以点「直接批准方案」带着未答决策继续 |
| merge 超时 | 🔴 openlogos merge 超过 5 分钟未结束，已被终止，合并结果尚未确认；多为机器负载高（如同时在跑 verify） | 稍后重新驱动，由 OpenLogos 尝试恢复并重新判定；恢复失败时按其诊断处理 |
| 归档未执行：原因 | 🔴 点「授权归档」后归档没有执行成功 | 按横幅给出的原因处理，新的确认项到达后点「重试授权归档」 |
| DEPLOY_DONE 未记录目标环境 | 🟡 项目登记了环境，但提案的 DEPLOY_DONE 没有记录部署到了哪个环境，驱动无法确定冒烟目标 | 在 OPENLOGOS 面板运行冒烟并选择目标环境（会注入该环境保存的密钥）；或补齐部署记录后重新驱动 |
blocked 驻留态的三个控件
驱动停在 blocked 时，面板常驻三个操作：
- 横幅 — 停因的人话描述与发生阶段；
- 停止 — 结束本次驱动运行（提案状态保留，可稍后重启）；
- 接管重启 — 以当前状态为起点重新驱动；已完成的阶段不会重跑（完成判据以产物为准）。
评审门相关
- 评审驳回不是停止：Driver 会自动派主 Agent 处置意见并交复审，只有轮次耗尽且冲突策略为「停下让我裁决」时才停；
- 评审收敛前归档入口显示「等待评审收敛」，属正常持锁状态；
- 想复盘评审过程：生命周期日志页展开对应轮次的「评审原文 / 处置原文」。
还是判断不了？
打开提案生命周期日志页看结论横幅与时间线——每次停止都有明确的停因记录与发生位置。把结论横幅内容发给团队或社区，是最高效的求助方式。