Product Analysis · Claude Code 解读系列

做梦:AI 的
睡眠记忆整理

Claude Code 隐藏了一个"做梦"功能——让 AI 在后台自动回顾历史对话,把零散信息整理成结构化笔记。这份报告从产品经理视角,用通俗的语言解读它的全部设计。

未公开发布 可远程灰度控制 后台自动运行
01

这个功能是干什么的

不需要任何技术背景就能理解的功能定义。

一句话版本

Claude Code 会在你不用它的时候,自动回顾最近的对话记录,把重要信息整理成"笔记"保存下来。下次你再用的时候,它就能更快地想起之前的事情。

这个过程被叫做"做梦"(Dream),因为它很像人类在睡觉时大脑整理白天记忆的过程。

自动
无需用户操作 · 后台静默运行
安全
只能读代码 · 只能写笔记
02

用生活比喻理解"做梦"

把 AI 想象成一个新入职的同事。

想象这样一个场景

你有一个非常聪明的新同事小 C。每天你们一起工作,讨论了很多事情——项目架构、Bug 原因、部署流程、你的偏好习惯……

但问题是:小 C 每天下班就失忆了。第二天来上班,又要从头问你一遍。

于是你给小 C 一个笔记本,让它把重要的事情记下来。但小 C 白天太忙了,记的笔记又乱又碎。

"做梦"就是让小 C 在下班后,自动翻看白天的聊天记录,把零散的笔记整理成一本条理清晰的工作手册。

第二天上班时,小 C 只需要翻一下手册,就能快速回忆起所有重要的事情。

人类的睡眠

  • 白天接收大量信息
  • 睡觉时大脑自动整理
  • 把重要的变成长期记忆
  • 丢弃不重要的细节
  • 醒来后记忆更清晰

AI 的做梦

  • 多次对话积累大量上下文
  • 后台自动回顾历史对话
  • 把重要信息写入记忆文件
  • 删除过时或错误的记忆
  • 新对话时能快速"回忆"
03

什么时候会触发做梦?

不是每次对话都会做梦。系统设计了 5 道关卡,只有全部通过才会启动。

关卡 1 · 功能开关是否打开

检查用户有没有关闭这个功能、是不是在远程模式、记忆系统有没有启用。

类比:闹钟有没有设?没设就不用考虑起床的事了。

关卡 2 · 距离上次做梦过了多久

默认要求至少过了 24 小时。这是最轻量的检查。

类比:你不会每小时都整理一次书桌,至少等一天积累了足够的东西再说。

关卡 3 · 扫描频率限制

即使时间到了,也限制每 10 分钟最多扫描一次,防止反复检查磁盘。

类比:你不会每分钟都去看信箱有没有新信。

关卡 4 · 积累了足够多的新对话吗

扫描上次做梦之后有多少次新对话。默认要求至少 5 次

类比:只上了一天课不值得复习,攒了一周的课才值得周末整理笔记。

关卡 5 · 有没有别人正在做梦

如果你同时开了多个窗口,只有一个能做梦。通过文件锁防止重复。

类比:一个笔记本同一时间只能一个人写。

默认参数

参数默认值通俗解释
最小间隔24 小时至少隔一天才做一次梦
最小对话数5 次至少积累 5 次对话才值得整理
扫描间隔10 分钟不会太频繁地检查是否该做梦
锁超时1 小时如果做梦的进程崩溃了,1小时后自动解锁

这些参数都可以由 Anthropic 团队通过远程配置动态调整,无需发版。

04

做梦的完整流程

一旦所有关卡通过,AI 就开始"做梦"。整个过程分为 4 个阶段。

总体比喻:整理一间书房

想象你有一间书房,里面有一个书架(记忆目录)、一本目录册(MEMORY.md)、和一堆最近的草稿纸(对话记录)。你要做的是:先看看书架上有什么 → 翻翻草稿纸找有价值的内容 → 把内容归档到对应的书里 → 更新目录册。

阶段 1:定向 —— "先看看书架上有什么"

目的:了解当前记忆的全貌,避免重复劳动。

  • 列出记忆目录里的所有文件(扫一眼书架)
  • 读取 MEMORY.md——这是"目录册",记录了所有记忆文件的索引
  • 快速浏览已有的主题文件,了解每个文件讲什么
  • 如果有日志目录,也看看最近的日志

