资产路径
独立 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 文档 · 配置 · 路径与平台