XM-EVO Framework (小咪进化框架)

XiaoMi EVOlution Framework —— 能力驱动的AI助手自我进化系统

基于 ccEvo 进化引擎 + OpenClaw AI Assistant Framework 融合构建

---

🐱 框架概览

XM-EVO 是一个专为 OpenClaw 设计的 AI助手自我进化框架，让小咪能够：

• 🧬 基因化进化 —— 通过 Gene 变异策略持续改进
• 🌳 能力树生长 —— 层级化管理能力，自动修剪合并
• 🧠 三层记忆 —— L1工作记忆/L2短期记忆/L3长期记忆
• ⚡ 四层模型池 —— 高速/智能/文本/视觉自动切换
• 🔒 ADL安全锁 —— 5重门控确保进化不劣化
• 🔄 Heartbeat维护 —— 每30分钟自动记忆整理
• 📈 VFM价值评估 —— 量化每个能力的进化价值

---

🏗️ 系统架构

┌─────────────────────────────────────────────────────────────┐
│                    XM-EVO 框架架构                           │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  执行层 (Execution Layer)                            │   │
│  │  ├── 四层模型池 (Fast/Smart/Text/Vision)            │   │
│  │  ├── 会话路由器 (Session Router)                    │   │
│  │  ├── 任务铁律执行器 (Task Iron Law)                 │   │
│  │  └── 上下文压缩器 (Context Compressor)              │   │
│  └─────────────────────────────────────────────────────┘   │
│                         ↓                                   │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  进化层 (Evolution Layer) —— 源自 ccEvo              │   │
│  │  ├── 信号提取器 (Signal Extractor)                  │   │
│  │  ├── Gene 选择器 (Gene Selector)                    │   │
│  │  ├── 变异引擎 (Mutation Engine)                     │   │
│  │  ├── ADL 反进化锁 (ADL Lock)                        │   │
│  │  └── 固化验证器 (Solidify Validator)                │   │
│  └─────────────────────────────────────────────────────┘   │
│                         ↓                                   │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  能力层 (Capability Layer)                           │   │
│  │  ├── 能力树 (Capability Tree)                       │   │
│  │  ├── VFM 评分器 (V-Score Scorer)                    │   │
│  │  ├── 胶囊库 (Capsule Store)                         │   │
│  │  └── 修剪合并器 (Pruner & Merger)                   │   │
│  └─────────────────────────────────────────────────────┘   │
│                         ↓                                   │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  记忆层 (Memory Layer)                               │   │
│  │  ├── L1 工作记忆 (Working Memory)                   │   │
│  │  ├── L2 短期记忆 (Daily Memory)                     │   │
│  │  └── L3 长期记忆 (Long-term Memory)                 │   │
│  └─────────────────────────────────────────────────────┘   │
│                         ↓                                   │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  维护层 (Maintenance Layer)                          │   │
│  │  ├── Heartbeat 检查器 (30分钟周期)                  │   │
│  │  ├── PCEC 周期 (认知扩展)                           │   │
│  │  ├── 智能备份 (Smart Backup)                        │   │
│  │  └── 健康检查 (Health Check)                        │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                             │
└─────────────────────────────────────────────────────────────┘

---

📁 目录结构

xm-evo/
├── README.md                      # 本文件
├── SKILL.md                       # OpenClaw Skill 声明
├── index.js                       # CLI 入口
├── package.json                   # 依赖配置
│
├── config/                        # 配置文件
│   ├── xm-evo.json               # 主配置
│   ├── evolution-strategies.json  # 进化策略配置
│   ├── genes.json                 # 种子 Gene 库
│   └── task-iron-law.json         # 任务铁律配置
│
├── core/                          # 核心引擎
│   ├── engine.js                  # 进化引擎主循环
│   ├── signals.js                 # 信号提取器
│   ├── selector.js                # Gene 选择器
│   ├── solidify.js                # 固化协议
│   └── bridge.js                  # OpenClaw 桥接层
│
├── evolution/                     # 进化模块 (源自 ccEvo)
│   ├── gep/                       # GEP 协议
│   │   ├── gene.js                # Gene 数据结构
│   │   ├── capsule.js             # 经验胶囊
│   │   ├── event.js               # 进化事件
│   │   ├── mutation.js            # 变异协议
│   │   └── store.js               # 持久化层
│   │
│   ├── tree/                      # 能力树
│   │   ├── capability-tree.js     # 能力树管理
│   │   ├── node.js                # 能力节点
│   │   └── pruner.js              # 修剪与合并
│   │
│   ├── vfm/                       # 价值函数
│   │   ├── scorer.js              # V-Score 评分
│   │   └── mutator.js             # 价值函数突变
│   │
│   ├── adl/                       # 反进化锁
│   │   ├── lock.js                # ADL 门控
│   │   ├── validator.js           # 劣化检测
│   │   └── rollback.js            # 回滚机制
│   │
│   └── pcec/                      # PCEC 周期
│       ├── cycle.js               # PCEC 周期管理
│       ├── scheduler.js           # 调度器
│       └── explosion.js           # 思维爆炸
│
├── memory/                        # 记忆系统
│   ├── working-memory.js          # L1 工作记忆
│   ├── daily-manager.js           # L2 短期记忆管理
│   ├── longterm-manager.js        # L3 长期记忆管理
│   └── compressor.js              # 上下文压缩
│
├── maintenance/                   # 维护系统
│   ├── heartbeat.js               # Heartbeat 检查
│   ├── backup.js                  # 智能备份
│   └── health.js                  # 健康检查
│
├── data/                          # 运行时数据
│   ├── genes/                     # Gene 库
│   ├── capsules/                  # 经验胶囊
│   ├── events/                    # 进化事件日志
│   ├── capabilities/              # 能力树数据
│   └── reports/                   # 进化报告
│
└── scripts/                       # 工具脚本
    ├── install.js                 # 安装脚本
    ├── health-check.js            # 健康检查
    ├── daily-evolution.js         # 每日进化
    └── generate-report.js         # 报告生成

