导入经验

使用 .gepx 可迁移进化归档，在受支持的 Evolver/GEP 环境之间备份或迁移 Gene、Capsule、Evolution Event 和记忆数据。

.gepx 属于 Evolver/GEP。当前资料没有确认 EvoX Desktop 的可视化导入入口；以下流程使用 Evolver CLI。

导入前准备

先预览导入计划：

bash

evolver sync --import backup.gepx

检查 schema、目标路径、资产数量和冲突。确认后再显式写入：

bash

evolver sync --import backup.gepx --write

默认预览与显式 --write 是两个步骤。不要把“命令没有报错”当作“资产已经写入”。

bash

evolver sync --export backup.gepx

记录归档路径、创建时间、工具版本和校验信息。不要把 node_secret、访问令牌或签名密钥放进归档，也不要覆盖唯一备份。

Hub 同步使用明确 scope，并默认先显示计划：

bash

evolver sync --scope purchased
evolver sync --scope published
evolver sync --scope all
evolver sync --scope all --write

Recipe-first 搜索与底层 SearchFirst 都是只读检索，不会静默写入第三方资产。只有显式同步、导入或发布操作才会产生对应持久化或外部副作用。

未知 schema、校验失败或同 ID 冲突时停止写入。保留源归档和原环境，在确认已经写入的部分后再决定重试或恢复。

EvoX 文档 · overview · 开始使用

预览并导入

先预览导入计划：

bash

evolver sync --import backup.gepx

检查 schema、目标路径、资产数量和冲突。确认后再显式写入：

bash

evolver sync --import backup.gepx --write

默认预览与显式 --write 是两个步骤。不要把“命令没有报错”当作“资产已经写入”。

验证结果

对比 manifest 与实际导入数量。

检查 Gene、Capsule 与 Event 的引用关系。

核对跳过、冲突、失败和不支持的条目。

使用低风险任务确认预期经验能够被召回。

使用 MCP 时可调用 evolver_recall，但召回成功不能替代数量、引用和校验检查。

与 Hub 同步的区别

Hub 同步使用明确 scope，并默认先显示计划：

bash

evolver sync --scope purchased
evolver sync --scope published
evolver sync --scope all
evolver sync --scope all --write

Recipe-first 搜索与底层 SearchFirst 都是只读检索，不会静默写入第三方资产。只有显式同步、导入或发布操作才会产生对应持久化或外部副作用。