.gepx 进化归档

备份或迁移一组进化经验，保留资产之间的关联。

.gepx 是 Portable Evolution Archive，即可迁移进化归档。它是 Evolver/GEP 使用的 gzip tar 归档，可包含清单、Gene、Capsule、进化事件、记忆图、蒸馏日志和校验信息。

适合什么场景

• 在迁移设备或运行环境前保存一份进化历史。
• 在升级或整理资产前保留可验证的恢复副本。
• 在经过内容审阅后，转移一组相关经验。

归档不是整个 EvoX 应用的备份，不应携带节点秘密、访问令牌或签名密钥；也不等于插件安装包或技能包。

导出归档

以下命令用于独立 Evolver CLI。先确认使用的工作区和资产目录，再导出：

evolver sync --export backup.gepx

导出后记录工具版本、来源、创建时间和范围，检查归档清单与校验信息。为不同备份使用不同文件名，不覆盖唯一可用副本。

如果目标是备份桌面内部受管数据，应先核对资产路径；外部终端的默认目录不一定是 EvoX 正在使用的目录。

先预览，再导入

先检查计划，不立即写入：

evolver sync --import backup.gepx

重点确认：

• 数据版本是否可识别。
• 资产数量与预期是否一致。
• 是否出现同 ID 冲突或缺失引用。
• 目标目录是否正确，当前数据是否已经备份。
• 是否通过校验，内容是否包含不应迁移的秘密。

确认后才显式写入：

evolver sync --import backup.gepx --write

以上流程以当前已记录的 CLI 行为为依据；安装版本不支持相应参数时，先查帮助，不自行猜测替代命令。

导入后验证

命令成功退出不代表迁移已完整完成。核对资产数量、标识、Gene/Capsule 关系和事件引用，再通过一个小范围任务确认经验可以被正常召回。

保留原始归档，直到验证结束。发现未知 schema、校验失败或冲突时停止写入，不通过删除字段伪造兼容。

归档与同步的区别

导入文件不等于发布到 Hub。同步范围、预览与写入方式见同步与导出。

分享与恢复

分享前检查个人信息、内部内容和本机路径，即使归档格式有效也不代表适合公开。节点身份、凭证、应用设置、技能目录和项目文件应分别备份。

需要完整恢复方案时，参见备份，不要把一个 .gepx 文件当作整台设备的恢复镜像。