这一步确保 AI 不会"闭着眼睛干活"。如果已经有一个 deployment.md,就不会再创建一个 deploy-notes.md。

阶段 2:收集信号 —— "翻翻草稿纸找有价值的"

目的:从最近的对话中找出值得长期保存的信息。

AI 按优先级搜索 3 类信息源:

  • 每日日志——如果用户使用了助手模式,会有按日期组织的日志文件
  • 过时的记忆——检查已有记忆是否和代码库的当前状态矛盾(比如记忆里写着"用 MySQL",但代码已经迁移到 PostgreSQL)
  • 对话记录搜索——用关键词在历史对话文件中搜索特定内容

AI 被明确告知"不要穷举阅读对话记录"。只搜索它已经怀疑重要的内容。这是为了控制成本和时间。

体现了"有目的地回忆"而非"全量复习"。就像复习考试时重点看标记过的地方。

阶段 3:整合 —— "把内容归档到对应的书里"

目的:将收集到的信息写入或更新记忆文件。

AI 遵循 3 条核心原则:

  • 合并优先,不创建重复——新的 API 相关信息应该合并到已有的 api-design.md,而不是另建一个文件
  • 把相对日期转成绝对日期——"昨天修复了 Bug"会变成"2026年3月31日修复了 Bug"
  • 删除错误信息——如果今天发现之前记录的某个结论是错的,直接在源头修正

这是做梦的核心价值。不是简单地"复制粘贴"对话内容,而是理解、提炼、归类、纠错。

阶段 4:修剪与索引 —— "更新目录册"

目的:保持记忆系统的整洁和可用性。

MEMORY.md 是整个记忆系统的"目录册",有严格的规格要求:

  • 总行数不超过 200 行,总大小不超过 25KB
  • 每条索引只占一行,不超过约 150 个字符
  • 格式统一:- [标题](文件.md) — 一句话描述
  • 绝对不能把记忆内容直接写在目录册里——它只是索引

AI 在这一步会:删除过时链接、精简冗长条目、添加新链接、解决文件间的矛盾。

确保记忆系统不会"越用越乱"。就像图书馆管理员定期整理书架、更新目录卡片。

05

AI 收到的完整指令

下面是 AI 做梦时收到的完整 Prompt(系统指令),附逐段中文翻译。

主指令(每次做梦都会发送)

# Dream: Memory Consolidation You are performing a dream — a reflective pass over your memory files. Synthesize what you've learned recently into durable, well-organized memories so that future sessions can orient quickly. → 你正在做梦——对记忆文件进行反思性回顾。把最近学到的东西整合成持久、有条理的记忆,让未来的对话能快速获取上下文。 Memory directory: `~/.claude/projects/.../memory/` Session transcripts: `~/.claude/projects/.../` (large JSONL files — grep narrowly, don't read whole files) → 对话记录在这里(很大的文件,只用关键词搜索,别全部读取)。 ## Phase 1 — Orient (阶段1:定向) - ls the memory directory to see what already exists - Read MEMORY.md to understand the current index - Skim existing topic files - If logs/ or sessions/ subdirectories exist, review recent entries ## Phase 2 — Gather recent signal (阶段2:收集) 1. Daily logs if present → ① 每日日志 2. Existing memories that drifted → ② 和现状矛盾的旧记忆 3. Transcript search → ③ 用关键词搜索对话记录 Don't exhaustively read transcripts. Look only for things you already suspect matter. → 不要穷举阅读。只找你已经怀疑重要的东西。 ## Phase 3 — Consolidate (阶段3:整合) - Merging new signal into existing topic files - Converting relative dates to absolute dates - Deleting contradicted facts — fix it at the source ## Phase 4 — Prune and index (阶段4:修剪) Update MEMORY.md: under 200 lines, under ~25KB. It's an index, not a dump. Each entry: - [Title](file.md) — one-line hook Never write memory content directly into it. → 绝对不要把记忆内容直接写在目录册里。 Return a brief summary of what you consolidated. If nothing changed, say so. → 最后返回简短总结。没有变化也要说明。

附加指令(仅自动做梦时追加)

## Additional context **Tool constraints for this run:** Bash is restricted to read-only commands (ls, find, grep, cat, stat, wc, head, tail, and similar). Anything that writes will be denied. → Shell 命令只能用只读的。任何写入操作都会被拒绝。 Sessions since last consolidation (7): - session_abc123 - session_def456 ... → 上次整合以来的对话会话 ID 列表

