Dream Mode：会话之后的自动沉淀
你今天让 Helix 做了一整天事：它了解了你的代码风格、记住了你讨厌的命名方式、踩过了三个项目里常见的坑。然后你关掉电脑，第二天打开一个新会话——一切归零，它又像个刚入职的新人。
这不是模型的问题，是记忆没有沉淀。
Helix 的 Dream Mode 解决的就是这件事：会话结束后，自动回顾这段对话，把值得记住的东西提炼出来，写进持久记忆，并在以后的会话里主动使用。
Dream Mode 是什么
一句话：让 AI 在「醒着干活」之外，多一个「睡觉时整理」的过程。
就像人一样，Helix 的 Agent 在会话中专注执行任务（醒着），会话结束后进入整理阶段（做梦）：回顾发生了什么、哪些经验值得保留、哪些偏好应该记住，然后把这些写进记忆文件。下一次会话开始时，记忆会被自动注入，Agent 不需要你重新解释一遍。
工作原理：四阶段整理
Dream Mode 的核心是一次结构化的「记忆整合」任务，分为四个阶段：
会话历史
│
▼ ① 读取
按摘要读取上次整合后的新会话，按需深入
│
▼ ② 提取
识别有价值的知识：用户偏好、项目约定、技术决策、踩过的坑
│
▼ ③ 写入
把知识写入/更新记忆文件（按主题组织）
│
▼ ④ 更新索引
更新 MEMORY.md 索引，让记忆按主题可检索
① 读取：只处理增量
Dream Mode 不重复劳动。它只读取上次整合之后产生的新会话，通过摘要格式传入（会话 ID、名称、消息数），由 Dream Agent 按需深入读取内容——既控制成本，又不漏掉关键信息。
② 提取：什么值得记住
不是所有对话都值得沉淀。Dream Agent 会识别这几类高价值信息：
| 类型 | 例子 |
|---|---|
| 用户偏好 | 「我更喜欢 Go 风格的错误处理」「注释用中文写」 |
| 项目约定 | 「这个仓库的发布流程是先更新 changelog」「测试目录按模块划分」 |
| 技术决策与原因 | 「这里不用 goroutine 池是因为内存峰值」「选 TiDB 是因为需要强一致」 |
| 踩过的坑 | 「这个 SDK 在 macOS 上需要关闭 HTTP/2 才能连代理」 |
| 可复用方法 | 「发布流程：构建 → 校验 → 上传 → 验证」作为记忆条目保留，供以后参考 |
③ 写入：按主题组织的记忆
记忆不是一条大杂烩，而是按主题组织的文件系统：索引文件（MEMORY.md）维护全局目录，各主题文件（如用户偏好、项目背景、常见坑）保存细节。写入时采用「先读后写」策略——已存在的条目会更新合并，而不是覆盖丢失。
④ 更新索引：让记忆可检索
写入记忆文件后，Dream Agent 还会维护 MEMORY.md 索引——按主题登记已有的记忆条目，保证任何一条经验都能被快速发现。这样记忆不是「写进去就完事」，而是形成一个可持续增长、可按需检索的知识库。
并发与一致性：锁保护
记忆整理涉及读写共享文件，Helix 用一套锁机制保证安全：
- 运行锁 —— 同一时间只允许一个 Dream 任务运行，重复触发直接拒绝
- 状态分离 —— 锁文件与「上次整合时间」分开存储，避免并发读写竞态；即使进程异常退出，下次启动也能正确恢复
- 非阻塞 —— 整合在专属会话中异步执行，不影响你继续使用其他会话
记忆如何被使用：注入与延续
沉淀的终点是使用。下一次会话开始时，Helix 会把相关记忆注入到 Agent 的上下文中：
- 你上次说过「模型选 DeepSeek 就行」→ 新会话默认沿用
- 项目里「发布要跑完整测试」→ Agent 交付前自动执行
- 你讨厌的命名方式 → 生成的代码自动避开
记忆按 Workspace 隔离——不同项目有各自的记忆，互不串味。
触发方式
| 方式 | 说明 |
|---|---|
| 自动触发 | 每轮对话后按门控条件自动整理（如距上次整理达到一定时间、积累足够会话数），无需干预；可在设置中调整或关闭（国际版默认开启） |
| 手动触发 | 在设置中一键运行「开始 Dream」，立即整理当前工作区的会话 |
模型配置：Dream 使用独立配置的模型进行整理——国内版可在设置中指定专用模型；国际版由后台策略自动选择（BYOK 会话模型优先，否则使用 Dream 用途的默认模型）。你可以选择更强或更便宜的模型专门做这件事。
提示：建议在重要任务结束后触发一次 Dream，让关键决策与偏好尽快进入记忆。
与其他能力的协同
与 Skills 体系
Dream Mode 沉淀的是关于你的记忆（偏好、约定、决策、踩过的坑）；Skills 体系沉淀的是可复用的操作步骤（由独立的技能自学习机制产生，也可手动创建）。两者互补：一个回答「记住什么」，一个回答「怎么做」。
与上下文管理
Dream Mode 与 Cache/Compact 解决不同的问题：Compact 让单个会话活得更久，Dream 让跨会话的知识延续。两者叠加，Helix 既有单任务的持久力，也有长期记忆。