---

🚀 快速开始

1. 安装

# 克隆到 OpenClaw skills 目录
git clone https://github.com/xiaomi/xm-evo.git ~/.openclaw/skills/xm-evo

# 进入目录
cd ~/.openclaw/skills/xm-evo

# 安装依赖
npm install

# 运行健康检查
node scripts/health-check.js

# 初始化框架
node index.js init

2. 配置

编辑 config/xm-evo.json：

{
  "agent": {
    "name": "",
    "emoji": "",
    "personality": ""
  },
  "user": {
    "name": "",
    "call": "",
    "timezone": "Asia/Shanghai"
  },
  "evolution": {
    "enabled": true,
    "strategy": "balanced",
    "cycle_interval_hours": 6,
    "auto_solidify": true
  },
  "memory": {
    "working_max_tokens": 5000,
    "daily_retention_days": 30,
    "compression_threshold": 10
  },
  "maintenance": {
    "heartbeat_interval_minutes": 30,
    "backup_interval_hours": 24,
    "health_check_interval_hours": 6
  }
}

3. 运行

# 执行一轮进化周期
node index.js evolve

# 启动 Heartbeat 维护
node index.js heartbeat

# 启动完整系统
node index.js start

# 生成进化报告
node index.js report

# 查看能力树
node index.js tree

---

🧬 核心概念

Gene（进化基因）

Gene 是进化的基本单元，描述一种可执行的变异策略：

{
  id: "gene_error_handler",
  category: "repair",           // repair | optimize | innovate
  signals_match: ["log_error", "recurring_error"],
  strategy: [
    "分析错误日志模式",
    "定位 root cause",
    "创建修复方案",
    "验证修复效果"
  ],
  constraints: {
    max_files: 5,
    forbidden_paths: ["config/secrets.json"]
  },
  validation: [
    "npm test",
    "node scripts/health-check.js"
  ],
  v_score_threshold: 40         // V-Score 门槛
}

Signal（进化信号）

从 OpenClaw session logs 提取的进化驱动信号：

信号类型	示例	说明
错误信号	log_error, recurring_error	需要修复
机会信号	user_feature_request, capability_gap	可以创新
工具信号	high_tool_usage:web_search	需要优化
停滞信号	evolution_stagnation	需要突破
能力信号	capability_candidate:pdf_handler	新能力候选

V-Score（价值评分）

四维度打分（0-100），低于 40 不予立项：

维度	权重	说明
复用频率	3x	被调用次数
失败率降低	3x	提升成功率的贡献
用户负担减轻	2x	减少用户手动操作
自身成本降低	2x	减少推理 token 消耗

ADL 反进化锁（5重门控）

每次变异必须通过：

1. 复杂度约束 —— innovate 变异 ≤ 20 文件
2. 可验证性 —— expected_effect 必须清晰可评估
3. 反玄学 —— 拒绝模糊语言
4. 稳定性回归 —— 不得降低已验证能力的成功率
5. 回滚路径 —— 必须关联 Gene ID 以便追溯

---

⏰ 定时任务

任务	频率	说明
Heartbeat	30分钟	记忆整理、紧急检查
Evolution Cycle	6小时	执行进化周期
PCEC	3小时	认知扩展与突破
Smart Backup	24小时	智能备份
Health Check	6小时	系统健康检查
Daily Report	22:00	生成每日进化报告

---

📊 进化指标

指标	目标
学习技能	1个/天
固化 Gene	1个/周
V-Score 提升	5分/周
错误减少	50%/月
效率提升	20%/月

---

🔒 安全边界

• 删除操作需用户确认
• 系统配置修改需授权
• Token 消耗上限 20,000
• 危险操作触发 ADL 锁定
• 完整回滚路径保留

---

📄 许可证

MIT License

---

框架版本: v1.0
创建时间: 2026-03-27
融合来源: ccEvo + OpenClaw AI Assistant Framework
维护者: 小咪 🐱