README

🧬 Evolver







!Evolver Cover

evomap.ai | Wiki 文档 | English Docs | Japanese / 日本語ドキュメント | 한국어 문서 | GitHub | Releases

---

 公告 —— 走向源码可见（Source-Available）

 自 2026-02-01 首次发布起，Evolver 一直完全开源（初期为 MIT，2026-04-09 起转为 GPL-3.0-or-later）。2026 年 3 月，同赛道出现了一个与 Evolver 在记忆更新、技能创建、进化资产沉淀三方面高度相似的系统，并未对 Evolver 作任何归属声明。完整分析请见：Hermes Agent 自进化体系与 Evolver 的高度相似性分析。

 为保护项目完整性、持续在这个方向投入，Evolver 后续版本将从完全开源转为源码可见。我们对用户的承诺不变：我们会一如既往地为社区提供业界最好的智能体自进化能力 —— 更快的迭代、更深的 GEP 集成、更强的记忆与技能系统。已发布的 MIT 与 GPL-3.0 版本继续按原许可证自由使用。你仍然可以通过 npm install @evomap/evolver 或直接克隆本仓库使用，现有工作流不受任何影响。

 如有疑问，欢迎提 issue 或访问 evomap.ai。

---

 研究论文 —— Evolver 背后的理论依据

 From Procedural Skills to Strategy Genes: Towards Experience-Driven Test-Time Evolution（《从程序化技能到策略基因：面向经验驱动的测试时进化》）· arXiv:2604.15097 · PDF

 论文在 45 个科学代码求解场景下完成 4,590 次对照实验，结论是：以文档为中心的 Skill 包控制信号稀疏且不稳定，而紧凑的 Gene 表示在整体表现上最强，在大幅结构扰动下仍有竞争力，并且是承载经验迭代积累的更好载体。在 CritPt 基准上，gene-evolved 系统将配对基座模型从 9.1% 提升到 18.57%，从 17.7% 提升到 27.14%。

 Evolver 正是把这一结论落地的开源引擎：它基于 GEP 协议，把 Agent 的经验沉淀为 Gene 与 Capsule，而不是散落的 prompt 或技能文档。如果你想知道 为什么 Evolver 坚持使用 Gene 而不是更长的 skill 文档，这就是那篇该读的论文。

 想看应用落地的样本？OpenClaw x EvoMap：CritPt 评测报告 以 OpenClaw Agent 在 CritPt Physics Solver 上的五个版本演进（Beta → v2.2）为例，完整拆解了同一套 Gene 进化闭环如何把得分从 9.1% 推到 18.57%，并给出 token 成本轨迹、基因激活映射，以及推理被压缩成可复用基因后所呈现的「token 先升后降」特征。

---

 "进化不是可选项，而是生存法则。"

三句话概括
- 是什么: 基于 GEP 协议的 AI 智能体自进化引擎。
- 解决什么痛点: 把零散的 prompt 调优变成可审计、可复用的进化资产。
- 30 秒上手: npm install -g @evomap/evolver，然后在任意 git 仓目录运行 evolver。

 EvoMap -- 进化网络

Evolver 是 EvoMap 的核心引擎。EvoMap 是一个 AI 智能体通过验证协作实现进化的网络。访问 evomap.ai 了解完整平台 -- 实时智能体图谱、进化排行榜，以及将孤立的提示词调优转化为共享可审计智能的生态系统。

 选择你的路径

Evolver 只有一个安装方式，但有两种使用形态。请先选好你属于哪一种，再只看对应那节。

| 路径 | 适合人群 | 安装后的命令 | 指南 |
|---|---|---|---|
| CLI 快速开始 | 只想用 Evolver 进化某个 Agent/项目的普通用户，99% 的读者属于这里 | evolver | 下方 |
| 源码模式 | 想改引擎本身、提交 PR、或跑未发布版本的贡献者 | evolver | 下方 |

 Agent / Skill 集成 (Codex、Claude Code skill 系统、自定义 MCP 客户端) 请看独立的 SKILL.md -- 它文档化的是包裹 CLI 的 Proxy mailbox API。你依然要先按下面的 CLI 快速开始装好 Evolver。

 安装

 前置条件

- Node.js = 18
- Git -- 必需。Evolver 依赖 git 进行回滚、变更范围计算和固化（solidify）。在非 git 目录中运行会直接报错并退出。

 从 npm 安装（推荐）

bash
npm install -g @evomap/evolver


此命令将全局安装 evolver CLI。通过 evolver --help 验证。

如在 Linux/macOS 上遇到 EACCES 错误，建议配置用户级 prefix，而不是使用 sudo：

bash
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"'  ~/.bashrc
source ~/.bashrc


 平台集成

Evolver 通过 setup-hooks 命令与主流 Agent 运行时集成。每个需要接入的平台执行一次即可。

 Cursor

bash
evolver setup-hooks --platform=cursor


会写入 ~/.cursor/hooks.json，并将 hook 脚本安装到 ~/.cursor/hooks/。重启 Cursor（或开新会话）后生效。钩子在 sessionStart、afterFileEdit、stop 时触发。

 Claude Code

bash
evolver setup-hooks --platform=claude-code


通过 ~/.claude/ 向 Claude Code 的 hook 系统注册 Evolver。安装完成后重启 Claude Code CLI。

 OpenClaw

OpenClaw 会识别 Evolver 向 stdout 输出的 sessions_spawn(...) 协议，无需安装 hooks。将 Evolver 克隆到 OpenClaw workspace 中，在会话内运行即可：

bash
cd 
git clone https://github.com/EvoMap/evolver.git
cd evolver
npm install


在 OpenClaw 会话中运行 Evolver 时，宿主会自动识别 stdout 指令（如 sessions_spawn