Evolver.php

Category: Tools & Productivity | Uploader: linkerlin | Downloads: 0 | Version: v1.0（Latest）

Evolver.php 是一个自进化引擎，赋予 AI Agent 自我诊断、自我修复和自我优化的能力。当检测到代码错误、性能瓶颈或功能需求时，自动触发进化流程。

Changelog: Source: GitHub https://github.com/linkerlin/Evolver.php

Directory Structure

Current level: Root

📁 .evolver/
- 📁 output/
  - 📄 00_Task_Brief.md 5.8 KB
  - 📄 01_Outline.md 8.1 KB
  - 📄 lw_project.json 4.6 KB
  - 📄 🧬 Evolver.php 从入门到进化 🧬.md 30.2 KB
📁 assets/
- 📁 gep/
  - 📄 assets.db 88.0 KB
📁 data/
- 📁 archive/
  - 📄 BLAST_RADIUS_ENHANCEMENT_REPORT.md 6.6 KB
  - 📄 IMPROVEMENT_PLAN.md 14.8 KB
  - 📄 SOLIDIFY_ENGINE_AUDIT.md 6.3 KB
  - 📄 剩余工作完成报告.md 3.5 KB
  - 📄 剩余工作执行报告.md 4.5 KB
  - 📄 后馈演化改进方案.md 26.1 KB
  - 📄 改进实施总结.md 7.2 KB
  - 📄 改进意见.md 7.5 KB
  - 📄 改进方案和计划.md 10.3 KB
  - 📄 改进方案和计划_v2.md 39.0 KB
  - 📄 改进方案和计划_v2_COMPLETED.md 9.2 KB
  - 📄 改进计划.md 8.9 KB
  - 📄 改进计划实施进展_2026-03-03.md 7.0 KB
  - 📄 长期记忆改进方案.md 30.2 KB
- 📄 default_genes.json 4.4 KB
📁 scripts/
- 📄 analyze_by_skill.php 6.8 KB
- 📄 evolver-a2a-export.php 2.6 KB
- 📄 evolver-a2a-ingest.php 4.2 KB
- 📄 evolver-gep-append-event.php 4.4 KB
- 📄 evolver-human-report.php 7.4 KB
- 📄 evolver-personality-report.php 8.5 KB
- 📄 evolver-report.php 6.6 KB
- 📄 evolver-validate.php 4.2 KB
- 📄 metrics_server.php 13.4 KB
- 📄 p3_demo.php 7.1 KB
- 📄 recover_loop.php 8.9 KB
📁 src/
- 📁 Ops/
  - 📄 BenchmarkTool.php 8.6 KB
  - 📄 Commentary.php 2.1 KB
  - 📄 DaemonManager.php 6.3 KB
  - 📄 DiskCleaner.php 6.4 KB
  - 📄 GitSelfRepair.php 8.9 KB
  - 📄 HealthCheck.php 7.1 KB
  - 📄 Innovation.php 4.6 KB
  - 📄 LifecycleManager.php 5.5 KB
  - 📄 OpsManager.php 7.5 KB
  - 📄 SecurityAuditLogger.php 7.7 KB
  - 📄 SignalDeduplicator.php 7.7 KB
  - 📄 SkillsMonitor.php 6.6 KB
  - 📄 StructuredLogger.php 7.3 KB
  - 📄 Trigger.php 1.4 KB
