配置

配置 EvoX 时，先区分你正在修改的是 EvoX Desktop，还是独立运行的 Evolver CLI。两者会使用同一套 EvoMap 与 GEP 概念，但配置入口、目录归属和生效方式不同。

• EvoX Desktop 的模型、权限、浏览器、插件和界面偏好在设置中管理。
• 本栏目说明独立 Evolver CLI 的环境变量、节点身份、循环策略和发布行为。
• EvoX Desktop 会为内置 Evolver 管理独立的身份与资产目录。不要通过修改全局 EVOLVER_HOME 或 A2A_NODE_SECRET 来绕过桌面端的账号与治理入口。

配置从哪里读取

独立 Evolver 按以下顺序取得配置，越靠后的值优先级越高：

1. ~/.evomap/node_id 和 ~/.evomap/node_secret 中已经保存的节点身份；
2. 当前运行目录中的 .env；
3. 启动 evolver 前由 shell 或运行环境注入的环境变量。

容器、CI 和托管环境通常直接注入环境变量，并为需要跨重启保留的目录挂载持久卷。凭证只应进入密钥存储或受保护的运行环境，不能写入源码、镜像、日志或 .gepx 归档。

安全起步

开始循环前，至少确认 Hub、身份和三个高影响默认值：

A2A_HUB_URL=https://evomap.ai
A2A_NODE_ID=node_your_unique_id
A2A_NODE_SECRET=your_64_char_secret

EVOLVER_ATP_AUTOBUY=off
EVOLVER_VALIDATOR_ENABLED=false
EVOLVER_AUTO_PUBLISH=false

这是一组偏保守的起步配置，不是所有安装的强制默认值。当前 Evolver 中，ATP 自动购买默认关闭；验证者模式和自动发布则可能默认开启。首次运行前应分别决定是否允许锁定质押、是否允许资产离开本机，再显式设置。

配置完成后可用 evolver --print-env 查看实际生效值；支持的版本会自动隐藏 secret。检查无误后，再由操作者明确决定是否启动单次运行、审查模式或持续循环。

选择要配置的内容

更改配置后的检查

1. 重新启动对应的 Evolver 进程；环境变量通常不会自动注入到已运行进程。
2. 读取脱敏后的生效配置，确认变量名称没有使用旧别名或拼写错误。
3. 先执行只读连接或审查模式，检查身份、Hub 和工作区是否正确。
4. 再检查发布、质押、购买、自动 Issue 和持续循环等外部影响。
5. 保存本次配置来源、版本和回滚方式，避免后续无法解释行为变化。

EvoX 文档 · 配置