🧬 Evolver.php 项目深度分析报告

3.2 数据库层 (Database.php)

Schema 版本：1.6.0

核心表结构：

-- Genes 表 (策略模板)
CREATE TABLE genes (
    id TEXT PRIMARY KEY,
    category TEXT NOT NULL DEFAULT 'repair',
    asset_id TEXT,              -- SHA-256 内容哈希
    schema_version TEXT DEFAULT '1.6.0',
    data TEXT NOT NULL,         -- JSON 编码的完整基因数据
    created_at TEXT,
    updated_at TEXT
);

-- Capsules 表 (成功快照)
CREATE TABLE capsules (
    id TEXT PRIMARY KEY,
    gene_id TEXT,
    asset_id TEXT,
    data TEXT NOT NULL,
    confidence REAL DEFAULT 0.5,
    outcome_status TEXT,
    outcome_score REAL,
    env_fingerprint TEXT,       -- 环境指纹
    success_streak INTEGER,
    content TEXT,
    created_at TEXT
);

-- Events 表 (演化事件记录)
CREATE TABLE events (
    id TEXT PRIMARY KEY,
    intent TEXT NOT NULL,
    signals TEXT,
    genes_used TEXT,
    outcome_status TEXT,
    outcome_score REAL,
    data TEXT NOT NULL,
    env_fingerprint TEXT,
    mutations_tried INTEGER,
    total_cycles INTEGER,
    created_at TEXT
);

-- Failed Capsules 表 (失败记录)
CREATE TABLE failed_capsules (
    id TEXT PRIMARY KEY,
    gene_id TEXT,
    trigger_signals TEXT,
    failure_reason TEXT,
    diff_snapshot TEXT,
    created_at TEXT
);

-- Sync Status 表 (Hub 同步状态)
CREATE TABLE sync_status (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    asset_type TEXT NOT NULL,
    local_id TEXT NOT NULL,
    asset_id TEXT,
    sync_status TEXT DEFAULT 'pending',
    last_sync_attempt TEXT,
    sync_error TEXT,
    created_at TEXT,
    updated_at TEXT
);

性能优化：

PRAGMA journal_mode=WAL;           // WAL 模式 (并发读写)
PRAGMA mmap_size=134217728;        // 128MB 内存映射
PRAGMA synchronous=NORMAL;         // 平衡性能和安全
PRAGMA cache_size=-65536;          // 64MB 缓存
PRAGMA wal_autocheckpoint=1000;    // 自动检查点

自动迁移机制：

• 版本检测 → 增量迁移 → 版本更新
• 支持从 1.5.0 → 1.6.0 的平滑升级
• 迁移日志记录

3.3 信号提取器 (SignalExtractor.php)

信号类型 (35+ 种)：

高级检测算法：

// 修复循环检测 (连续 3 次修复失败)
if ($history['consecutiveRepairCount'] >= 3) {
    $signals[] = 'repair_loop_detected';
}

// 强制创新阈值 (连续 5 次修复)
if ($history['consecutiveRepairCount'] >= 5) {
    $signals[] = 'force_innovation_after_repair_loop';
}

// 停滞检测 (连续 3 次空周期)
if ($history['consecutiveEmptyCycles'] >= 3) {
    $signals[] = 'evolution_stagnation_detected';
}

// 失败率检测 (60% 以上失败)
if ($history['recentFailureRatio'] >= 0.6) {
    $signals[] = 'high_failure_rate';
}

代码亮点：

• ✅ 正则 + 关键词双重匹配
• ✅ 错误签名规范化 (路径/数字/十六进制替换)
• ✅ 历史事件分析 (consecutive patterns)

3.4 基因选择器 (GeneSelector.php)

选择算法：

// 1. 模式匹配 (支持正则)
public function matchPatternToSignals(string $pattern, array $signals): bool
{
    // /regex/i 格式支持
    // 或简单子字符串匹配
}

// 2. 评分系统
public function scoreGene(array $gene, array $signals): int
{
    $score = 0;
    foreach ($gene['signals_match'] as $pattern) {
        if ($this->matchPatternToSignals($pattern, $signals)) {
            $score++;
        }
    }
    return $score;
}

