资产路径

独立 Evolver 会把节点身份、GEP 资产、记忆、Skill 和日志保存到不同目录。先确定哪些数据需要备份、哪些包含 secret，再修改路径。

常用目录

配置	默认位置	内容
`EVOLVER_HOME`	`~/.evomap`	Evolver 持久状态与身份根目录。
`EVOLVER_LOGS_DIR`	`$cwd/logs`	运行日志。
`MEMORY_DIR`	`$cwd/memory`	进程内记忆目录。
`EVOLUTION_DIR`	`$memory/evolution`	进化数据与记忆图。
`GEP_ASSETS_DIR`	`$repo/assets/gep`	Gene、Capsule 和 Event 资产。
`SKILLS_DIR`	`$cwd/skills`	Skill 内容。
`EVOLVER_REPO_ROOT`	自动探测	Git 操作使用的项目根目录。

实际默认值会根据启动目录和仓库位置展开。修改前用 evolver --print-env 读取最终路径，不要依据相对路径猜测。

规划目录

把 EVOLVER_HOME 放到只有当前运行账号可访问的持久目录。
将 GEP_ASSETS_DIR 与项目源码分开备份；若保留在仓库内，明确哪些文件允许提交。
为日志设置轮转、容量和脱敏规则。
远程 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 文档 · 配置 · 路径与平台

常用目录

配置	默认位置	内容
`EVOLVER_HOME`	`~/.evomap`	Evolver 持久状态与身份根目录。
`EVOLVER_LOGS_DIR`	`$cwd/logs`	运行日志。
`MEMORY_DIR`	`$cwd/memory`	进程内记忆目录。
`EVOLUTION_DIR`	`$memory/evolution`	进化数据与记忆图。
`GEP_ASSETS_DIR`	`$repo/assets/gep`	Gene、Capsule 和 Event 资产。
`SKILLS_DIR`	`$cwd/skills`	Skill 内容。
`EVOLVER_REPO_ROOT`	自动探测	Git 操作使用的项目根目录。

实际默认值会根据启动目录和仓库位置展开。修改前用 evolver --print-env 读取最终路径，不要依据相对路径猜测。

规划目录

把 EVOLVER_HOME 放到只有当前运行账号可访问的持久目录。

将 GEP_ASSETS_DIR 与项目源码分开备份；若保留在仓库内，明确哪些文件允许提交。

为日志设置轮转、容量和脱敏规则。

远程 memory 使用单独的 URL 与 key，不把远程凭证写进本地资产归档。

迁移路径前停止写入，复制完成后校验数量、摘要和可读性，再切换配置。