memory

Memory - 长期上下文

读取当前会话的长期记忆文件，以访问压缩期间保留的历史上下文。

背景

Claude Code 的 /compact 会压缩对话以节省上下文。反复压缩会导致“记忆衰减”——早期的重要细节会逐渐丢失。

Max 的记忆系统会在每次压缩期间自动将累积的内容保存到文件，确保重要信息不会丢失。

记忆文件

文件	内容	优先级
errors.md	错误修复记录	最高 - 避免重复犯错
context.md	用户消息 + 技术概念	中 - 完整背景
files.md	代码文件引用	低 - 仅在需要时使用

说明

使用 memory.py 脚本读取文件，并自动截断内容（大型文件会裁剪至最后约 15000 个字符，以节省上下文）：

# Read errors.md only (default, recommended)
cd /path/to/skills/memory && uv run memory.py errors.md

# Read specific files
cd /path/to/skills/memory && uv run memory.py errors.md context.md

# Read all files
cd /path/to/skills/memory && uv run memory.py all

脚本会自动：

• 从 ~/.claude/projects/$MAX_PROJECT_ID/max/$MAX_SESSION_ID/memory/ 读取
• 将超过 15000 个字符的文件截断（保留最新内容）
• 跳过不存在的文件

何时读取记忆

压缩后 - 当你在摘要中看到“Earlier details saved to...”时：

• 始终先读取 errors.md——这对避免重复过去的错误至关重要

按需读取 - 根据具体情况读取相应文件：

情况	命令
遇到错误 / 测试失败	uv run memory.py errors.md
需要回忆之前的讨论	uv run memory.py context.md
复用代码模式 / 查找文件	uv run memory.py files.md

备注

• 每次 /compact 期间都会自动更新记忆文件
• 文件会追加带时间戳的内容，最新内容位于底部
• 大型文件会截断至约 15000 个字符（≈3% 的上下文），以防上下文溢出