如何从源码运行Evolver：贡献者完整教程（node index.js模式）-开发者社区

如何从源码运行Evolver：贡献者完整教程（node index.js模式）

【免费下载链接】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

想改引擎内核、提交 PR，或体验未发布的 Evolver 版本？本教程带你一步步从源码运行 Evolver：克隆仓库、安装依赖、用node index.js替代 CLI，并跑通测试与贡献流程。Evolver 是基于 GEP 协议的 AI 智能体自进化引擎，进化过程可通过 Genes（基因）、Capsules（胶囊）和 Events（事件）完整审计。

运行源码模式前，先确认 3 个前提

在开始之前，请确保环境满足以下要求：

前提	要求	说明
Node.js	≥ 22.12	以 package.json 中`engines`字段为准
Git	必须安装	Evolver 依赖 git 做回滚、影响面计算与 solidify
git 工作目录	运行目录需已`git init`	在非 git 目录运行会报错

💡 核心功能完全离线可用，连接 EvoMap Hub 只是解锁技能共享、工作池等网络功能，不是必需项。

克隆仓库并安装依赖：3 步拿到可运行源码

打开终端，执行以下命令（在 git clone 场景下使用项目提供的仓库地址）：

git clone https://gitcode.com/GitHub_Trending/evolv/evolver cd evolver npm install

装好之后，文档中所有evolver <flag>命令，都可以用node index.js <flag>一比一替换，效果完全等价。官方对源码模式的标准示例就写在 README.md 的 "Run from Source" 章节，快速上手流程可见 examples/hello-world.md。

首次运行：node index.js 的 3 种模式

进入一个git 仓库目录后，按需选择运行模式：

node index.js # 单次进化：扫描日志、选中 Gene、输出 GEP prompt node index.js --review # 审查模式：应用前暂停，等待人工确认 node index.js --loop # 循环模式：后台守护进程，自适应休眠

如何判断第一次运行成功了？

一次成功的运行会看到 5 个信号：

打印 Banner，显示检测到的策略预设（如balanced）；
扫描./memory/目录（不存在会自动创建）；
从内置资产池选中匹配的 Gene / Capsule；
向 stdout 输出GEP prompt—— 这就是本次进化的产物；
向./memory/写入一条可审计的EvolutionEvent。

如果第 4 步没出现，说明你没在 git 仓库里 ——cd进一个 git 目录重试即可。

换策略预设试试

EVOLVE_STRATEGY=innovate node index.js --loop # 80% 创新，快速迭代新功能 EVOLVE_STRATEGY=harden node index.js --loop # 40% 修复，聚焦稳定性 EVOLVE_STRATEGY=repair-only node index.js --loop # 紧急修复模式

策略	适用场景
`balanced`（默认）	日常运行，稳步增长
`innovate`	系统稳定，冲刺新功能
`harden`	大改动之后，加固稳定性
`repair-only`	紧急状态，全力修复

验证你的源码环境：跑一遍测试套件

贡献前建议先确认本地源码能跑通测试（定义在 package.json 的scripts.test）：

npm test

另外，Evolver 自带运维模块 src/ops/，可用于管理源码模式下--loop的后台生命周期：

node src/ops/lifecycle.js start # 后台启动进化循环 node src/ops/lifecycle.js status # 查看运行状态 node src/ops/lifecycle.js stop # 优雅停止

贡献前必读：仓库的 4 条硬性约定

打开 CONTRIBUTING.md，贡献者需要遵守以下核心规则：

改动要小、可审查：提交意图和范围清晰的 PR；
行为变更必须同步更新文档；
提交前跑node index.js做快速自检；
文档中除 DNA emoji 外禁用其他 emoji。

涉及进化核心的 PR 有额外门槛

如果你的改动触及 GEP schema、selector/mutation/solidify/candidate 等"harness/evaluator"表面，必须填写 PR 模板中的治理清单，且scripts/harness-governance-check.js会在 PR 上强制执行检查。两条硬性红线：Live promotion: no与Autonomous evaluator self-editing: no（禁止线上晋级、禁止评估器自编辑）。