evolution-core

Evolution Core — 自进化资产模型与闭环

用途

• 即时复用：agent 遇到错误时，先从进化存储中查找匹配的已验证经验（Capsule），尝试重放，成功则跳过 LLM 推理
• 经验沉淀：每次成功解决问题后，自动提取信号、生成策略 Gene 和执行快照 Capsule
• 跨 agent 共享：不同 agent/项目的验证过经验可以发布到共享网络，其他 agent 直接复用
• 治理安全：通过 Governor 控制进化速率、爆炸半径和回归检测，防止低质量策略扩散

核心概念

Gene — 策略 DNA

Gene 是一条可复用的问题解决策略，从一次或多次成功经验中提取并泛化：

{
  "gene_id": "g-a1b2c3d4",
  "signals": [
    {
      "signal_type": "compiler_error",
      "source": "compiler",
      "pattern": "Cannot find module '(.+)'",
      "context_hints": ["typescript", "import"]
    }
  ],
  "strategy": {
    "description": "检查 tsconfig.json paths 配置和 package.json dependencies，确认模块存在后重新安装",
    "steps": [
      "检查 tsconfig.json 中 paths 和 baseUrl 配置",
      "检查 package.json 中是否包含该依赖",
      "运行 npm install 或对应包管理器安装命令",
      "若为路径别名问题，更新 tsconfig paths"
    ],
    "constraints": ["不要直接删除 node_modules 重装，先定位根因"]
  },
  "validation_rules": {
    "success_indicator": "tsc 编译通过，无 Cannot find module 错误",
    "timeout_seconds": 120
  },
  "confidence": 0.75,
  "state": "promoted",
  "tags": ["typescript", "module-resolution", "build-error"],
  "env_fingerprint": {
    "languages": ["typescript"],
    "frameworks": ["next.js"],
    "tools": ["npm"]
  },
  "stats": {
    "total_uses": 12,
    "successes": 10,
    "failures": 2,
    "last_used": "2026-04-01T10:30:00Z"
  },
  "created_at": "2026-03-15T08:00:00Z",
  "updated_at": "2026-04-01T10:30:00Z"
}

Gene 状态生命周期：

candidate → promoted → archived
    ↓           ↓
  revoked    quarantined → (re-promoted | revoked)

状态	含义
candidate	新提取，尚未达到晋升门槛
promoted	经过多次验证，高置信度可用
quarantined	从外部导入或连续失败，需本地验证
revoked	多次失败或人工标记无效
archived	长期未使用，自动归档

Capsule — 已验证经验快照

Capsule 是 Gene 的一次具体执行记录，包含完整的上下文和结果：

{
  "capsule_id": "c-e5f6g7h8",
  "gene_ref": "g-a1b2c3d4",
  "execution_context": {
    "project_id": "proj-xyz",
    "agent_id": "agent-session-001",
    "trigger_signal": {
      "signal_type": "compiler_error",
      "source": "compiler",
      "raw_message": "Cannot find module '@/utils/helpers'",
      "file_path": "src/pages/index.tsx"
    }
  },
  "outcome": {
    "success": true,
    "changes_summary": "更新 tsconfig.json paths 配置，添加 @/ → src/ 映射",
    "diff_hash": "sha256:abc123...",
    "files_changed": ["tsconfig.json"],
    "lines_modified": 3,
    "duration_seconds": 15
  },
  "env_fingerprint": {
    "os": "darwin",
    "node_version": "20.x",
    "typescript_version": "5.4",
    "package_manager": "npm"
  },
  "confidence": 0.85,
  "created_at": "2026-04-01T10:30:00Z"
}