.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 文件當作整台設備的恢復鏡像。