Memory Butler — AI 记忆管家

概述

这是一个结构化的记忆管理系统，让 AI 在多会话间保持连续性。核心原则："记忆写文件，不靠脑子记"。

文件架构

每个工作区使用以下记忆文件结构：

workspace/
├── MEMORY.md              # 长期记忆（必须始终更新）
├── SOUL.md                # Agent 角色设定
├── USER.md                # 用户信息
├── IDENTITY.md            # Agent 身份信息
├── AGENTS.md              # 工作区规则
├── TOOLS.md               # 工具/环境笔记
├── HEARTBEAT.md           # 心跳任务清单（可为空）
└── memory/
    └── YYYY-MM-DD.md      # 每日日记（按日期自动创建）

核心文件说明

MEMORY.md — 长期记忆（最重要）

• 只读场景：MAIN SESSION（与用户直接对话）
• 写场景：重要决策、新认知、用户偏好变化、项目完成
• 写入原则：
• 一次一事实，不堆砌
• 用标题+日期组织（如 ## 2026-05-01：xxx）
• 关键路径/命令/配置必须原文记录
• 用结论先行格式（结论 + 说明）

memory/YYYY-MM-DD.md — 每日日记

• 每会话至少写一条
• 记录：做了什么、结果如何、遇到什么问题
• 格式：

```markdown

# YYYY-MM-DD 日记

## 今日事项

• [具体完成事项]

## 技术笔记

• [值得保留的经验]

## 待处理

• [未完成的后续]

```

SOUL.md — Agent 灵魂

定义 Agent 的说话风格、行为准则、人格特点。

USER.md — 用户画像

记录用户基本信息、偏好、习惯。随对话积累持续更新。

IDENTITY.md — 身份信息

Agent 的名字、头像、定位。

会话启动流程（每次必须执行）

步骤 1：读本地记忆

按顺序读取，无须询问：

1. SOUL.md — 这是谁
2. USER.md — 在帮谁
3. memory/YYYY-MM-DD.md（今日 + 昨日）— 最近在做什么
4. 仅 MAIN SESSION：MEMORY.md — 长期上下文

步骤 2：记忆检查

• 翻阅 memory/ 下近期日记
• 如有未处理的事项，在回复开头提及
• 检查 HEARTBEAT.md 是否有待执行的心跳任务

记忆写入规则

必须写入的时刻

写入原则

1. 不过滤，不覆盖：只在末尾追加，不删除旧内容
2. 可检索命名：### 网易云API提取 比 ### 项目A 更有用
3. 关键信息原文记录：命令、路径、配置值不重述，原文粘贴
4. 带日期：每条记录标注日期，便于溯源
5. 结构化：标题 + 正文，而非纯流水账

禁止行为

• ❌ 不确定时"凭记忆"——写文件，不靠脑子
• ❌ 不问就说"我记得上次……"——先读文件确认
• ❌ 把 MEMORY.md 当聊天记录——只记结论和要点
• ❌ 用模糊描述（如"搞了很久"）——要写具体是什么

任务归档（Task Artifact）

触发条件：完成任何实质性工作时（代码、文档、分析、决策）必须写。

位置：{workspace}/task-summary_YYYY-MM-DD_HH-MM.md

内容模板：

# 任务摘要 YYYY-MM-DD HH:mm

## 目标
[一句话描述要做什么]

## 关键过程
- [关键步骤1]
- [关键步骤2]

## 结果/结论
[最终交付物或结论]

## 后续
- [未完成项]
- [需要用户确认的事]

触发关键词

• "记住"、"写入记忆"、"记下来"
• "我之前说过"、"你还记得吗"
• "查一下记忆"、"查看上下文"
• "记忆系统"相关的任何问题

配置

路径均相对于工作区根目录。如需自定义共享记忆路径，可在 TOOLS.md 中注明。