.gepx 进化归档

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

.gepx 用于迁移进化资产。本页命令依据 Evolver：sync --export 写出带类型、版本、导出时间、资产、来源记录与同步记录的 JSON 包，资产类型为 Gene 或 Capsule。该 JSON 包不包含完整事件流、记忆图或蒸馏日志。其他导出入口应分别核对格式与恢复能力。

适合什么场景

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

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

导出归档

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

evolver sync --export backup.gepx

导出后记录工具版本、来源、创建时间和范围，核对资产数量与来源记录，并计算文件摘要供传输后比对。为不同备份使用不同文件名，不覆盖唯一可用副本。当前导出包最大为 64 MiB，超出时应分范围导出。

如果目标是备份桌面内部受管数据，应先核对资产路径；分别核对外部终端与 EvoX 使用的资产目录。

先预览，再导入

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

evolver sync --import backup.gepx

重点确认：

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

确认后才显式写入：

evolver sync --import backup.gepx --write

执行前通过命令帮助检查参数；遇到不支持的参数时停止操作，不自行猜测替代命令。

导入后验证

命令成功退出不代表迁移已完整完成。核对资产数量、标识、Gene/Capsule 关系、来源与同步记录，再通过一个小范围任务确认经验可以被正常召回。根事件流与记忆状态需要单独恢复验证。

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

归档与同步的区别

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

分享与恢复

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

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