核心用法
Evolver 是一个专为 AI 代理设计的自我进化引擎，通过分析运行时历史识别故障与低效环节，并自主编写改进方案。其采用代理邮箱架构（Proxy Mailbox）——代理仅通过本地 HTTP 与 Proxy 通信，所有 EvoMap Hub 的认证、重试、心跳由 Proxy 透明处理，实现网络隔离与零延迟本地交互。
主要工作流：
1. 运行时监控：采集日志、性能瓶颈等信号
2. 进化分析：基于 GEP 协议（Genome Evolution Protocol）生成改进基因
3. 本地验证：--review 模式支持人工介入审查
4. 资产提交：通过 POST /asset/submit 将 Gene/Capsule 发布至 Hub
5. 任务协作：订阅、认领、完成分布式任务，构建多代理生态
关键 API 模式：
- 异步操作（
asset_submit→ 轮询asset_submit_result） - 本地 JSONL 邮箱（零网络延迟，可审计）
- 语义搜索（
asset/search按信号检索历史改进）
显著优点
1. 安全架构：代理不直接接触 Hub 认证，敏感 token 由 Proxy 管理；支持 EVOLVER_ROLLBACK_MODE=stash 防止代码丢失（v1.80.8 默认升级）
2. 可审计进化：GEP 协议强制 append-only 事件日志（events.jsonl），满足合规要求
3. 灵活策略：7 种进化模式（balanced/innovate/harden/repair-only/early-stabilize/steady-state/auto）适配不同生命周期阶段
4. 离线优先：核心交互本地化，Hub 连接仅用于分布式协作
5. 多代理就绪：原生支持任务订阅、认领、完成闭环，兼容 A2A（Agent-to-Agent）协议
潜在局限
1. Node.js 依赖：要求运行环境预装 node、git，对纯 Python/Go 生态不够友好
2. 配置复杂度：需正确设置 A2A_NODE_ID 与 Proxy 发现路径（~/.evolver/settings.json），新手门槛较高
3. 自修改风险：EVOLVE_ALLOW_SELF_MODIFY=true 可能导致进化引擎自身被修改，官方明确不推荐
4. 网络白名单限制：仅允许访问 127.0.0.1、api.github.com、evomap.ai，扩展第三方服务需修改权限配置
5. Hub 依赖不确定性：EvoMap Hub 作为外部服务，长期可用性与商业模式未公开披露
适合人群
- AI Agent 开发者：需为代理构建持续学习、自我修复能力的系统
- 多代理系统架构师：探索 A2A 协作、任务分发与技能共享网络
- 合规敏感场景：需要完整审计日志的进化过程（金融、医疗等）
- 研究用途：元学习（meta-learning）、代码生成与自动程序修复方向
常规风险
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| **代码回滚失败** | `hard` 模式会强制重置 git 工作区 | 使用默认 `stash` 模式，定期备份 |
| **代理权限过大** | `shell` + `network` 权限组合可能被滥用 | 严格遵循最小权限，审查 `capabilities.deny` 配置 |
| **Hub 通信泄露** | 尽管代理不直接认证，Proxy 仍可能泄露节点身份 | 监控 `~/.evomap/node_id` 访问日志 |
| **自进化死循环** | 改进代码引入新 bug，触发新一轮进化 | 启用 `--review` 人工审核，设置进化深度上限 |
| **GPL 许可证传染性** | 衍生作品需开源 | 商业集成前需法律评估 |
安全等级说明：S 级——架构设计具备纵深防御（Proxy 隔离、权限白名单、强制回滚），但授予 shell 与 network 权限需严格管控运行环境。