diff --git a/docs/zh-CN/concepts/dreaming.md b/docs/zh-CN/concepts/dreaming.md index ff0d310b0..e1a0a1787 100644 --- a/docs/zh-CN/concepts/dreaming.md +++ b/docs/zh-CN/concepts/dreaming.md @@ -2,20 +2,20 @@ read_when: - 你希望记忆提升自动运行 - 你想了解每个 Dreaming 阶段的作用 - - 你想调整整合行为，而不污染 MEMORY.md + - 你想调整整合过程，而不污染 MEMORY.md sidebarTitle: Dreaming -summary: 后台记忆整合，包含浅层、深层和 REM 阶段，并附带梦境日记 +summary: 后台记忆整合，包含浅度、深度和 REM 阶段，以及梦境日记 title: Dreaming x-i18n: - generated_at: "2026-04-28T11:49:12Z" + generated_at: "2026-05-02T08:29:35Z" model: gpt-5.5 provider: openai - source_hash: 85c323c073fc786069835aad25ee68781af49bb031e63b9601674461f385cc2a + source_hash: 23057bfeaaac1cc6b2bf2ee78928c8fdd820c817e461cc0b77f7c1e40ac14c22 source_path: concepts/dreaming.md workflow: 16 --- -Dreaming 是 `memory-core` 中的后台记忆整合系统。它帮助 OpenClaw 将强短期信号转入持久记忆，同时保持流程可解释、可审查。 +Dreaming 是 `memory-core` 中的后台记忆整合系统。它帮助 OpenClaw 将强烈的短期信号转移到持久记忆中，同时让这个过程可解释、可审查。 Dreaming 是**选择启用**的，默认禁用。 @@ -25,8 +25,8 @@ Dreaming 是**选择启用**的，默认禁用。 Dreaming 保留两类输出： -- `memory/.dreams/` 中的**机器状态**（召回存储、阶段信号、摄取检查点、锁）。 -- `DREAMS.md`（或现有的 `dreams.md`）中的**人类可读输出**，以及 `memory/dreaming//YYYY-MM-DD.md` 下的可选阶段报告文件。 +- **机器状态**位于 `memory/.dreams/`（召回存储、阶段信号、摄取检查点、锁）。 +- **人类可读输出**位于 `DREAMS.md`（或现有的 `dreams.md`）以及 `memory/dreaming//YYYY-MM-DD.md` 下的可选阶段报告文件。 长期提升仍然只写入 `MEMORY.md`。 @@ -34,22 +34,22 @@ Dreaming 保留两类输出： Dreaming 使用三个协作阶段： -| 阶段 | 目的 | 持久写入 | -| ----- | ----------------------------------------- | ----------------- | -| Light | 对近期短期材料进行排序并暂存 | 否 | -| Deep | 为持久候选项评分并提升 | 是（`MEMORY.md`） | +| 阶段 | 目的 | 持久写入 | +| ----- | ---------------------------- | ----------------- | +| Light | 整理并暂存近期短期材料 | 否 | +| Deep | 评分并提升持久候选项 | 是（`MEMORY.md`） | | REM | 反思主题和反复出现的想法 | 否 | -这些阶段是内部实现细节，不是单独由用户配置的“模式”。 +这些阶段是内部实现细节，而不是单独由用户配置的“模式”。 - Light 阶段摄取近期每日记忆信号和召回轨迹，对它们去重，并暂存候选行。 + Light 阶段会摄取近期每日记忆信号和召回轨迹，对它们去重，并暂存候选行。 - - 在可用时，从短期召回状态、近期每日记忆文件和已脱敏的会话转录读取。 - - 当存储包含内联输出时，写入托管的 `## Light Sleep` 块。 - - 记录强化信号，供后续深度排名使用。 - - 从不写入 `MEMORY.md`。 + - 从短期召回状态、近期每日记忆文件以及可用时经过脱敏的会话转录中读取。 + - 当存储包含内联输出时，写入受管理的 `## Light Sleep` 块。 + - 记录用于后续 Deep 排名的强化信号。 + - 永远不会写入 `MEMORY.md`。 @@ -57,73 +57,75 @@ Dreaming 使用三个协作阶段： - 使用加权评分和阈值门槛对候选项排名。 - 需要通过 `minScore`、`minRecallCount` 和 `minUniqueQueries`。 - - 写入前从实时每日文件重新水合片段，因此会跳过过时或已删除的片段。 - - 将已提升的条目追加到 `MEMORY.md`。 - - 将 `## Deep Sleep` 摘要写入 `DREAMS.md`，并可选择写入 `memory/dreaming/deep/YYYY-MM-DD.md`。 + - 写入前会从实时每日文件中重新加载片段，因此会跳过过时或已删除的片段。 + - 将提升后的条目追加到 `MEMORY.md`。 + - 将 `## Deep Sleep` 摘要写入 `DREAMS.md`，并可选写入 `memory/dreaming/deep/YYYY-MM-DD.md`。 REM 阶段提取模式和反思信号。 - 根据近期短期轨迹构建主题和反思摘要。 - - 当存储包含内联输出时，写入托管的 `## REM Sleep` 块。 + - 当存储包含内联输出时，写入受管理的 `## REM Sleep` 块。 - 记录 Deep 排名使用的 REM 强化信号。 - - 从不写入 `MEMORY.md`。 + - 永远不会写入 `MEMORY.md`。 ## 会话转录摄取 -Dreaming 可以将已脱敏的会话转录摄取到 Dreaming 语料库中。转录可用时，会与每日记忆信号和召回轨迹一起输入 Light 阶段。个人内容和敏感内容会在摄取前脱敏。 +Dreaming 可以将经过脱敏的会话转录摄取到 Dreaming 语料库中。当转录可用时，它们会与每日记忆信号和召回轨迹一起送入 Light 阶段。个人内容和敏感内容会在摄取前脱敏。 ## 梦境日记 -Dreaming 还会在 `DREAMS.md` 中保留一份叙事性的**梦境日记**。每个阶段有足够材料后，`memory-core` 会运行一次尽力而为的后台子智能体轮次，并追加一条简短的日记条目。除非配置了 `dreaming.model`，否则它使用默认运行时模型。如果配置的模型不可用，梦境日记会使用会话默认模型重试一次。 +Dreaming 还会在 `DREAMS.md` 中保留叙事性的**梦境日记**。每个阶段拥有足够材料后，`memory-core` 会运行一次尽力而为的后台子智能体回合，并追加一条简短日记。除非配置了 `dreaming.model`，否则它使用默认运行时模型。如果配置的模型不可用，梦境日记会使用会话默认模型重试一次。 -这份日记供 Dreams UI 中的人类阅读，不是提升来源。Dreaming 生成的日记/报告工件会从短期提升中排除。只有有依据的记忆片段才有资格提升到 `MEMORY.md`。 +这份日记供人类在 Dreams UI 中阅读，不是提升来源。Dreaming 生成的日记/报告产物会被排除在短期提升之外。只有有依据的记忆片段才有资格提升到 `MEMORY.md`。 -还有一条用于审查和恢复工作的有依据历史回填通道： +还有一个用于审查和恢复工作的、有依据的历史回填通道： - - `memory rem-harness --path ... --grounded` 会从历史 `YYYY-MM-DD.md` 笔记预览有依据的日记输出。 - - `memory rem-backfill --path ...` 会将可回滚的有依据日记条目写入 `DREAMS.md`。 - - `memory rem-backfill --path ... --stage-short-term` 会将有依据的持久候选项暂存到普通 Deep 阶段已经使用的同一短期证据存储中。 - - `memory rem-backfill --rollback` 和 `--rollback-short-term` 会移除这些暂存的回填工件，而不触碰普通日记条目或实时短期召回。 + - `memory rem-harness --path ... --grounded` 从历史 `YYYY-MM-DD.md` 笔记中预览有依据的日记输出。 + - `memory rem-backfill --path ...` 将可回滚的有依据日记条目写入 `DREAMS.md`。 + - `memory rem-backfill --path ... --stage-short-term` 将有依据的持久候选项暂存到普通 Deep 阶段已经使用的同一个短期证据存储中。 + - `memory rem-backfill --rollback` 和 `--rollback-short-term` 移除这些暂存的回填产物，而不会触碰普通日记条目或实时短期召回。 -Control UI 暴露了相同的日记回填/重置流程，因此你可以先在 Dreams 场景中检查结果，再决定这些有依据的候选项是否值得提升。该场景还会显示一条独立的有依据通道，因此你可以看到哪些暂存的短期条目来自历史重放、哪些已提升项目由有依据内容引导，并且只清除仅有依据的暂存条目，而不触碰普通实时短期状态。 +Control UI 暴露了相同的日记回填/重置流程，因此你可以在 Dreams 场景中检查结果，再决定有依据的候选项是否值得提升。该场景还会显示一条独立的有依据通道，让你看到哪些暂存的短期条目来自历史重放、哪些已提升项由有依据内容引导，并且可以只清除仅有依据的暂存条目，而不触碰普通实时短期状态。 ## Deep 排名信号 -Deep 排名使用六个加权基础信号和阶段强化： +Deep 排名使用六个加权基础信号以及阶段强化： -| 信号 | 权重 | 描述 | -| ------------------- | ------ | ------------------------------------------------- | -| 频率 | 0.24 | 条目累积了多少短期信号 | -| 相关性 | 0.30 | 条目的平均检索质量 | -| 查询多样性 | 0.15 | 呈现它的不同查询/日期上下文 | -| 新近性 | 0.15 | 随时间衰减的新鲜度分数 | -| 整合 | 0.10 | 多日重复出现强度 | -| 概念丰富度 | 0.06 | 来自片段/路径的概念标签密度 | +| 信号 | 权重 | 描述 | +| -------- | ---- | ---------------------------------- | +| 频率 | 0.24 | 条目累积了多少短期信号 | +| 相关性 | 0.30 | 条目的平均检索质量 | +| 查询多样性 | 0.15 | 使其浮现的不同查询/日期上下文 | +| 近因性 | 0.15 | 随时间衰减的新鲜度分数 | +| 整合度 | 0.10 | 多日重复出现的强度 | +| 概念丰富度 | 0.06 | 来自片段/路径的概念标签密度 | -Light 和 REM 阶段命中会从 `memory/.dreams/phase-signals.json` 添加一个小的、随新近性衰减的提升。 +Light 和 REM 阶段命中会从 `memory/.dreams/phase-signals.json` 添加一个小的、随近因性衰减的增强。 ## 调度 -启用后，`memory-core` 会自动管理一个用于完整 Dreaming 扫描的 cron 作业。每次扫描按顺序运行阶段：Light → REM → Deep。 +启用后，`memory-core` 会自动管理一个用于完整 Dreaming 扫描的 cron 任务。每次扫描都会按顺序运行各阶段：Light → REM → Deep。 + +扫描包括主运行时工作区以及任何已配置的 agent 工作区，并按路径去重，因此子智能体工作区扇出不会排除主 agent 的 `DREAMS.md` 和记忆状态。 默认节奏行为： -| 设置 | 默认 | +| 设置 | 默认值 | | -------------------- | ------------- | | `dreaming.frequency` | `0 3 * * *` | -| `dreaming.model` | 默认模型 | +| `dreaming.model` | 默认模型 | ## 快速开始 @@ -186,11 +188,11 @@ Light 和 REM 阶段命中会从 `memory/.dreams/phase-signals.json` 添加一 openclaw memory status --deep ``` - 除非用 CLI 标志覆盖，手动 `memory promote` 默认使用 Deep 阶段阈值。 + 手动 `memory promote` 默认使用 Deep 阶段阈值，除非通过 CLI 标志覆盖。 - 解释为什么某个特定候选项会或不会被提升： + 解释为什么某个特定候选项会或不会提升： ```bash openclaw memory promote-explain "router vlan" @@ -220,15 +222,15 @@ Light 和 REM 阶段命中会从 `memory/.dreams/phase-signals.json` 添加一 完整 Dreaming 扫描的 cron 节奏。 - 可选的梦境日记子智能体模型覆盖。同时设置子智能体 `allowedModels` 允许列表时，请使用规范的 `provider/model` 值。 + 可选的梦境日记子智能体模型覆盖。若同时设置子智能体 `allowedModels` 允许列表，请使用规范的 `provider/model` 值。 -`dreaming.model` 需要 `plugins.entries.memory-core.subagent.allowModelOverride: true`。若要限制它，还需设置 `plugins.entries.memory-core.subagent.allowedModels`。信任或允许列表失败会保持可见，而不是静默回退；重试只覆盖模型不可用错误。 +`dreaming.model` 需要 `plugins.entries.memory-core.subagent.allowModelOverride: true`。若要限制它，还要设置 `plugins.entries.memory-core.subagent.allowedModels`。信任或允许列表失败会保持可见，而不是静默回退；重试只覆盖模型不可用错误。 -阶段策略、阈值和存储行为是内部实现细节（不是面向用户的配置）。完整键列表请参阅[记忆配置参考](/zh-CN/reference/memory-config#dreaming)。 +阶段策略、阈值和存储行为是内部实现细节（不是面向用户的配置）。完整键列表请参阅 [Memory 配置参考](/zh-CN/reference/memory-config#dreaming)。 ## Dreams UI @@ -236,15 +238,15 @@ Light 和 REM 阶段命中会从 `memory/.dreams/phase-signals.json` 添加一 启用后，Gateway 网关 **Dreams** 标签页会显示： - 当前 Dreaming 启用状态 -- 阶段级 Status 和托管扫描存在情况 -- 短期、有依据、信号和今日已提升数量 -- 下一次计划运行时间 +- 阶段级 Status 和受管理扫描是否存在 +- 短期、有依据、信号以及今日已提升计数 +- 下次计划运行时间 - 用于暂存历史重放条目的独立有依据场景通道 - 由 `doctor.memory.dreamDiary` 支持的可展开梦境日记阅读器 -## 相关内容 +## 相关 - [记忆](/zh-CN/concepts/memory) -- [记忆 CLI](/zh-CN/cli/memory) -- [记忆配置参考](/zh-CN/reference/memory-config) -- [记忆搜索](/zh-CN/concepts/memory-search) +- [Memory CLI](/zh-CN/cli/memory) +- [Memory 配置参考](/zh-CN/reference/memory-config) +- [Memory 搜索](/zh-CN/concepts/memory-search)