- 📄 A2A.php 9.7 KB
- 📄 Analyzer.php 2.9 KB
- 📄 AssetCallLog.php 8.5 KB
- 📄 Assets.php 2.5 KB
- 📄 BlastRadiusCalculator.php 18.0 KB
- 📄 Bridge.php 2.9 KB
- 📄 Canary.php 2.4 KB
- 📄 Candidates.php 14.0 KB
- 📄 ContentHash.php 4.3 KB
- 📄 Database.php 27.8 KB
- 📄 DecayableMemory.php 951 B
- 📄 DecayEngine.php 7.5 KB
- 📄 DecayScore.php 739 B
- 📄 DeviceId.php 12.1 KB
- 📄 EmbedderInterface.php 857 B
- 📄 EnvFingerprint.php 12.9 KB
- 📄 EvolutionLoop.php 6.3 KB
- 📄 EvolverConfig.php 13.2 KB
- 📄 EvoMapClient.php 9.5 KB
- 📄 ExtractionPrompts.php 8.9 KB
- 📄 FeedbackMetrics.php 12.0 KB
- 📄 GdiCalculator.php 7.2 KB
- 📄 GeneSelector.php 30.4 KB
- 📄 GepA2AProtocol.php 17.5 KB
- 📄 GepAssetStore.php 16.8 KB
- 📄 GepValidator.php 9.5 KB
- 📄 HubReview.php 11.6 KB
- 📄 HubSearch.php 7.0 KB
- 📄 InputValidator.php 16.5 KB
- 📄 IssueReporter.php 14.3 KB
- 📄 LearningSignals.php 10.9 KB
- 📄 LlmClient.php 6.3 KB
- 📄 LlmReview.php 5.7 KB
- 📄 LocalLLMSupport.php 10.8 KB
- 📄 McpServer.php 81.6 KB
- 📄 MemoryCategory.php 2.5 KB
- 📄 MemoryGraph.php 27.0 KB
- 📄 MemoryGraphAdapter.php 7.9 KB
- 📄 MemoryRetriever.php 10.0 KB
- 📄 Mutation.php 10.3 KB
- 📄 NarrativeMemory.php 7.2 KB
- 📄 NullEmbedder.php 464 B
- 📄 OpenAIEmbedder.php 3.0 KB
- 📄 ParallelGeneScorer.php 6.6 KB
- 📄 Paths.php 4.6 KB
- 📄 Personality.php 17.2 KB
- 📄 PromptBuilder.php 25.8 KB
- 📄 QuestionGenerator.php 11.4 KB
- 📄 Reflection.php 7.6 KB
- 📄 RetrievalResult.php 2.4 KB
- 📄 SafetyController.php 6.8 KB
- 📄 Sanitize.php 3.0 KB
- 📄 SessionLogReader.php 16.1 KB
- 📄 SessionScope.php 3.7 KB
- 📄 SignalExtractor.php 32.1 KB
- 📄 SimpleDecayableMemory.php 2.4 KB
- 📄 SkillDistiller.php 46.1 KB
- 📄 SkillPublisher.php 11.8 KB
- 📄 SmartExtractor.php 20.1 KB
- 📄 SmartMetadata.php 8.4 KB
- 📄 SolidifyEngine.php 52.5 KB
- 📄 SourceProtector.php 6.9 KB
- 📄 StrategyConfig.php 15.7 KB
- 📄 TaskReceiver.php 23.5 KB
- 📄 TierManager.php 8.7 KB
- 📄 TierTransition.php 1.1 KB
- 📄 ValidationReport.php 3.1 KB
- 📄 VectorStore.php 8.3 KB
📁 tests/
- 📁 fixtures/
  - 📄 create_test_db.php 3.0 KB
  - 📄 test_evolver.db 144.0 KB
- 📁 Ops/
  - 📄 BenchmarkToolTest.php 1.7 KB
  - 📄 CommentaryTest.php 832 B
  - 📄 DaemonManagerTest.php 6.5 KB
  - 📄 GitSelfRepairTest.php 5.2 KB
  - 📄 HealthCheckTest.php 5.5 KB
  - 📄 InnovationTest.php 364 B
  - 📄 OpsManagerTest.php 8.2 KB
  - 📄 SecurityAuditLoggerTest.php 9.1 KB
  - 📄 SignalDeduplicatorTest.php 3.0 KB
  - 📄 SkillsMonitorTest.php 1.2 KB
  - 📄 StructuredLoggerTest.php 8.5 KB
  - 📄 TriggerTest.php 4.7 KB