手动 /dream 命令不附加这段——手动触发时 AI 在主对话中运行,拥有正常权限。

06

安全边界

做梦时的 AI 被关在一个"沙箱"里,能力受到严格限制。

能做的事

  • 读取任何文件(只是看,不能改)
  • 搜索文件内容
  • 列出目录结构
  • 运行只读 Shell 命令
  • 在记忆目录里创建/编辑 .md 文件

不能做的事

  • 修改你的项目代码
  • 运行写入性 Shell 命令
  • 上网搜索
  • 启动子任务或新 AI
  • 安装软件、执行 git 操作

设计原则:做梦是完全自动化的后台过程,用户可能完全不知道它在运行。所以 做梦只能"看"和"记笔记",绝不能"动手"。

07

用户看到什么

做梦功能的交互设计遵循"不打扰"原则。

大部分时候:什么都看不到

做梦在后台静默运行。不会弹窗、不会打断、不会影响对话速度。

如果用户主动查看:后台任务面板

通过 Shift+Down 打开后台任务面板,可以看到做梦进度:

Memory consolidation 2m 34s · reviewing 7 sessions · 3 files touched Status: running (2 earlier turns) 把部署配置的笔记合并到了已有的 devops.md 中... (3 个工具调用) 更新了 MEMORY.md 索引,添加了 API 迁移相关条目... (1 个工具调用) ← 返回 · Esc/Enter/Space 关闭 · x 停止

做梦完成后:一条简短通知

如果修改了文件,会在对话中显示:

✓ Improved memory/devops.md, memory/api-migration.md, memory/MEMORY.md

如果记忆已经很完善、不需要修改,则完全不显示任何消息。

08

用户怎么控制

用户有多种方式控制做梦功能。

开关控制

在 /memory 命令的设置界面中有两个开关:

  • Auto-memory:总开关
  • Auto-dream:做梦专属开关

也可以在配置文件中直接设置。

两种触发方式

  • 自动触发:满足条件后后台运行,受沙箱限制
  • 手动 /dream:立即执行,拥有完整权限
09

出了问题怎么办

系统为各种异常情况都设计了应对方案。

可能的问题系统怎么处理
做梦过程中 AI 出错了自动标记失败,回滚时间戳,下次可重试
用户手动停止了做梦立即终止,回滚状态
Claude Code 突然崩溃检测到进程已死,自动回收锁(最多等 1 小时)
同时开了多个窗口只有一个能做梦,其他静默跳过
远程配置返回错误数据每个参数独立验证,无效值回退到默认值

设计哲学:宁可不做,也不做错

任何一个环节出问题,都是静默跳过或回滚。用户最坏的体验是"这次没做梦",而不是"做梦把我的记忆搞乱了"。

10

产品策略总结

从产品经理视角看这个功能的核心价值。

一句话总结

KAIROS DREAM 让 AI 助手从"每次见面都是陌生人"变成"一个越来越了解你的老同事"。

解决的核心问题

问题做梦怎么解决
AI 每次对话都"失忆"自动把重要信息整理成持久记忆文件
记忆文件越来越乱定期整理、去重、纠错、更新索引
用户不想手动整理完全自动化,后台静默运行
担心 AI 后台乱改东西严格沙箱,只能读代码写笔记
担心浪费 API 资源5 道关卡确保只在必要时触发

设计亮点

  • 零打扰——后台运行,不阻塞用户
  • 渐进发布——远程配置灰度控制
  • 用户可控——随时开关、查看、终止
  • 安全第一——严格沙箱
  • 成本可控——多层门控
  • 自愈能力——失败自动回滚

可能的未来方向

  • 基于记忆质量的智能触发
  • 增量整合(只处理变化部分)
  • 用户反馈闭环
  • 跨项目记忆整合
  • 团队共享记忆联动
  • 记忆变化历史可视化

在整个产品中的位置

KAIROS DREAM 是 Claude Code 记忆系统的"夜间维护工程师":

对话中 → Extract Memories 实时提取记忆("白天随手记")

对话后 → Auto Dream 后台整理记忆("晚上整理归档")← 本文分析对象

下次对话 → 加载整理好的记忆,快速回忆上下文

两者配合,让 AI 的记忆既及时又有条理。