// 3. 漂移选择 (Drift Selection)
// 在最高分基因中随机选择，增加多样性
if ($driftIntensity > 0 && mt_rand() / mt_getrandmax() < $driftIntensity) {
    $selectedIdx = mt_rand(0, $topN - 1);
}

漂移强度计算：

$driftIntensity = min(1.0, 1.0 / sqrt($effectivePopulationSize));
// 基因池越大，漂移强度越小

3.5 GEP 协议构建器 (PromptBuilder.php)

GEP 1.6.0 协议 - 强制输出 5 个 JSON 对象：

1. Mutation (触发器)
{
  "type": "Mutation",
  "category": "repair|optimize|innovate",
  "trigger_signals": ["..."],
  "risk_level": "low|medium|high"
}

2. PersonalityState (心态)
{
  "type": "PersonalityState",
  "rigor": 0.8,
  "creativity": 0.3,
  "risk_tolerance": 0.5
}

3. EvolutionEvent (记录)
{
  "type": "EvolutionEvent",
  "schema_version": "1.6.0",
  "parent": "evt_xxx",
  "blast_radius": {"files": 5, "lines": 120}
}

4. Gene (知识)
{
  "type": "Gene",
  "signals_match": ["..."],
  "strategy": ["step1", "step2"],
  "constraints": {"max_files": 20}
}

5. Capsule (结果快照)
{
  "type": "Capsule",
  "gene": "gene_xxx",
  "confidence": 0.85
}

提示优化：

• ✅ 上下文截断 (20000 字符限制)
• ✅ 信号去重和截断 (最多 50 个)
• ✅ 反模式区域 (失败胶囊警告)
• ✅ 历史块 (最近演化历史)
• ✅ Hub 课程块 (外部知识)

3.6 固化引擎 (SolidifyEngine.php)

安全验证：

// 硬限制
private const MAX_FILES_HARD_LIMIT = 60;
private const MAX_LINES_HARD_LIMIT = 20000;

// 警告阈值
private const BLAST_WARN_RATIO = 0.8;      // 80%
private const BLAST_CRITICAL_RATIO = 2.0;  // 200%

// 命令白名单
private const ALLOWED_COMMAND_PREFIXES = [
    'php', 'composer', 'phpunit', 'phpcs', 'phpstan'
];

// 禁止的 shell 操作符
private const FORBIDDEN_SHELL_OPERATORS = [
    ';', '&&', '||', '|', '>', '<', '`', '$('
];

关键路径保护：

private const CRITICAL_PROTECTED_PREFIXES = [
    'skills/feishu-evolver-wrapper/',
    'skills/feishu-common/',
    'skills/evolver/',
    // ...
];

private const CRITICAL_PROTECTED_FILES = [
    'MEMORY.md', 'SOUL.md', 'IDENTITY.md',
    'composer.json', 'package.json', '.env'
];

验证流程：

1. 检查自修改模式 (never/review/always)
2. 验证文件不在保护列表
3. 检查爆炸半径 (文件数/行数)
4. 验证命令白名单
5. 检测 shell 注入操作符

3.7 安全控制器 (SafetyController.php)

三种安全模式：

操作权限矩阵：

操作          | never | review | always
-------------|-------|--------|--------
read         |   ✅   |   ✅   |   ✅
diagnose     |   ✅   |   ✅   |   ✅
propose      |   ❌   |   ✅   |   ✅
modify       |   ❌   |   ❌   |   ✅

3.8 内容哈希 (ContentHash.php)

SHA-256 资产 ID：

// 规范化 JSON (键排序，数组保序)
public static function canonicalize(mixed $obj): string {
    // 递归处理对象/数组
    // 排除非有限数字
}

// 计算资产 ID (排除自引用字段)
public static function computeAssetId(
    array|object $obj, 
    array $excludeFields = ['asset_id']
): ?string {
    $canonical = self::canonicalize($clean);
    $hash = hash('sha256', $canonical);
    return 'sha256:' . $hash;
}

用途：

• ✅ 去重检测
• ✅ 篡改验证
• ✅ 跨节点一致性

4️⃣ 安全模型深度分析

