RunLogosRunLogos

上手教程:从建提案到自动归档

本教程带你完成第一次完整的无人值守驱动。开始前请先按 前置条件与配置 确认 OpenLogos CLI 版本与 Agent 已就绪。

第 1 步:新建变更提案

在项目根目录(logos/logos.config.json 所在目录)运行:

cd <项目根目录>
openlogos change my-feature

CLI 会创建 logos/changes/my-feature/(含 proposal.mdtasks.md 模板)并写入活跃变更锁。

第 2 步:让 Agent 填写提案

对任一已打开的 Agent 说「帮我填写变更提案 my-feature」。Agent 会分析影响范围,填写变更原因、变更范围、部署决策与任务清单。

提案仍是模板空壳时,驱动按钮处于灰禁状态(内容就绪门),tooltip 提示「提案正在填写中」。这是刻意设计:防止驱动流程抢占正在起草提案的 Agent 会话。填写完成后按钮自动恢复可点。

第 3 步:打开 Agent 会话

Driver 只从已打开的 Agent 标签页中选择执行者(不会在后台偷偷创建无头会话)。确保至少打开一个 Agent;若要启用多 Agent 评审,需要打开第二个不同的 Agent。

第 4 步:点「驱动」并完成启动配置

在 CLI 面板的提案推进控制行点击驱动按钮,启动配置弹窗一屏配完:

  1. 运行模式:半自动 / 全自动(默认全自动);
  2. 主 Agent:从已打开的 Agent 中单选;
  3. 多 Agent Review(可选):勾选评审环节(默认勾 Delta + 代码)、选择评审 Agent(必须不同于主 Agent)、选择冲突处理策略(推荐默认的「前严后松」);
  4. 高级(可展开):阻断级别、最多评审轮数、评审意见累计上限(同一提案评审生命周期的 finding 天花板);
  5. 可勾选「记住为本项目默认」,配置会写入 logos.config.jsondriver.review 段。

点「开始驱动」,Driver 接管。

第 5 步:观察自动推进

驱动过程中:

  • 阶段流按「填写提案 → 撰写 Delta → 合并 → 编码规划 → 编码实现 → 测试验收 → 部署 → 冒烟 → 归档」逐段高亮;
  • 每个阶段行展示当前动作与最近输出摘要;
  • 开启评审时,受审阶段下方出现评审门子行(评审中 / 驳回处置中 / 待复审 / 评审通过等六态);
  • 菜单栏图标常驻展示运行中的驱动,切到别的窗口也能瞄一眼进度。

这期间你可以离开——Driver 的心跳与看门狗会保证卡住时明确停下,而不是无声挂死。

第 6 步:verify / smoke 失败时看自愈

测试验收失败不需要你介入:Driver 把失败摘要派回 Agent 修复后自动重跑,循环直至收敛。冒烟失败同理(修复 → 重跑 verify → 按需重新部署 → 重新冒烟)。只有修复轮次耗尽仍未绿时才会停下等你接管——那就是任何模式都必停的 loop-exhausted 硬红线。

第 7 步:部署——全自动直接执行,半自动等你放行

全自动模式下不需要你做任何事:verify 通过后,standing 授权自动放行部署入口门,Driver 按已合并的部署方案执行并受控落标(openlogos deploy-done),随后自动运行 smoke。半自动模式下,进入部署前会停下弹出确认,检查部署方案摘要后点「确认放行」。

第 8 步:归档——全自动自动收尾,半自动二次确认

冒烟通过后,全自动模式会自动执行归档:提案移入 logos/changes/archive/,活跃变更锁释放,全流程完成——这正是「无人值守」的含义。半自动模式下提案停在「等待归档」,由你点击归档并二次确认。

第 9 步:生命周期日志页复盘

打开提案生命周期日志页,自上而下查看:结论横幅(成功 / 失败与原因)→ 十步里程碑摘要条 → 按阶段分区的完整时间线(含每轮评审与处置详情)。谁在什么阶段做了什么、结果如何,全部可回放。

接下来