- 📄 A2ATest.php 5.1 KB
- 📄 AnalyzerTest.php 3.5 KB
- 📄 AssetCallLogTest.php 6.9 KB
- 📄 AssetsTest.php 3.3 KB
- 📄 BlastRadiusCalculatorTest.php 9.8 KB
- 📄 BridgeTest.php 4.1 KB
- 📄 CanaryTest.php 2.9 KB
- 📄 CandidatesEnhancedTest.php 14.8 KB
- 📄 CandidatesTest.php 1.8 KB
- 📄 ContentHashTest.php 4.4 KB
- 📄 DatabaseTest.php 2.9 KB
- 📄 DecayEngineTest.php 16.5 KB
- 📄 DeviceIdTest.php 2.1 KB
- 📄 EmbedderTest.php 3.4 KB
- 📄 EnvFingerprintTest.php 3.9 KB
- 📄 EvolutionLoopTest.php 2.0 KB
- 📄 EvolverTest.php 102.2 KB
- 📄 EvoMapClientTest.php 5.8 KB
- 📄 FeedbackMetricsTest.php 1.7 KB
- 📄 GdiCalculatorTest.php 10.2 KB
- 📄 GeneSelectorTest.php 5.2 KB
- 📄 GepA2AProtocolTest.php 7.1 KB
- 📄 GepAssetStoreTest.php 12.6 KB
- 📄 GepValidatorTest.php 11.1 KB
- 📄 HubReviewTest.php 9.5 KB
- 📄 HubSearchTest.php 8.9 KB
- 📄 InputValidatorTest.php 7.5 KB
- 📄 IssueReporterTest.php 13.2 KB
- 📄 LearningSignalsTest.php 16.4 KB
- 📄 LlmClientTest.php 3.5 KB
- 📄 LlmReviewTest.php 7.2 KB
- 📄 McpServerTest.php 23.7 KB
- 📄 MemoryCategoryTest.php 7.7 KB
- 📄 MemoryGraphAdapterTest.php 8.0 KB
- 📄 MemoryGraphTest.php 3.3 KB
- 📄 MemoryRetrieverTest.php 2.1 KB
- 📄 MutationTest.php 6.0 KB
- 📄 NarrativeMemoryTest.php 7.1 KB
- 📄 PersonalityTest.php 4.7 KB
- 📄 PromptBuilderEnhancedTest.php 8.5 KB
- 📄 PromptBuilderTest.php 5.8 KB
- 📄 QuestionGeneratorTest.php 1.7 KB
- 📄 ReflectionTest.php 9.8 KB
- 📄 RetrievalResultTest.php 3.2 KB
- 📄 SafetyControllerTest.php 5.2 KB
- 📄 SanitizeTest.php 6.8 KB
- 📄 ScriptGepAppendEventTest.php 10.0 KB
- 📄 ScriptHumanReportTest.php 5.8 KB
- 📄 SessionLogReaderTest.php 8.2 KB
- 📄 SessionScopeTest.php 8.3 KB
- 📄 SignalExtractorEnhancedTest.php 9.5 KB
- 📄 SignalExtractorTest.php 4.7 KB
- 📄 SkillDistillerEnhancedTest.php 15.1 KB
- 📄 SkillDistillerTest.php 12.2 KB
- 📄 SkillPublisherTest.php 6.9 KB
- 📄 SmartMetadataTest.php 15.5 KB
- 📄 SolidifyEngineTest.php 11.4 KB
- 📄 SourceProtectorTest.php 3.8 KB
- 📄 TaskReceiverTest.php 15.2 KB
- 📄 TierManagerTest.php 15.0 KB
- 📄 VectorStoreTest.php 9.3 KB
📁 ~/
- 📁 .evolver/
  - 📄 evolver.db 144.0 KB
📄 .gitignore 513 B
📄 AGENTS.md 7.7 KB
📄 CHANGELOG.md 5.0 KB
📄 composer.json 644 B
📄 evolver.php 8.7 KB
📄 LICENSE 11.1 KB
📄 phpunit.xml 761 B
📄 README.md 16.9 KB
📄 SKILL.md 7.4 KB
📄 test_regex.php 501 B
📄 test_same.php 516 B
📄 test_sanitize.php 1.9 KB
📄 TODO.md 2.0 KB
📄 改进方案和计划_v3.md 13.0 KB
📄 更新方案_v4_从evolver移植.md 8.9 KB

SKILL.md

# Evolver.php Skill

## 概述

Evolver.php 是一个自进化引擎，赋予 AI Agent 自我诊断、自我修复和自我优化的能力。当检测到代码错误、性能瓶颈或功能需求时，自动触发进化流程。

