Evolver 对接 Codex 完整指南为什么 --review 读不到会话日志【免费下载链接】evolverThe GEP-powered self-evolving engine for AI agents. Auditable evolution with Genes, Capsules, and Events. | evomap.ai项目地址: https://gitcode.com/GitHub_Trending/evolv/evolverEvolver 是一个基于 GEP 协议Genes、Capsules、Events的 AI 智能体自进化引擎支持可审计的进化流程。在把它对接到 Codex CLI 时不少新手会遇到一个疑惑evolver --review明明在别的平台上能读取会话日志为什么在 Codex 上却读不到本文带你快速理清原因并给出实用的对接注意事项清单。一、先搞清楚--review 模式是做什么的--review是 Evolver 的人机协同审查模式Human-in-the-Loop。它的工作流程是先运行一次进化evolver产生待审查的运行记录Gene、Signals、Mutation、diff再执行evolver --review暂停应用等待人工确认审查通过后执行--approve固化变更或--reject回滚改动。evolver # 单次进化运行 evolver --review # 审查模式暂停应用等待人工确认 evolver --loop # 后台守护循环审查逻辑的核心实现在 index.js它会读取evolution_solidify_state.json中的待审查记录并采集 git diff 展示变更详情。 如果提示No pending evolution run to review说明你还没先运行过evolver产生变更记录——先跑一次再 review 即可。二、Codex 对接setup-hooks 到底做了什么执行一次命令即可完成 Codex 的接入evolver setup-hooks --platformcodex它会完成以下 4 件事实现见 src/adapters/codex.js步骤写入位置作用1~/.codex/hooks.json注册 3 个生命周期钩子2~/.codex/hooks/拷贝钩子脚本3~/.codex/config.toml开启codex_hooks true特性开关4项目根目录AGENTS.md注入!-- evolver-evolution-memory --进化记忆段落注册的 3 个钩子事件及对应脚本SessionStart→ evolver-session-start.js会话启动时静默加载最近的进化记忆PostToolUse→ evolver-signal-detect.js文件编辑时检测进化信号Stop→ evolver-session-end.js会话结束时采集 git diff 统计并记录结果。⚠️ 关键认知setup-hooks只是生命周期集成——它让 Evolver 能旁观 Codex 会话并自己记录结果但不会把 Codex 的模型请求路由到 Evolver Proxy。三、核心疑问为什么 --review 读不到 Codex 的会话日志这是平台能力差异决定的不是你的配置问题Codex CLI 提供了SessionStart/Stop/PostToolUse钩子这正是 Evolver 的接入点但它不会像 Cursor / Claude Code / opencode 那样输出会话转录文件session transcript。而--review审查管线需要读取原始会话日志来还原上下文。Codex 上这类日志文件根本不存在因此采集阶段会输出session_logs_missing这类建议性信号advisory signal定义见 src/gep/signals.jsif (lower.includes(no session logs found) || lower.includes(no jsonl files)) signals.push(session_logs_missing);简单说不是 Evolver 读不了而是 Codex 从来没产生过那种日志文件。四、Evolver 的补偿机制三级回退读取别担心Evolver 有内置补偿策略。当原始会话日志缺失时它会按以下优先级依次读取替代来源工作区根目录的MEMORY.md/USER.md如果你维护了的话setup-hooks --platformcodex注入到项目AGENTS.md中的!-- evolver-evolution-memory --段落本地memory_graph.jsonl的尾部——这是 Evolver 自己每个周期写入的结果日志由 Stop 钩子evolver-session-end.js持续追加。✅ 好消息最初几个周期里出现的memory_missing/user_missing/session_logs_missing信号属于正常现象。随着memory_graph.jsonl不断积累结果它们会自行消退无需任何手动干预。五、对接 Codex 注意事项清单✅装完钩子后必须重启 Codex CLI否则hooks.json不生效✅ 确认~/.codex/config.toml中已有codex_hooks true安装脚本会自动写入见 src/adapters/codex.js 中的ensureConfigToml⚠️ 首次几个周期出现缺失类建议信号是预期行为不必清理或手动补日志⚠️--review前必须有一次已运行的进化状态文件evolution_solidify_state.json非空否则提示无可审查内容⚠️ 若还想把 Codex 的模型流量也路由进 Evolver Proxy那属于另一套配置自定义 Responses 兼容 providerbase_url指向代理的/v1端点与生命周期钩子互不依赖详见 README.md 的 Codex caveats 章节✅ 卸载时执行对应 uninstall 逻辑会干净移除hooks.json条目、钩子脚本、codex_hooks开关及AGENTS.md注入段落不会留残。六、常见问题 FAQQ1为什么 Cursor 上 --review 正常Codex 上却出现日志缺失信号因为 Cursor / Claude Code / opencode 会落盘会话转录文件而 Codex 只开放钩子、不产出转录文件。Evolver 会回退到三级读取源补偿信号会随运行积累自动消失。Q2memory_graph.jsonl是什么需要我手动维护吗不用。它是 Evolver 自己维护的每周期结果日志由 Codex 的 Stop 钩子在每次会话结束时追加写入。Q3我不想要 Codex 集成了怎么撤销使用setup-hooks的卸载流程即可它会精确剥离 Evolver 写入的hooks.json条目、脚本目录、config.toml开关和AGENTS.md段落其他用户配置不受影响。写在最后一句话总结Codex 上没有会话转录文件所以 --review 读不到原始日志但 Evolver 的三级回退读取 自维护的memory_graph.jsonl会让进化闭环照常运转。只要理解这一点前几个周期的缺失信号就不再是故障而是 Evolver 正在积累记忆的过程。【免费下载链接】evolverThe GEP-powered self-evolving engine for AI agents. Auditable evolution with Genes, Capsules, and Events. | evomap.ai项目地址: https://gitcode.com/GitHub_Trending/evolv/evolver创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考