第八章：心跳与进化机制

💓 本章详细介绍 MiniClaw 的心跳检测机制和自动进化协议。

8.1 心跳机制概述

8.1.1 什么是心跳机制？

心跳机制是 MiniClaw 的周期性检查系统，每 30 分钟执行一次，用于检测系统状态、评估蒸馏需求、执行维护任务。

┌─────────────────────────────────────────────────────────────────────┐
│                    心跳机制设计理念                                  │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│    传统 AI 助手                      MiniClaw 心跳机制              │
│    ┌───────────────────┐             ┌───────────────────┐         │
│    │                   │             │                   │         │
│    │   被动响应        │             │   主动检查        │         │
│    │   无周期任务      │             │   定时执行        │         │
│    │   无自我维护      │             │   自动维护        │         │
│    │                   │             │                   │         │
│    └───────────────────┘             └───────────────────┘         │
│                                                                     │
│    ❌ 只响应用户请求                  ✅ 主动执行维护任务           │
│    ❌ 无状态检查                      ✅ 定期检查系统状态           │
│    ❌ 无自动优化                      ✅ 自动评估和优化             │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

8.1.2 心跳架构

┌─────────────────────────────────────────────────────────────────────┐
│                      心跳架构                                        │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│    ┌─────────────────────────────────────────────────────────────┐ │
│    │                    node-cron 调度器                          │ │
│    │                                                             │ │
│    │    cron.schedule('*/30 * * * *', callback)                  │ │
│    │                    │                                        │ │
│    │                    │ 每 30 分钟                             │ │
│    │                    ▼                                        │ │
│    └─────────────────────────────────────────────────────────────┘ │
│                         │                                           │
│                         ▼                                           │
│    ┌─────────────────────────────────────────────────────────────┐ │
│    │                  executeHeartbeat()                          │ │
│    │                                                             │ │
│    │  1. 加载心跳状态       → loadLegacyState()                   │ │
│    │  2. 检查日志大小       → fs.statSync()                       │ │
│    │  3. 评估蒸馏需求       → evaluateDistillation()              │ │
│    │  4. 更新心跳时间戳     → lastHeartbeat = Date.now()          │ │
│    │  5. 保存心跳状态       → saveLegacyState()                   │ │
│    │                                                             │ │
│    └─────────────────────────────────────────────────────────────┘ │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

8.2 心跳调度实现

8.2.1 调度器配置

┌─────────────────────────────────────────────────────────────────────┐
│                    调度器配置                                        │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  Cron 表达式：'*/30 * * * *'                                        │
│                                                                     │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │                                                             │   │
│  │  ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐                            │   │
│  │  │ * │ │ / │ │30 │ │ * │ │ * │                            │   │
│  │  └───┘ └───┘ └───┘ └───┘ └───┘                            │   │
│  │    │     │     │     │     │                               │   │
│  │    │     │     │     │     └─── 星期几 (0-7)               │   │
│  │    │     │     │     └───────── 月份 (1-12)               │   │
│  │    │     │     └─────────────── 日期 (1-31)               │   │
│  │    │     └───────────────────── 小时 (0-23)               │   │
│  │    └─────────────────────────── 每 30 分钟                │   │
│  │                                                             │   │
│  │  执行时间：00:00, 00:30, 01:00, 01:30, ..., 23:30          │   │
│  │                                                             │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                                                                     │
│  使用 node-cron 库实现：                                            │
│  import cron from 'node-cron';                                      │
│  cron.schedule('*/30 * * * *', async () => {                        │
│    await executeHeartbeat();                                        │
│  });                                                                │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

8.3 进化机制

8.3.1 什么是进化？

进化是 MiniClaw 根据用户反馈自我改进的能力，通过更新 DNA 文件来实现。

┌─────────────────────────────────────────────────────────────────────┐
│                    进化机制                                          │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  进化触发场景：                                                     │
│                                                                     │
│  1. 用户明确反馈                                                    │
│     • "我喜欢简洁的回答" → 更新 USER.md                            │
│     • "不要说'当然'" → 更新 SOUL.md                                │
│                                                                     │
│  2. 行为模式学习                                                    │
│     • 检测到用户多次使用某种模式                                    │
│     • 自动记录到 USER.md                                            │
│                                                                     │
│  3. 环境适应                                                        │
│     • 检测到新的项目类型                                            │
│     • 更新 TOOLS.md                                                 │
│                                                                     │
│  进化工具：miniclaw_update                                          │
│  • 更新 AGENTS.md, SOUL.md, USER.md                                │
│  • 支持 append 和 replace 模式                                     │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

8.3.2 进化流程

┌─────────────────────────────────────────────────────────────────────┐
│                    进化流程                                          │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  用户反馈 → 分析意图 → 确定更新文件 → 执行更新 → 验证结果          │
│                                                                     │
│  示例：                                                             │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │  用户："我喜欢简洁的回答，不要太多废话"                      │   │
│  │                                                             │   │
│  │  Agent：检测到用户偏好反馈                                  │   │
│  │                                                             │   │
│  │  执行：miniclaw_update                                      │   │
│  │    file: "USER.md"                                          │   │
│  │    content: "- 偏好简洁的回答，避免冗余"                     │   │
│  │    mode: "append"                                           │   │
│  │                                                             │   │
│  │  结果：USER.md 更新成功                                     │   │
│  │  后续：回复风格变得更简洁                                   │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

本章小结

┌─────────────────────────────────────────────────────────────────────┐
│                     第八章 核心要点                                  │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  💓 心跳机制                                                        │
│     • 每 30 分钟执行一次                                            │
│     • 检查日志大小                                                  │
│     • 评估蒸馏需求                                                  │
│                                                                     │
│  🔄 进化机制                                                        │
│     • 根据用户反馈自我改进                                          │
│     • 更新 DNA 文件                                                 │
│     • miniclaw_update 工具                                          │
│                                                                     │
│  ⏰ 调度器                                                          │
│     • node-cron 库                                                  │
│     • Cron 表达式：*/30 * * * *                                     │
│                                                                     │
│  📝 状态文件                                                        │
│     • heartbeat_state.json                                          │
│     • 记录最后心跳时间                                              │
│     • 记录蒸馏状态                                                  │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

本文档是《MiniClaw 深度解析》系列的第八章，下一章将详细介绍安全机制。