## 触发条件

### 自动触发场景

1. **代码错误修复**
   - PHP 语法错误、运行时异常
   - 未定义变量、类型错误
   - 数据库连接失败、API 超时
   - **操作**: 提取错误日志 → 调用 evolver_extract_signals → 调用 evolver_run

2. **性能优化**
   - 响应时间超过阈值
   - 内存使用过高
   - 数据库查询缓慢
   - **操作**: 收集性能数据 → 调用 evolver_extract_signals → 调用 evolver_run (strategy: harden)

3. **功能扩展**
   - 用户请求新功能
   - 需要添加新的 API 端点
   - 需要集成第三方服务
   - **操作**: 收集需求描述 → 调用 evolver_run (strategy: innovate)

4. **安全加固**
   - 检测到安全漏洞
   - 需要输入验证
   - 需要添加权限检查
   - **操作**: 收集安全信息 → 调用 evolver_extract_signals → 调用 evolver_run (strategy: harden)

### 调用前必须做的事

**在调用任何 MCP 工具前，必须先收集以下信息**：

1. **错误日志** - 完整的错误信息、堆栈跟踪
2. **上下文** - 发生错误的代码位置、相关文件
3. **用户意图** - 是修复错误、优化性能还是添加功能

**禁止行为**:
- ❌ 不提供任何参数就调用 evolver_extract_signals
- ❌ 不提供上下文就调用 evolver_run
- ❌ 不确认用户意图就执行修改

## MCP Tools 调用指南

### 1. 信号提取 (evolver_extract_signals)

**何时调用**: 收到错误日志或异常信息时

**必需参数**: 必须提供 `logContent` 或 `context` 之一

**参数**:
```json
{
  "logContent": "错误日志内容（必需，如果没有提供context）",
  "context": "上下文信息（必需，如果没有提供logContent）",
  "includeHistory": true
}
```

**重要**: 如果不提供 `logContent` 或 `context`，将返回空信号列表。

**正确示例**:
```
用户报告: "PHP Fatal error: Uncaught Error: Call to undefined function processData()"

→ 调用 evolver_extract_signals
→ 参数: {"logContent": "PHP Fatal error: Uncaught Error: Call to undefined function processData() in /app/src/Processor.php:42"}
```

**错误示例**:
```
→ 调用 evolver_extract_signals
→ 参数: {}  // ❌ 错误：没有提供 logContent 或 context
→ 结果: {"signals": [], "count": 0}  // 空结果
```

### 2. 运行进化 (evolver_run)

**何时调用**: 需要生成修复/优化方案时

**策略选择**:
- `repair-only`: 紧急修复错误，不添加新功能
- `balanced`: 平衡修复和优化
- `innovate`: 添加新功能
- `harden`: 安全加固

**参数**:
```json
{
  "context": "问题描述和上下文",
  "strategy": "repair-only|balanced|innovate|harden",
  "driftEnabled": false
}
```

**示例**:
```
→ 调用 evolver_run
→ 参数: {
  "context": "修复 Processor.php 第42行的未定义函数 processData 错误",
  "strategy": "repair-only"
}
```

### 3. 固化结果 (evolver_solidify)

**何时调用**: 成功应用修复后

**参数**:
```json
{
  "intent": "repair|optimize|innovate",
  "summary": "一句话描述修改内容",
  "signals": ["信号列表"],
  "blastRadius": {"files": 1, "lines": 10},
  "modifiedFiles": ["修改的文件路径"]
}
```

**示例**:
```
→ 调用 evolver_solidify
→ 参数: {
  "intent": "repair",
  "summary": "Added missing processData() function to Processor class",
  "signals": ["log_error", "undefined_function"],
  "blastRadius": {"files": 1, "lines": 15},
  "modifiedFiles": ["src/Processor.php"]
}
```

## 完整工作流程

### 场景 1: 修复 PHP 错误

```
1. 用户报告错误
   ↓
2. 调用 evolver_extract_signals 提取信号
   ↓
3. 调用 evolver_run 生成修复方案
   ↓
4. 向用户展示修复建议
   ↓
5. 用户确认后应用修复
   ↓
6. 调用 evolver_solidify 固化结果
```

