GEP协议完全指南：Gene、Capsule、EvolutionEvent如何协同工作-育师

GEP协议完全指南：Gene、Capsule、EvolutionEvent如何协同工作

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

Evolver 是基于 GEP（Genome Evolution Protocol，基因组进化协议）的 AI 智能体自我进化引擎。本文面向新手，用通俗的方式带你搞懂 GEP 协议的三大核心资产——Gene（基因）、Capsule（胶囊）、EvolutionEvent（进化事件）——它们各自是什么、如何存储、又如何像齿轮一样协同工作，实现"可审计的进化"。

为什么需要 GEP 协议：让 AI 进化的每一步都可审计

普通的 AI 智能体改代码靠"临时发挥"：出了问题不知道上次为什么改、改对了也不知道经验存到哪里。GEP 协议把进化拆成三个可追溯的单元：

资产	一句话理解	存储位置
Gene（基因）	可复用的"行为模式"，遇到什么信号该怎么做	`$EVOLVER_HOME/gep/genes.json`
Capsule（胶囊）	一次成功的"打包经验"，含结果与置信度	`$EVOLVER_HOME/gep/capsules.json`
EvolutionEvent（进化事件）	只追加的"进化日记"，记录每次尝试	`$EVOLVER_HOME/gep/events.jsonl`

简单说：Gene 是招式，Capsule 是打赢的战绩，EvolutionEvent 是完整的比赛录像。

Gene 基因：信号驱动的"条件反射"

Gene 是 GEP 协议中最基础的单元。它不是一段代码，而是一套触发条件 + 行动策略 + 验证规则的声明，定义在 src/gep/schemas/gene.js。

一个 Gene 的核心字段：

category（类别）：只有 4 个合法值——repair（修复）、optimize（优化）、innovate（创新）、explore（探索），在 src/gep/schemas/protocol.js 中统一约束，防止代码与提示词"各说各话"。
signals_match（信号匹配）：一组正则模式，比如"error|错误|异常"、"log_error"。日志里出现这些信号，这个 Gene 就会被 Selector 选中。
strategy（策略）：一步步的行动清单，如"先估算影响范围 → 应用最小可回滚补丁 → 验证失败则回滚"。
validation（验证命令）：改完必须跑通哪些命令，跑不过就自动回滚。
constraints（约束）：最多改多少文件、禁止碰哪些路径（默认禁止.git和node_modules）。

你可以直接阅读项目自带的种子基因库，里面有 4 类现成示例——从错误修复到工具使用优化，每个 Gene 都遵循"信号 → 策略 → 验证"的结构：assets/gep/genes.seed.json。

💡 新手提示：看到"repair"类 Gene 的策略几乎都写着"Select an existing Gene by signals match (no improvisation)"——GEP 的核心哲学就是不即兴发挥，一切按谱来。

Capsule 胶囊：把成功经验"冷冻"成可复用资产

当某次进化验证通过后，Evolver 会把整个成功过程打包成一个 Capsule，写入capsules.json。它的完整结构定义在 src/gep/schemas/capsule.js，关键字段包括：

trigger：当初触发这次进化的信号，方便下次遇到同样情况直接命中；
gene：本次使用的那个 Gene 的引用——Capsule 和 Gene 就这样绑定；
outcome：结果状态（success/failed）和评分；
confidence：置信度，随成功次数（success_streak）累积而提高；
blast_radius：影响范围（改了几个文件、几行），用来评估"复用风险"；
execution_trace：执行轨迹，记录每一步的 build → validate → canary 阶段（见 src/gep/schemas/protocol.js 中的VALID_TRACE_STAGES）；
a2a.eligible_to_broadcast：是否允许广播到 EvoMap Hub 分享给其他节点。

Capsule 的价值在于：下次遇到相同 trigger，Selector 会优先直接"服用"高分胶囊，而不是重新让 Gene 从头演算。这就是 GEP 的"经验复用"机制。

EvolutionEvent 事件：只追加的进化账本

Gene 和 Capsule 都是"当前状态"，而 EvolutionEvent 是"完整历史"。它是**只追加（append-only）**的 JSONL 日志，逐行写入$EVOLVER_HOME/gep/events.jsonl：

每次进化循环（无论成功还是失败）都会追加一条事件；
事件携带intent（本次意图：repair / optimize / innovate / explore）、使用的 Gene、产生的 Capsule、环境指纹（env_fingerprint）等信息；
因为永不修改，任何一次代码变更都能被完整回溯——这正是"可审计进化"的落点。

项目提供了独立的事件追加工具 scripts/gep_append_event.js，以及负责三个资产文件读写的存储层 src/gep/assetStore.js。你可以用node index.js --review进入人机协作模式，人工观察每次循环写入的事件内容。

协同工作：一次完整进化循环的 5 步

把三个资产串起来，Evolver 每轮循环的工作流程如下（完整编排入口见 index.js 与 src/evolve.js）：

感知信号：从运行日志中提取信号，如log_error、perf_bottleneck；
选择 Gene：Selector 用signals_match匹配基因库，优先复用已有 Gene，无匹配才考虑新造；
执行与验证：按 Gene 的strategy执行改动，跑validation命令，失败即 git 回滚；
固化成果：成功则创建 Capsule（记录 trigger、结果、影响范围）；
记账：追加一条 EvolutionEvent，更新 Gene 库的学习历史（learning_history）。

下次循环回到第 1 步，但第 2 步可能直接命中高分 Capsule——进化在自我加速。三个资产的分工一目了然：

信号 ──► Gene（怎么做的蓝图）──► 执行/验证 │ 成功 ▼ Capsule（可复用战绩） │ ▼ EvolutionEvent（永久审计账本）

新手上手：3 步跑通 GEP 进化

克隆并运行单次进化（离线即可，无需 Hub）：

git clone https://gitcode.com/GitHub_Trending/evolv/evolver cd evolver && npm install node index.js

观察 GEP 输出：运行结束后检查events.jsonl里新增的事件行，这就是刚才那轮进化的"录像"；
尝试人机协作模式：node index.js --review，逐条审阅进化提案再决定是否采纳。

更多策略参数（如EVOLVE_STRATEGY的 balanced / innovate / harden 等预设）与配置说明，完整列在 SKILL.md 中；入门路径可参考 examples/hello-world.md。

常见问题 FAQ

Q1：GEP 协议必须联网 EvoMap Hub 吗？不必须。Gene、Capsule、Event 全部存储在本地文件，离线也能完整进化。Hub 只用于跨节点分享资产（如广播 Capsule）和任务协作。

Q2：Gene 和 Capsule 什么关系？Gene 是"事前策略"，Capsule 是"事后经验"。Capsule 通过gene字段回指所使用的 Gene，并携带更高优先级的触发记录；进化系统倾向"先查胶囊，再查基因"。

Q3：失败会留下记录吗？会。失败同样追加 EvolutionEvent，只是不会生成 success 状态的 Capsule——这正是审计价值的来源：你能完整复盘为什么失败。

小结

GEP 协议用最朴素的方式解决了 AI 自我进化的信任问题：Gene 管"该怎么做"，Capsule 管"这样做成功过"，EvolutionEvent 管"全过程留痕"。三者围绕信号驱动的选择器协同运转，让每一次自我修改都有据可查、可回滚、可复用。理解了这三个资产，你就拿到了打开 Evolver 源码地图的第一把钥匙——建议下一步从 src/gep/selector.js（信号如何匹配 Gene）和 src/gep/solidify.js（成果如何固化）读起。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考