ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Evolver在非git目录运行失败?Git依赖原因与5分钟修复法(附终极排查清单)

Evolver在非git目录运行失败?Git依赖原因与5分钟修复法(附终极排查清单) Evolver在非git目录运行失败Git依赖原因与5分钟修复法附终极排查清单【免费下载链接】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你是否也遇到过这种崩溃瞬间满怀期待地运行evolverAI 智能体自进化引擎却直接报错退出Evolver 是基于 GEP 协议的 AI 智能体自进化引擎Git 是它的硬性前置依赖——在非 git 目录中运行会直接报错退出。本文带你彻底搞懂背后的原因并用 5 分钟完成修复。一、报错长什么样3 种典型表现Evolver 在不同场景下对非 git 目录的反应并不一样先对号入座场景你会看到什么背后逻辑主进程/守护进程启动直接 FATAL 报错退出提示Not a git repository仓库根目录解析失败Agent 会话启动钩子一行提示This folder is not a git repository, so evolution memory is inactive进化记忆被静默停用Agent 会话结束钩子不记录任何进化结果日志留下not a git workspace面包屑无 diff 就无信号 一个高频坑用 npm 全局安装后如果你正站在一个没有.git的目录里报错信息可能指向node_modules/evomap/evolver这个安装目录让你误以为要在安装目录里git init——千万不要正确位置是你当前项目目录src/gep/paths.js 专门为此做了修正。二、为什么 Evolver 必须依赖 Git这不是可选增强而是进化闭环的三大支柱1️⃣ 回滚安全网每个进化周期都可能修改你的文件。失败时 Evolver 默认用git stash push --include-untracked把现场完整保留随时可以git stash pop找回src/gep/gitOps.js。没有 Git就没有后悔药。2️⃣ 变更范围计算Evolver 的所有进化成果outcome都是从git diff推导出来的——改了哪些文件、是成功还是失败、得分多少信号全部来自 diff 快照src/gep/gitOps.js。没有 Git就没有信号源进化记忆自然无法工作。3️⃣ 固化Solidify与审计GEP 协议强调可审计的进化基因Gene、胶囊Capsule、事件Event的沉淀都需要 git 作为变更边界和版本锚点让每一次进化可追溯、可复现。 一句话总结Git 之于 Evolver就像安全带之于赛车——不是限制速度而是让你敢踩油门。三、5 分钟修复法3 步让 Evolver 恢复运行第 1 步确认 Git 已安装1 分钟Evolver 启动时会做预检先执行git --version验证 Git 在 PATH 上index.js。如果 Git 没装它会直接给出各平台安装提示macOSxcode-select --installLinuxsudo apt-get install -y gitWindows安装 Git for Windows 后新开终端验证第 2 步在项目目录初始化 Git 仓库1 分钟进入你的项目目录执行两条命令git init git add -A git commit -m baseline before evolution⚠️ 注意必须做至少一次 commit。空仓库无提交历史同样无法作为快照基线Solo 模式的快照守卫会把没有提交的仓库视为无法判断src/solo/gitGuard.js。第 3 步重启 Evolver 并验证3 分钟回到项目目录重新运行evolver然后做两个小检查看启动输出不应再出现Not a git repository报错看进化日志~/.evolver/logs/evolution.log中会出现会话结果记录如Session outcome recorded to ...而不是之前的nothing recorded (not a git workspace)src/adapters/scripts/evolver-session-end.js。✅ 看到这两点说明进化闭环已重新打通信号采集 → 记忆记录 → 失败可回滚。四、进阶技巧用环境变量精确控制进化哪块地盘Evolver 解析仓库根目录有一套明确的优先级src/gep/paths.js按顺序EVOLVER_REPO_ROOT——显式指定永远优先写进.env即可持久生效当前工作目录向上找最近的.git你会话中站着的项目Evolver 自身所在目录本地 npm 安装、开发模式。三个实用技巧需求做法目录嵌套复杂、自动向上查找找错了设置EVOLVER_REPO_ROOT/绝对/路径全局安装时误吸附到别人的.git如 Homebrew 目录设置EVOLVER_NO_PARENT_GITtrue关闭向上查找想看看 Evolver 到底选中了哪个仓库留意 stderr 的[evolver] Using host git repository at: ...提示另外EVOLVER_QUIET_PARENT_GIT可关闭这条提示噪音EVOLVER_QUIET_PARENT_GIT之外还可在.env中配置EVOLVER_REPO_ROOT对多项目并行进化的同学非常友好。五、修复后常见问题清单 ️提示Could not run git --version→ Git 未安装或未加入 PATHWindows 用户装完记得开新终端报错指向安装目录node_modules/evomap/evolver→ 说明当前目录及上级都没有.git回到你的项目根目录执行git init即可进化了但找不到记忆→ 确认会话结束时目录是 git 仓库非 git 工作区下会话钩子只会在日志里留not a git workspace面包屑src/adapters/scripts/evolver-session-end.js担心进化翻车→ 默认回滚模式是 stash1.80.7 之前是 hard reset失败的改动都可以通过git stash list找回MEMORY.md、IDENTITY.md、openclaw.json等关键文件还有受保护清单兜底src/gep/gitOps.js。写在最后Evolver 把AI 智能体自我进化做成了一件可审计、可回滚的事而 Git 正是这套安全体系的基石。非 git 目录下的报错不是 Bug而是它在保护你——5 分钟完成git init 首次 commit就能让整个进化引擎在你的项目里稳稳跑起来 延伸阅读项目完整说明见 README.zh-CN.mdGEP 资产种子数据见 assets/gep/genes.seed.json。【免费下载链接】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),仅供参考
返回列表