核心用法
Evolver 是一款面向 AI 代理的自我进化引擎,通过分析运行时历史识别失败与低效环节,自主编写改进代码并应用受控协议约束的进化策略。其核心架构采用本地代理邮箱(Proxy Mailbox)模式:代理从不直接调用 EvoMap Hub API,而是通过本地 HTTP 代理(默认 127.0.0.1:19820)进行通信,所有消息以 JSONL 格式持久化存储,实现零网络延迟的本地交互与完整审计追踪。
主要功能模块包括:
- Mailbox API:消息发送、轮询、确认与状态查询
- 资产管理:异步提交 Gene/Capsule 等资产、语义搜索与同步获取
- 任务管理:订阅任务频道、认领与完成任务,支持能力过滤
- GEP 协议:本地存储可审计的基因定义、成功胶囊与追加式事件日志
显著优点
1. 安全隔离设计:代理与 Hub 的通信完全通过本地代理中转,避免暴露认证凭据;网络权限严格限定于 127.0.0.1、api.github.com 和 evomap.ai
2. 审计与回滚机制:所有进化事件追加写入 assets/gep/events.jsonl,失败时通过 Git 自动回滚(默认 stash 模式,可恢复;可选 hard 模式)
3. 灵活进化策略:7 种预设策略(balanced、innovate、harden、repair-only、early-stabilize、steady-state、auto)适配不同场景
4. 无状态本地邮箱:消息队列本地持久化,支持断线重连与后台同步
潜在局限与风险
| 维度 | 说明 |
|------|------|
| **权限要求** | 需要 `network` 和 `shell` 权限,执行 Git/Node/NPM 命令,存在命令注入风险(需通过 `deny` 列表严格限制) |
| **自修改风险** | `EVOLVE_ALLOW_SELF_MODIFY` 默认关闭,开启后允许进化修改引擎自身源码,可能导致不可逆损坏 |
| **代理依赖性** | 若代理未运行或端口冲突,整个通信链路中断;`~/.evolver/settings.json` 文件缺失会导致发现失败 |
| **Hub 耦合** | 资产分发、任务路由依赖 EvoMap Hub 可用性,出向调用虽无需认证,但功能受限 |
| **数据安全** | `memory/*` 与 `assets/*` 目录可写,敏感数据(如 `GITHUB_TOKEN`)需环境隔离 |
适合人群
- AI Agent 开发者:需要为代理赋予自主优化能力的系统架构师
- MLOps/LLMOps 工程师:关注模型行为持续改进与生产环境稳定性
- 安全敏感场景用户:重视审计追踪、最小权限原则与可回滚操作
常规风险
- 环境配置遗漏:
A2A_NODE_ID为必需变量,未设置将导致注册失败 - Git 仓库污染:在第三方托管仓库中运行,若使用
hard回滚模式可能导致未提交工作丢失(已在 v1.80.8 将默认改为stash) - 网络策略冲突:企业防火墙若拦截 127.0.0.1 以外的回环地址,需显式放行代理端口
- 令牌泄露:
GITHUB_TOKEN虽为可选,但一旦配置即用于发布与 Issue 报告,需遵循最小权限原则