# HEARTBEAT.md - 定时维护任务

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

---

## 任务清单

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

#### 1. 热记忆每日更新（由 hot-memory 技能处理）

**触发条件**: 时间 ≥ 22:00  
**执行技能**: [hot-memory](../skills/hot-memory/SKILL.md)  
**执行脚本**: `skills/hot-memory/scripts/daily_maintenance.py`

**执行逻辑**:
```
收到心跳请求
    │
    ▼
读取 HEARTBEAT.md 获取任务清单
    │
    ▼
时间 ≥ 22:00 ?
    ├── 否 → 回复 HEARTBEAT_OK（时间未到）
    │
    └── 是 → 执行 hot-memory 每日更新
              │
              ▼
        扫描今日记忆检索
              │
              ▼
        提取重要事件和日常活动
              │
              ▼
        更新 MEMORY.md
              │
              ▼
        移除8天前的旧记录
              │
              ▼
        检查文件大小（4KB限制）
              │
              ▼
        执行 git 提交
              │
              ▼
        回复 HEARTBEAT_OK
```

**更新内容**:

1. **维护最近7天事件流水**
   - 从记忆检索中获取今日事件
   - 按日期分组添加到事件流水
   - 自动移除8天前的旧记录

2. **检查重要事件**
   - 识别具有全局长期性影响的事件
   - 如有重要事件，记录到重要事件区块
   - 告知用户已记录重要事件

3. **文件大小检查**
   - 限制：4KB (4096 字节)
   - 超限警告并提示用户瘦身

4. **自动 Git 提交**
   - 切换到 workspace 目录
   - 添加 MEMORY.md 变更
   - 提交信息："每日：更新热记忆 [日期]"

**动作**:
- 执行 `daily_maintenance.py update` 更新 MEMORY.md
- 执行 `git add MEMORY.md && git commit -m "每日：更新热记忆 $(date +%Y-%m-%d)"`
- 如发现重要事件 → 告知用户已记录
- 如文件超限 → 提示需要瘦身

---

## 相关技能

- **[hot-memory](../skills/hot-memory/SKILL.md)**: 热记忆管理，维护 MEMORY.md 文件

---

## 快速命令

```bash
# 手动执行每日更新
python ~/.openclaw/workspace/skills/hot-memory/scripts/daily_maintenance.py update

# 检查文件大小
python ~/.openclaw/workspace/skills/hot-memory/scripts/daily_maintenance.py check-size

# 添加日常事件
python ~/.openclaw/workspace/skills/hot-memory/scripts/daily_maintenance.py add-daily 2026-03-16 "10:30" "事件概要" "关键词"

# 添加重要事件
python ~/.openclaw/workspace/skills/hot-memory/scripts/daily_maintenance.py add-important 2026-03-16 "14:00" "重要事件" "关键词"

# 手动提交热记忆更新
cd ~/.openclaw/workspace && git add MEMORY.md && git commit -m "每日：更新热记忆 $(date +%Y-%m-%d)"
```