運行參數參考

本頁提供 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 檢查受管服務，不能只看前台終端是否關閉。

停止後先確認未完成周期、執行隊列及遠端結果。按變更邊界檢查恢復證據，避免重複執行已經產生副作用的任務。