### 场景 2: 添加新功能

```
1. 用户请求新功能
   ↓
2. 调用 evolver_run (strategy: innovate)
   ↓
3. 获取实现方案
   ↓
4. 实现代码
   ↓
5. 调用 evolver_solidify (intent: innovate)
```

### 场景 3: 性能优化

```
1. 检测到性能问题
   ↓
2. 调用 evolver_run (strategy: harden)
   ↓
3. 获取优化建议
   ↓
4. 应用优化
   ↓
5. 调用 evolver_solidify (intent: optimize)
```

## 辅助 Tools

### 查看状态

- `evolver_stats`: 获取数据库统计信息
- `evolver_safety_status`: 查看安全模式和保护配置
- `evolver_list_genes`: 查看可用的进化策略
- `evolver_list_capsules`: 查看成功案例

### 管理操作

- `evolver_cleanup`: 清理旧日志和临时文件
- `evolver_upsert_gene`: 添加自定义策略
- `evolver_delete_gene`: 删除策略

## 安全注意事项

### 自动检查清单

在应用任何修改前，确认:

1. **blastRadius** 在可接受范围内
   - files ≤ 60
   - lines ≤ 20000

2. **不修改受保护文件**
   - src/McpServer.php
   - src/Database.php
   - src/GepAssetStore.php
   - evolver.php

3. **安全模式检查**
   - `never`: 禁止修改，仅诊断
   - `review`: 需要人工确认
   - `always`: 允许自动修改

### 禁止的操作

- 不执行 shell 命令 (`;`, `&&`, `||`, `|` 等)
- 不修改 vendor 目录
- 不删除 .git 目录

## 最佳实践

### 1. 信号命名

使用描述性信号名称:
- ✅ `api_timeout`, `db_connection_error`
- ❌ `error1`, `problem`

### 2. Summary 规范

- 使用现在时
- 具体说明修改内容
- 示例: "Fixed null pointer by adding null check in UserController"

### 3. Blast Radius 记录

准确记录影响范围:
```json
{
  "blastRadius": {
    "files": 2,
    "lines": 45
  },
  "modifiedFiles": ["src/Controller.php", "src/Service.php"]
}
```

### 4. 策略选择

| 场景 | 策略 | 说明 |
|------|------|------|
| 生产环境紧急修复 | repair-only | 最小变更，快速恢复 |
| 日常维护 | balanced | 修复+优化 |
| 新功能开发 | innovate | 允许较大变更 |
| 安全审计后 | harden | 专注安全和稳定性 |

## 故障排除

### 常见问题

**Q: evolver_run 返回空结果？**
A: 检查 context 是否包含足够信息，尝试添加更多错误日志。

**Q: solidify 失败？**
A: 检查 blastRadius 是否超出限制，或是否尝试修改受保护文件。

**Q: 找不到合适的 Gene？**
A: 调用 evolver_list_genes 查看可用策略，或创建新的 Gene。

### 调试步骤

1. 调用 evolver_stats 检查系统状态
2. 调用 evolver_safety_status 确认安全模式
3. 检查数据库健康: 读取 gep://health 资源
4. 查看最近的进化事件: evolver_list_events

## 集成示例

### 与 CI/CD 集成

```yaml
# GitHub Actions 示例
- name: Self-heal
  run: |
    # 运行测试，如果失败则尝试自修复
    if ! phpunit; then
      # 提取错误信号
      php evolver.php --run-extract < test_output.log
      # 运行进化
      php evolver.php --run-evolve --strategy=repair-only
    fi
```

### 与监控集成

```php
// 当错误率超过阈值时触发
if ($errorRate > 0.05) {
    // 自动调用 evolver_extract_signals
    // 自动调用 evolver_run
}
```

## 资源

- **GitHub**: https://github.com/linkerlin/Evolver.php
- **GEP Protocol**: https://zhichai.net/topic/177168577
- **MCP Resources**:
  - `gep://genes` - 可用策略
  - `gep://capsules` - 成功案例
  - `gep://stats` - 统计数据
  - `gep://health` - 数据库健康
  - `gep://safety` - 安全状态

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

Evolver.php

Directory Structure

SKILL.md

Report

Notice