安裝與首次運行

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 與對應命令組的幫助檢查入口和必填參數。修改配置前，先確認終端解析到了預期的可執行文件。