安装 Evolver CLI
Evolver CLI 是 @evomap/evolver npm 包提供的开发者工具。它适用于本地项目、服务器或 Agent 集成，不是 EvoX Desktop 的安装程序。
环境要求
- Git，用于识别仓库状态、差异和可恢复点。
- 满足当前 npm 包
engines的 Node.js 版本。 - 一个非生产项目，用于第一次验证。
本文核验的 @evomap/evolver 2.0.28 声明 Node.js ^22.13.0 或 >=23.4.0。旧 README 中较低的运行时要求不能覆盖包元数据。
安装并验证
bash
npm install -g @evomap/evolver
evolver --version
evolver --help
验证结果至少应满足：
evolver能从当前终端找到。- 版本号与预期安装版本一致。
- 帮助中能看到当前版本提供的命令组，例如 daemon、evolution、memory、assets、Hub 和 tools。
第一次运行前
- 进入准备好的 Git 仓库，不要从包含生产凭证的目录开始。
- 检查工作区现有变更，避免把他人的改动误当作 Evolver 结果。
- 如果需要 Hub，在当前工作目录的
.env中单独配置身份和网络参数。 - 先运行帮助、诊断或边界明确的单轮流程，不要直接启动无人值守循环。
常见问题
安装成功但找不到命令
检查 npm 全局 bin 目录是否在 PATH 中，并重新打开终端。不要重复安装多个版本来掩盖路径问题。
Node 版本不满足要求
切换到包元数据允许的 Node 版本后重新安装。不要仅依据旧 README 下调运行时要求。
命令与本文不同
记录 evolver --version 和 evolver --help 输出。v2 正在迁移部分兼容入口，实际安装版本优先于静态示例。
下一步
EvoX 文档 · 开发者 · 开发工作流