資產路徑
獨立 Evolver 會把節點身份、GEP 資產、記憶、Skill 和日誌保存到不同目錄。先確定哪些數據需要備份、哪些包含 secret,再修改路徑。
常用目錄
| 配置 | 默認位置 | 內容 |
|---|---|---|
| v2 狀態根 | EVOLVER_HOME,其次 EVOMAP_HOME,最後 ~/.evomap | 以下 v2 事件和資產路徑使用此解析順序。 |
| 資產 | <home>/assets/ | 本地資產池。 |
| 根事件 | <home>/evolution/root_events.jsonl | 只追加審計事件。 |
| 物化視圖 | <home>/evolution/mv/ | 可從事件重建的派生視圖。 |
| 原始材料 | <home>/evolution/material/ | cycle 的材料與去重遊標。 |
| Proxy 軌跡 | EVOLVER_LLM_TRACE_DIR,默認 <home>/proxy/traces/ | 模型請求軌跡,按敏感數據管理。 |
| Proxy 運行根 | evolver proxy --home <dir> | Proxy 的資產、設置與軌跡根。 |
| Proxy 身份根 | evolver proxy --evomap-home <dir>,默認同 --home | 節點身份,與資產根可以分開。 |
舊版 $cwd/memory、$repo/assets/gep 和 SKILLS_DIR 不能作為所有 v2 子系統的默認目錄。部分兼容流程仍讀取工作區資產,因此遷移時要分別確認實際入口與存儲對象。Evolver 沒有 --print-env 命令;用 doctor 和啓動配置檢查來源,禁止直接輸出整份環境。
規劃目錄
- 把
EVOLVER_HOME放到只有當前運行賬號可訪問的持久目錄。 - 將資產、根事件和材料分別備份;若工作區還保留兼容 GEP 文件,明確哪些文件允許提交。
- 為日誌設置輪轉、容量和脱敏規則。
- 遠程 memory 使用單獨的 URL 與 key,不把遠程憑證寫進本地資產歸檔。
- 遷移路徑前停止寫入,複製完成後校驗數量、摘要和可讀性,再切換配置。
EvoX Desktop 的內部路徑
EvoX Desktop 會把內置 Evolver 固定到應用的 agent 目錄:
text
<agentDir>/evolver/
├── assets/
├── memory/evolution/
└── settings.json
<agentDir>/evomap/
啓動受管子進程時,Desktop 會重新設置 EVOLVER_HOME、EVOMAP_HOME、EVOLUTION_DIR、GEP_ASSETS_DIR 和 EVOLUTION_ASSETS_DIR,確保召回與複用讀取同一份資產。外部 shell 中同名變量不應改變這個受管目錄。
備份與恢復
分別備份:節點身份、GEP 資產、記憶、Skill、設置和必要日誌。恢復時先在隔離環境讀取,不要同時恢復舊 secret 和新節點身份。公開分享 .gepx 或日誌前再次檢查密鑰、個人信息和本機路徑。
如果重啓後資產消失,先檢查實際路徑是否落在臨時目錄、容器層或不同工作目錄,而不是立即重新同步 Hub。
EvoX 文檔 · 配置 · 路徑與平台