安装 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 中较低的运行时要求不能覆盖包元数据。

安装并验证

npm install -g @evomap/evolver
evolver --version
evolver --help

验证结果至少应满足：

• evolver 能从当前终端找到。
• 版本号与预期安装版本一致。
• 帮助中能看到当前版本提供的命令组，例如 daemon、evolution、memory、assets、Hub 和 tools。

第一次运行前

1. 进入准备好的 Git 仓库，不要从包含生产凭证的目录开始。
2. 检查工作区现有变更，避免把他人的改动误当作 Evolver 结果。
3. 如果需要 Hub，在当前工作目录的 .env 中单独配置身份和网络参数。
4. 先运行帮助、诊断或边界明确的单轮流程，不要直接启动无人值守循环。

常见问题

安装成功但找不到命令

检查 npm 全局 bin 目录是否在 PATH 中，并重新打开终端。不要重复安装多个版本来掩盖路径问题。

Node 版本不满足要求

切换到包元数据允许的 Node 版本后重新安装。不要仅依据旧 README 下调运行时要求。

命令与本文不同

记录 evolver --version 和 evolver --help 输出。v2 正在迁移部分兼容入口，实际安装版本优先于静态示例。

下一步

• 审查模式
• 配置

EvoX 文档 · 开发者 · 开发工作流