Memory System — 三层记忆框架
架构概览
工作记忆(当前会话) ← 临时,不持久
↓ 写入
日记忆 memory/YYYY-MM-DD.md ← 原始日志,按天归档
↓ 蒸馏(定期提炼)
长期记忆 MEMORY.md ← 策划精华,跨会话持久
↓ 活性归档(30天未引用)
归档 memory/archive/ ← 冷存储,可追溯
核心文件
| 文件 | 用途 | 何时写 |
|---|---|---|
MEMORY.md |
长期记忆(策划精华) | 重要决策、教训、认知更新时 |
memory/YYYY-MM-DD.md |
日记忆(原始日志) | 每次会话有值得记录的事时 |
memory/archive/ |
归档(冷存储) | 30天未被引用的章节移入 |
初始化(新 Agent 首次设置)
- 在工作目录创建
MEMORY.md,使用模板assets/MEMORY.md - 创建
memory/目录 - 在
AGENTS.md(或等效配置文件)中添加记忆规则(见references/conventions.md) - 可选:配置蒸馏 cron(见
references/distillation.md)
日常使用
写入规则
- 日记忆:会话中有值得记录的事 → 写入
memory/YYYY-MM-DD.md - 长期记忆:重大决策/教训/认知 → 同时写入
MEMORY.md - "Mental notes" 不算 — 不写文件的记忆不会存活到下次会话
- 先写再说 — 如果需要记住,先写文件,不要靠"我记住了"
读取规则
- 主会话(与用户的私密对话):可自由读写
MEMORY.md - 共享会话(群聊、Discord、多人场景):禁止加载 MEMORY.md — 防止私人信息泄露
- 日记忆:任何会话都可读,但只写当天的文件
安全红线
MEMORY.md可能包含用户私人信息,绝不在共享上下文中加载- 归档文件同样可能含敏感信息,共享场景也禁读
- 任何记忆文件不得外传(email、公开帖子等)
归档规则
- 30天未被心跳/会话引用 → 移到
memory/archive/ - 教训编号永远保留(编号不可回收,即使教训已过时)
- 动态信息 >14天未更新 → 降级或归档(策略、持仓等)
- 不按文件大小归档 — 信息密度不同,大小不是好指标
- 归档时在
MEMORY.md保留一行占位(章节名 + 归档日期),方便追溯
蒸馏(定期提炼)
将日记忆中值得长期保留的内容提炼到 MEMORY.md。
详细流程见 references/distillation.md。
零内容原则
本 Skill 只提供框架和规则,不包含任何记忆内容。每个 Agent 安装后从零积累自己的记忆。
