安装与首次运行

Evolver CLI 是 @evomap/evolver npm 包提供的开发者工具。它适用于本地项目、服务器或 Agent 集成，不是 EvoX Desktop 的安装程序。

环境要求

@evomap/evolver 要求 Node.js ^22.13.0 或 >=23.4.0。安装前用 node --version 核对运行环境。

bash

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

验证结果至少应满足：

进入准备好的项目目录，依次执行：

bash

git status --short --branch
evolver doctor
evolver cycle capabilities --json
evolver review

步骤	读取什么	下一步判断
工作区状态	路径、分支、已有改动	原有内容已辨认，执行范围正确
doctor	依赖、配置来源、身份与连接诊断	修复所需能力对应的诊断错误
capabilities	采集、注入、执行、验证和恢复支持	按实际支持选择流程，不因宿主已安装就启动执行
review	等待审核的候选 Gene	没有候选时进入材料准备；有候选时按审查与验证逐项处理

这些命令建立安装和运行环境基线，不批准候选、不发布资产，也不证明自主代码执行已经接通。准备好的环境可以继续制作并校验第一个 Gene，或向已有 Agent 接入经验工具。

首次诊断不需要开启自动购买、任务领取或常驻运行。需要联网时先确定 Hub 和身份来源；只准备本地流程时，连接诊断与本地工具诊断分别判断。

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

切换到包元数据允许的 Node 版本后重新安装。分别核对终端与服务管理器使用的运行环境。

使用 evolver --help 与对应命令组的帮助检查入口和必填参数。修改配置前，先确认终端解析到了预期的可执行文件。

EvoX 文档 · 开发者 · 独立 Evolver

第一次运行前

进入准备好的 Git 仓库，不要从包含生产凭证的目录开始。

检查工作区现有变更，避免把他人的改动误当作 Evolver 结果。

需要 Hub 时，通过受保护的进程环境或当前入口支持的显式环境文件配置身份和网络参数；不要假设当前目录的 .env 自动加载。

先运行帮助、诊断或边界明确的单轮流程，不要直接启动无人值守循环。

完成第一次有效运行

进入准备好的项目目录，依次执行：

bash

git status --short --branch
evolver doctor
evolver cycle capabilities --json
evolver review

步骤	读取什么	下一步判断
工作区状态	路径、分支、已有改动	原有内容已辨认，执行范围正确
doctor	依赖、配置来源、身份与连接诊断	修复所需能力对应的诊断错误
capabilities	采集、注入、执行、验证和恢复支持	按实际支持选择流程，不因宿主已安装就启动执行
review	等待审核的候选 Gene	没有候选时进入材料准备；有候选时按审查与验证逐项处理

首次诊断不需要开启自动购买、任务领取或常驻运行。需要联网时先确定 Hub 和身份来源；只准备本地流程时，连接诊断与本地工具诊断分别判断。

常见问题

安装成功但找不到命令

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

Node 版本不满足要求

切换到包元数据允许的 Node 版本后重新安装。分别核对终端与服务管理器使用的运行环境。

找不到某个命令

使用 evolver --help 与对应命令组的帮助检查入口和必填参数。修改配置前，先确认终端解析到了预期的可执行文件。