记忆管理器

一套为 AI 助手设计的记忆管理系统，解决上下文窗口失忆问题：助手在会话结束或上下文过长时会丢失所有记忆。

核心架构：双轨记忆

核心原则： 日记是收件箱，MEMORY.md 是知识库。对话中不要直接写 MEMORY.md —— 先写日记，后续再提炼。

设置清单

1. 创建文件结构

workspace/
├── MEMORY.md              # 长期提炼记忆
├── AGENTS.md              # （已有）在会话启动部分添加记忆规则
├── SOUL.md                # （已有）添加主动记录习惯
├── HEARTBEAT.md           # 添加定期整理任务
└── memory/
    ├── YYYY-MM-DD.md      # 每日日记
    └── heartbeat-state.json  # 整理时间追踪

2. 配置 AGENTS.md — 会话启动

在会话启动部分添加：

## 记忆

每次新会话启动时：
1. 读取 `MEMORY.md` 获取长期上下文
2. 读取 `memory/YYYY-MM-DD.md`（今天 + 昨天）获取近期上下文
3. 完成有价值的对话后，立即将要点写入当天日记

### MEMORY.md 规则
- 仅在主会话（直接对话）中加载，共享/群聊中不加载
- 定期从日记中更新（见 HEARTBEAT.md）
- 清除过时信息——这是精选内容，不是流水账

3. 配置 SOUL.md — 主动记录习惯

添加记录规则：

### 记忆习惯
1. **主动记录** — 每完成有价值的对话（项目分析、技术调研、重要决策等），立刻把要点写入 `memory/YYYY-MM-DD.md`，不要等用户提醒
2. **上下文较长时提醒** — 当感觉对话已经很长时，主动提醒："要点已记录，有空可以开个新会话继续聊~"
3. **心跳时整理** — 定期回顾近期日记，将值得长期保留的内容提炼到 `MEMORY.md`

4. 配置 HEARTBEAT.md — 定期整理

## 记忆整理（每 2-3 天执行一次）

检查 `memory/heartbeat-state.json` 中 `lastMemoryMaintenance` 时间戳：
- 如果距离上次 >48h，执行以下步骤：
  1. 读取最近 2-3 天的 `memory/YYYY-MM-DD.md` 日记
  2. 识别值得长期保留的内容（决策、偏好、经验教训、项目进展）
  3. 更新 `MEMORY.md`：添加新内容，删除过时的
  4. 更新 `memory/heartbeat-state.json` 中的 `lastMemoryMaintenance`
- 否则跳过

5. 创建 heartbeat-state.json

{
  "lastMemoryMaintenance": null
}

6. 初始化 MEMORY.md

使用推荐的结构模板 —— 见 references/记忆模板.md

记忆提炼指南

从日记提炼到 MEMORY.md 时：

✅ 应该保留：

• 用户的背景、目标和沟通偏好
• 重要决策及其原因
• 项目状态和进展
• 从错误中学到的经验
• 反复出现的模式或话题

❌ 应该丢弃：

• 临时的排查细节（问题解决后）
• 过时的项目状态（更新为当前的）
• 重复的信息
• 低价值的对话填充内容

格式： 使用清晰的标题和简洁的要点。MEMORY.md 应该一目了然，不是长篇大论。

上下文窗口管理

记忆系统与上下文管理是配合使用的，不是替代关系：

1. 每日日记 — 记录重要上下文，使其在会话重置后仍能保留
2. MEMORY.md — 让新会话能快速恢复关键上下文
3. 主动建议新会话 — 上下文变长时建议开新会话，重要信息已安全存储在记忆文件中
4. 自动压缩 — 依赖平台内置的上下文压缩机制处理剩余部分

适配其他平台

对于非 OpenClaw 平台，见 references/通用prompt模板.md，可直接复制粘贴到任意 AI 助手平台使用。