运行参数参考

本页提供 cycle、autoexec 与 lifecycle 的运行入口和配置参考。完整接入、状态判断与恢复流程见持续运行与任务队列。

持续运行适合已经具备边界、验证与监控的流程。先区分处理材料的 cycle、消费队列的 autoexec，以及管理后台进程的 lifecycle；它们不是同一个循环开关。

启用持续运行前，先配置执行入口与任务范围。

选择运行方式

入口	用途	开始前确认
`evolver cycle`	消费材料并执行有限轮次的进化流程	仓库、目标、材料来源、执行器和验证命令
`evolver cycle watch`	持续观察材料并处理后续周期	运行边界、状态文件、最大迭代与停止条件
`evolver autoexec [home]`	常驻处理执行队列与后台维护	allowedRoots、runner、超时及外部行为
`evolver lifecycle`	启停、查询或安装后台服务	服务归属、配置路径和停止方式

先运行 evolver cycle capabilities --json 查看能力。当前内置 Claude、Codex 和 Cursor 执行路径被关闭；Gemini 与独立 llm 文件执行器是实验路径，不能把帮助中出现执行器名称当作已验收的执行支持。

配置 autoexec

配置位于所选 home 的 autoexec/config.json：

字段	默认值	含义
`allowedRoots`	`[]`	可执行的仓库白名单；为空时不执行队列任务。
`pollMs`	`30000`	基础轮询间隔，单位毫秒。
`timeoutMs`	`600000`	执行超时，单位毫秒。
`runner`	`claude`	执行器选择；当前实验 `gemini` 与 `llm` 路径可消费执行队列。
`workflowValidationProfiles`	`{}`	命名验证命令集，用于配置对应工作流的检查。

进程正常运行不等于正在改代码。默认白名单为空，默认执行器的执行队列也被关闭；日志中的维护活动应与执行结果分开查看。

加入仓库白名单前，先明确是否允许接收 Hub 任务。EVOLVER_TASK_RECEIVER=0 阻止新领取；不要用 off 或 false 替代，这个开关仅把字符串 0 识别为关闭。未关闭时，接收器在具备节点、客户端、仓库与队列后启用。购买、自动交付和任务领取分别控制，见Worker 模式。

空闲节奏与探索

常驻循环默认感知空闲状态；EVOLVER_IDLE_AWARE=0 改为固定基础节奏。空闲建议以 300 秒和 1800 秒划分强度，无法读取空闲时间时使用正常节奏。single-flight 防止一轮未结束就叠加下一轮。

探索负责寻找新的可验证线索，不是扩权理由。没有匹配 Gene 时，执行方案仍须遵守目标范围和验证命令。不要把旧版 EVOLVER_EXPLORE_* 或 EVOLVE_MIN_INTERVAL 表格当作本版本的有效配置。

上线、停止与恢复

先在隔离仓库观察成功、无工作和失败三条路径，记录每条路径的周期状态、日志和文件变化，再延长运行时间。使用 evolver lifecycle status 检查受管服务，不能只看前台终端是否关闭。

停止后先确认未完成周期、执行队列及远端结果。按变更边界检查恢复证据，避免重复执行已经产生副作用的任务。