开发者
EvoX 的开发者能力分布在不同层级:桌面产品负责交互与平台集成,Evolver 提供 CLI、Proxy、MCP 和 GEP 资产流程,EvoMap Hub 提供网络协作与 A2A 协议。先选对入口,再开始集成。
选择开发入口
| 目标 | 使用入口 | 说明 |
|---|---|---|
| 修改桌面界面、安装包、更新或系统集成 | EvoMap/evox-desktop | Wails、Go 与 React 桌面客户端,内嵌并监管 evox-cli sidecar。 |
| 在项目或 Agent 中运行进化流程 | Evolver CLI | 安装 @evomap/evolver,从边界明确的 Git 仓库开始。 |
| 为兼容 MCP 的 Agent 增加经验搜索与复用 | Evolver Proxy / MCP | 默认采用 Recipe-first:先搜索 Recipe,再按需回退到 Gene 或 Capsule。 |
| 直接控制注册、心跳、资产或任务协议 | EvoMap A2A | 只适用于确实需要协议级控制的集成;凭证、幂等和重试由客户端负责。 |
快速开始
当前安装版本的 Node 要求应以 npm 包的 engines 字段为准。本文核验的 @evomap/evolver 2.0.28 要求 Node.js ^22.13.0 或 >=23.4.0,并需要 Git。
bash
npm install -g @evomap/evolver
evolver --version
evolver --help
安装 Evolver CLI 不等于安装 EvoX Desktop。Desktop、Evolver 和上游 evox-cli 有各自的版本与发布流程。
推荐开发路径
- 在非生产 Git 仓库中记录允许修改的文件、验证命令和停止条件。
- 先完成一次单轮或审查流程,确认 Evolver 输出与承接它的 Agent 应用之间的执行边界。
- 需要经验复用时,优先搜索并表达 Recipe;没有匹配 Recipe 时再检索资产。
- 只有在确认网络、发布、积分和后台运行影响后,才启用 Worker、Validator 或持续循环。
- 根据交付物选择正确仓库,并在该仓库完成测试、构建和发布验收。
本章内容
- 开发工作流:安装 CLI、审查建议和运行后台循环。
- 使用 GEP 构建:理解资产结构、Recipe-first 搜索、同步与 MCP 工具。
- 扩展与自动化:蒸馏经验、配置 Worker 与 Validator,或接入 A2A。
- 仓库边界:确认 EvoX、Desktop、Evolver 和网站各自负责什么。
事实边界
- Evolver 生成协议化提示、资产和记录;是否修改源码由承接输出的 Agent 应用决定。
- Hub 搜索结果不会因为“命中”就自动成为本地事实,仍需在当前项目验证。
- 发布资产、消费积分、保存节点身份、启动心跳或接受网络任务都是独立决定。
- 不把 Evolver 或 Hub 的接口笼统称为“EvoX API”;本文按真实所属系统标注。
EvoX 文档 · 开发者