# HEARTBEAT.md - 定时维护任务

> 每次心跳时执行的维护检查清单

---

## 任务清单

### 每日任务（晚上10点后执行）

#### 1. 三层记忆每日总结（由 memory-management 技能处理）

**触发条件**: 时间 ≥ 22:00 且当日无 L2 记录  
**执行技能**: [memory-management](../skills/memory-management/SKILL.md)  
**执行脚本**: `skills/memory-management/scripts/daily_check.py`

**执行逻辑**:
```
收到心跳请求
    │
    ▼
读取 HEARTBEAT.md 获取任务清单
    │
    ▼
时间 ≥ 22:00 ?
    ├── 否 → 回复 HEARTBEAT_OK（时间未到）
    │
    └── 是 → 检查今日 L2 是否存在
              │
              ├── 是 → 回复 HEARTBEAT_OK（已记录）
              │
              └── 否 → 执行每日检查脚本
                        │
                        ▼
                  扫描所有session文件
                  （当前活跃 + .reset.归档 + .deleted.删除）
                        │
                        ▼
                  分析内容识别重要事件
                        │
                        ▼
                  生成每日总结建议
```

**完整检查流程（确保无遗漏）**:

1. **扫描所有Session文件**
   - 当前活跃: `*.jsonl`
   - 重置归档: `*.jsonl.reset.*`
   - 删除归档: `*.jsonl.deleted.*`
   - 检查今日修改时间戳

2. **提取飞书渠道对话**
   - 解析每个session文件
   - 识别 `channel: feishu` 的消息
   - 提取用户发送的文本内容

3. **识别重要事件类型**
   - 技能安装/更新（关键词: skill, 安装, 创建）
   - 配置变更（关键词: config, 配置, API key）
   - 定时任务（关键词: cron, 定时）
   - 重要对话/决策

4. **判断标准（怎样才算"没有遗漏"）**
   ```
   ✅ 检查完成标准：
   ├── 已扫描今日所有修改过的session文件（≥1个）
   ├── 已检查.reset.和.deleted.归档文件
   ├── 已提取飞书渠道对话记录
   ├── 已识别所有重要事件类型
   └── 已生成L2记录或确认无需记录
   
   ❌ 遗漏警告：
   ├── 发现今日session文件 > 0
   ├── 但今日L2记录不存在
   └── → 必须人工检查补充
   ```

**动作**:
- 执行 `daily_check.py` 扫描所有session
- 如发现活动但未记录 → 提示需要补充L2
- 更新 MEMORY.md 的"最近活动"摘要
- 检查 L0 大小

---

## 其他维护（非心跳）

以下维护由独立机制处理，不通过心跳执行：

- **每周维护**: `memory-weekly-maintenance` (Cron 定时任务，周一 9:30)
- **每月维护**: 手动触发

---

## 相关技能

- **[memory-management](../skills/memory-management/SKILL.md)**: 三层记忆管理
- **[memory-merger](../skills/memory-merger/SKILL.md)**: L2→L1 合并

---

## 快速命令

```bash
# 手动执行每日检查
python ~/.openclaw/workspace/skills/memory-management/scripts/daily_check.py

# 查看 L0 大小
python ~/.openclaw/workspace/skills/memory-management/scripts/check_size.py
```