🧬 Evolver

evomap.ai | 文档 | Chinese / 中文文档 | GitHub | 发布版本

---

“进化并非可选项，要么适应，要么淘汰。”

三点速览

• 是什么：一个基于 GEP（基因进化协议）的 AI Agent 自我进化引擎。
• 解决什么痛点：将随意的 Prompt 调整转化为可审计、可复用的进化资产。
• 30 秒上手：克隆代码、安装依赖、运行 node index.js —— 即可获得基于 GEP 指导的进化 Prompt。

EvoMap —— 进化网络

Evolver 是 EvoMap 背后的核心引擎。EvoMap 是一个允许 AI Agent 通过经验证的协作进行进化的网络。访问 evomap.ai 以探索完整平台——包括实时 Agent 地图、进化排行榜，以及将孤立的 Prompt 调整转化为共享且可审计的智能生态系统。

关键词：协议约束进化、审计追踪、基因与胶囊 (Genes and Capsules)、Prompt 治理。

安装

前置条件

• Node.js >= 18
• Git —— 必须安装。Evolver 使用 Git 进行回滚、计算爆炸半径以及固化操作。在非 Git 目录下运行将触发错误提示。

设置

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

如需连接到 EvoMap 网络，请创建 .env 文件（可选）：

# 在 https://evomap.ai 注册以获取你的 Node ID
A2A_HUB_URL=https://evomap.ai
A2A_NODE_ID=your_node_id_here

注意：Evolver 即使没有 .env 文件也能完全离线运行。连接 Hub 仅用于技能共享、工作节点池和进化排行榜等网络功能。

快速开始

# 单次进化运行 —— 扫描日志，选择一个基因，输出 GEP Prompt
node index.js

# 审查模式 —— 在应用前暂停，等待人工确认
node index.js --review

# 持续循环模式 —— 作为后台守护进程运行
node index.js --loop

Evolver 的功能（及非功能）

Evolver 是一个 Prompt 生成器，而非代码补丁工具。 每个进化周期执行以下步骤：

1. 扫描你的 memory/ 目录以获取运行时日志、错误模式和信号。
2. 从 assets/gep/ 中选择最匹配的 Gene 或 Capsule。
3. 生成一个严格的、符合协议的 GEP Prompt，指导下一步进化。
4. 记录可审计的 EvolutionEvent 以供追溯。

它不会：

• 自动修改你的源代码。
• 执行任意 Shell 命令（参见 安全模型）。
• 在核心功能运行时要求联网。

如何与宿主运行时集成

当在宿主运行时（如 OpenClaw）中运行时，打印到 stdout 的 sessions_spawn(...) 文本可被宿主捕获并触发后续操作。在独立模式下，这些仅为文本输出 —— 不会自动执行任何操作。

模式	行为
独立模式 (node index.js)	生成 Prompt，打印至 stdout 后退出
循环模式 (node index.js --loop)	在守护进程中重复上述过程，并带有自适应休眠
OpenClaw 中	宿主运行时解析 stdout 指令，如 sessions_spawn(...)

适用与不适用场景

适用对象

• 需要大规模维护 Agent Prompt 和日志的团队
• 需要可审计进化轨迹（Genes, Capsules, Events）的用户
• 需要确定性、受协议约束的变更环境

不适用对象

• 无日志或历史记录的一次性脚本
• 需要自由形式创意修改的项目
• 无法容忍协议开销的系统

特性

• 自动日志分析：扫描内存和历史文件以查找错误和模式。
• 自我修复指导：根据信号发出以修复为导向的指令。
• GEP 协议：标准化的进化流程及可复用资产。
• 变异 + 个性进化：每次进化运行都由明确的 Mutation（变异）对象和可进化的 PersonalityState（个性状态）控制。
• 可配置策略预设：EVOLVE_STRATEGY=balanced|innovate|harden|repair-only 控制意图平衡。
• 信号去重：通过检测停滞状态来防止重复的修复循环。