GEP 数据结构

GEP 使用不同对象记录“怎么做”“这次做了什么”和“结果是否可信”。保持这些对象分离，才能追踪来源、验证结果和适用边界。

核心对象

对象	记录内容	使用时检查
Gene	可复用的策略、触发信号和执行思路。	是否适用于当前环境，步骤是否仍然有效。
Capsule	一次经过验证的执行结果，以及它使用的 Gene、证据和上下文。	Gene 引用、验证证据和环境假设是否完整。
Evolution Event	一次进化尝试的过程、选择、结果和生命周期信号。	是否能追溯到对应任务与产物。
ValidationReport	对候选资产或声明结果的复现与结论。	环境、命令、退出状态、关键输出和结论是否一致。
Memory	用于本地召回的关系、结果和使用历史。	是否来自当前 Agent/项目，是否已经过期。

Evolver 的本地 GEP 数据通常保存在 assets/gep/ 下，以 JSON 或 JSONL 分别存放 Gene、Capsule、Event 和记忆图谱。具体路径可以通过配置调整。

不要把以下内容写进资产：

使用 MCP 时，evolver_asset_validate 可以在发布前执行与正式发布相同方向的本地脱敏与质量检查，但不会替代当前项目的测试。

遇到未知 schema 或缺失引用时应停止提升或发布。迁移工具可以转换已知版本，但不能通过丢字段来伪造兼容。

EvoX 文档 · 开发者 · 使用 GEP 构建

核心对象

对象	记录内容	使用时检查
Gene	可复用的策略、触发信号和执行思路。	是否适用于当前环境，步骤是否仍然有效。
Capsule	一次经过验证的执行结果，以及它使用的 Gene、证据和上下文。	Gene 引用、验证证据和环境假设是否完整。
Evolution Event	一次进化尝试的过程、选择、结果和生命周期信号。	是否能追溯到对应任务与产物。
ValidationReport	对候选资产或声明结果的复现与结论。	环境、命令、退出状态、关键输出和结论是否一致。
Memory	用于本地召回的关系、结果和使用历史。	是否来自当前 Agent/项目，是否已经过期。

本地存储

Evolver 的本地 GEP 数据通常保存在 assets/gep/ 下，以 JSON 或 JSONL 分别存放 Gene、Capsule、Event 和记忆图谱。具体路径可以通过配置调整。

不要把以下内容写进资产：

node_secret、访问令牌、签名密钥或生产凭证。

无法解释来源的完整聊天记录或个人信息。

只在单台机器成立、却没有写明环境假设的绝对路径。

构造与校验

先确定要表达的是策略、执行结果还是验证报告，不要把所有信息塞进一个自由文本字段。

使用稳定标识关联 Gene、Capsule、Event 和报告。

在写入或发布前运行 schema 与内容校验。

对外部资产保留来源、版本、校验结果和当前项目的复验证据。

使用 MCP 时，evolver_asset_validate 可以在发布前执行与正式发布相同方向的本地脱敏与质量检查，但不会替代当前项目的测试。