4.1 多层防护体系

┌─────────────────────────────────────┐
│  SafetyController (模式控制)         │
│  - never/review/always              │
└──────────────┬──────────────────────┘
               │
┌──────────────▼──────────────────────┐
│  SourceProtector (源文件保护)        │
│  - 硬编码保护列表                    │
│  - 模式匹配 (src/Ops/*.php)          │
└──────────────┬──────────────────────┘
               │
┌──────────────▼──────────────────────┐
│  SolidifyEngine (验证引擎)           │
│  - 爆炸半径检查                      │
│  - 命令白名单                        │
│  - Shell 操作符阻止                   │
└──────────────┬──────────────────────┘
               │
┌──────────────▼──────────────────────┐
│  Gene Constraints (基因约束)         │
│  - max_files 限制                    │
│  - forbidden_paths 列表              │
└─────────────────────────────────────┘

4.2 爆炸半径限制

硬限制 (不可逾越)：

• 60 个文件 / 20,000 行 每次演化

• 80% 利用率 → 警告
• 200% 利用率 → 严重警告 (可能批量误操作)

// 自动分析哪些目录贡献最多变更文件
$dirCount = [];
foreach ($changedFiles as $file) {
    $parts = explode('/', $rel);
    $key = $parts[0] . '/' . $parts[1];  // 前两级目录
    $dirCount[$key]++;
}

5️⃣ 测试套件分析

5.1 测试覆盖

测试文件：44 个测试类

• 核心引擎：DatabaseTest, SignalExtractorTest, GeneSelectorTest
• MCP 层：McpServerTest
• 安全：SafetyControllerTest, SourceProtectorTest
• 运维工具：Ops/ 目录下 12 个测试

• ✅ 内存 SQLite (:memory:) 实现隔离
• ✅ setUp/tearDown 清理
• ✅ 断言完整 (assertContains, assertNotEmpty, assertIsArray)

5.2 测试示例

// DatabaseTest.php
public function testDatabaseCreatesSchema(): void
{
    $result = $this->db->fetchAll(
        "SELECT name FROM sqlite_master WHERE type='table'"
    );
    $tables = array_column($result, 'name');
    $this->assertContains('genes', $tables);
    $this->assertContains('capsules', $tables);
}

// SignalExtractorTest.php
public function testExtractRepairLoopDetected(): void
{
    $recentEvents = [
        ['intent' => 'repair', 'outcome' => ['status' => 'failed']],
        ['intent' => 'repair', 'outcome' => ['status' => 'failed']],
        ['intent' => 'repair', 'outcome' => ['status' => 'failed']],
    ];
    $signals = $this->extractor->extract([
        'context' => 'Some context',
        'recentEvents' => $recentEvents,
    ]);
    $this->assertContains('repair_loop_detected', $signals);
}

6️⃣ 运维工具 (Ops 模块)

6.1 可用工具

6.2 命令行工具

# 验证安装
php evolver.php --validate

# 使用自定义数据库
php evolver.php --db /path/to.db

# 连续循环模式
php evolver.php --loop [interval_seconds]

# 守护进程模式
php evolver.php --daemon start
php evolver.php --daemon stop
php evolver.php --daemon status

# Ops 命令
php evolver.php --ops cleanup
php evolver.php --ops health
php evolver.php --ops stats
php evolver.php --ops gc
php evolver.php --ops dedupe

7️⃣ GEP 协议详解

7.1 协议流程

1. evolver_run 工具调用
   ↓
2. SignalExtractor.extract() 提取信号
   ↓
3. GeneSelector.selectGene() 选择基因
   ↓
4. PromptBuilder.buildGepPrompt() 构建提示
   ↓
5. LLM 输出 5 个 JSON 对象
   ↓
6. 应用更改 (MCP 客户端执行)
   ↓
7. evolver_solidify 固化结果
   ↓
8. 记录 EvolutionEvent + 更新 Gene/Capsule

7.2 协议版本演进

版本不一致问题：

• ⚠️ ContentHash::SCHEMA_VERSION = '1.6.0'
• ⚠️ PromptBuilder::SCHEMA_VERSION = '1.5.0' (在代码中未明确，需检查)

8️⃣ 默认基因分析

8.1 种子基因 (6 个)

data/default_genes.json

8.2 基因结构

{
  "type": "Gene",
  "id": "gene_gep_repair_from_errors",
  "category": "repair",
  "signals_match": ["error", "exception", "log_error"],
  "preconditions": ["signals contains error-related indicators"],
  "strategy": [
    "Extract structured signals from logs",
    "Select an existing Gene by signals match",
    "Estimate blast radius before editing",
    "Apply smallest reversible patch",
    "Validate using declared validation steps"
  ],
  "constraints": {
    "max_files": 20,
    "forbidden_paths": [".git", "vendor", "node_modules"]
  },
  "validation": ["php -l src/*.php", "php evolver.php --validate"]
}

9️⃣ A2A 协议 (Agent-to-Agent)

9.1 核心功能

A2A.php

• 资产类型：Gene, Capsule, EvolutionEvent
• 置信度衰减：外部资产置信度 × 0.6
• 爆炸半径限制：maxFiles=5, maxLines=200
• 成功条纹计算：连续成功使用次数

9.2 同步机制

// sync_status 表追踪同步状态
CREATE TABLE sync_status (
    asset_type TEXT NOT NULL,  // 'Gene' | 'Capsule' | 'Event'
    local_id TEXT NOT NULL,
    asset_id TEXT,             // SHA-256
    sync_status TEXT,          // 'pending' | 'synced' | 'failed'
    last_sync_attempt TEXT,
    sync_error TEXT
);

🔟 知识图谱 (MemoryGraph.php)

10.1 功能

• 信号→基因→结果 边追踪
• Laplace 平滑成功概率
• 衰减机制 (时间衰减)
• 错误签名规范化

10.2 错误签名规范化

// 路径替换
s = preg_replace('/[a-z]:\\[^\\s\\n\\r\\t]+/i', '<path>', s);
s = preg_replace('~/[^\\s\\n\\r\\t]+~', '<path>', s);

// 十六进制和数字替换
s = preg_replace('/\\b0x[0-9a-f]+\\b/i', '<hex>', s);
s = preg_replace('/\\b\\d+\\b/', '<n>', s);

// 输出：errsig_norm:<hash>

1️⃣1️⃣ 代码质量评估

11.1 优点 ✅

11.2 潜在问题 ⚠️

1️⃣2️⃣ 与原始 evolver 对比

优势：

• ✅ 零 npm 依赖，仅 Composer
• ✅ 更简单的部署 (单个 PHP 文件 + SQLite)
• ✅ 完全本地化，无网络依赖
• ✅ 增强的安全模型 (SourceProtector)

1️⃣3️⃣ 使用场景推荐

13.1 适用场景 ✅

1. AI 辅助开发环境 - 与 Claude Desktop/Kimi CLI 集成
2. 自演化代码库 - 自动修复错误、优化性能
3. 知识积累系统 - Gene/Capsule 双轨存储成功经验
4. 安全沙箱实验 - review 模式下人工确认所有修改
5. 持续集成 - 自动检测和修复测试失败

13.2 不适用场景 ❌

1. 高并发 Web 服务 - 非设计目标
2. 分布式系统 - 单节点 SQLite 限制
3. 实时性要求高 - 演化周期需要时间
4. 无 AI 环境 - 依赖 LLM 生成代码

1️⃣4️⃣ 最佳实践建议

14.1 部署配置

# 推荐环境变量
export EVOLVER_DB_PATH=~/.evolver/evolver.db
export EVOLVE_ALLOW_SELF_MODIFY=review  # 开发环境
export WORKSPACE_DIR=/path/to/workspace

# MCP 配置 (Kimi CLI)
{
  "mcpServers": {
    "evolver": {
      "command": "php",
      "args": ["/path/to/evolver.php"],
      "env": {
        "EVOLVER_DB_PATH": "~/.evolver/evolver.db",
        "EVOLVE_ALLOW_SELF_MODIFY": "review"
      }
    }
  }
}

14.2 运维建议

1. 定期备份数据库：

• 定期备份 SQLite 数据库
• 监控爆炸半径和演化频率