> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 记忆系统
> Memory 让 Waker 跨会话保持上下文，随交互不断积累经验与知识。
Memory 是让 Waker 跨会话保持上下文的机制，使 Waker 能够随着交互不断积累经验和知识。
## 工作原理
Waker 的记忆分为两个层级：
* **Waker 画像**：描述 Waker 核心特征的记忆，在该 Waker 的所有会话中生效，不受项目限制。
* **项目记忆**：与特定项目相关的经验和知识，仅在关联该项目的会话中生效。
**记忆来源：**
* 会话过程中自动提取的重要信息
* 用户手动编辑写入的内容
* Memory Dream 机制自动归纳整理的结论
* 外部文件导入
## 记忆管理界面
进入 Waker 详情页的「记忆」Tab 管理记忆内容。
**全部记忆视图：**
以列表形式展示所有记忆条目，每条记忆显示内容摘要、来源（自动/手动）、生效范围和创建时间。支持以下操作：
* **搜索**：在顶部搜索框输入关键词过滤记忆内容。
* **编辑**：点击记忆条目进入编辑模式，直接修改内容。
* **删除**：点击删除按钮移除不需要的记忆。
* **分类查看**：通过标签页切换 Waker 画像和项目记忆的显示。
## 时间线视图
切换到「时间线」视图后，记忆按时间轴展示变化历程：
* 纵向时间线直观呈现记忆的新增、修改和删除记录
* 每个节点显示操作类型、时间和内容摘要
* 点击节点可查看该次变更的完整详情
* 帮助理解 Waker 记忆的演变过程
## 版本管理
每次记忆变更自动创建版本快照，提供完整的版本管理能力：
* **版本列表**：查看所有历史版本，包含版本号、时间和变更摘要。
* **版本对比**：选择两个版本进行差异对比，高亮显示变更内容。
* **回滚操作**：点击「回滚到此版本」恢复到任意历史状态。
* **手动快照**：点击「创建快照」手动创建版本，可添加标签以便识别。
## Memory Dream
Memory Dream 是自动记忆整理机制，默认每天凌晨自动运行：
* 归纳最近会话中的重要信息
* 合并重复和冲突的记忆条目
* 清理过时或不再相关的信息
* 提炼高价值行为模式
如需立即整理记忆，可在记忆管理界面点击「立即整理」按钮手动触发 Dream 执行。
## 导入与导出
记忆支持导出为 JSON 文件进行备份，也支持从文件导入。在记忆 Tab 的操作菜单中选择「导出」或「导入」：
* **导出**：将当前 Waker 的所有记忆导出为 JSON 文件。
* **导入**：从 JSON 文件导入记忆，与现有记忆合并，不会覆盖已有内容。
## 记忆管理建议
* 定期查看记忆内容，清除不准确或过时的条目。
* 重要的业务规则和约束可手动写入记忆，确保 Waker 始终遵守。
* 利用版本管理在记忆重要变更前创建快照。
* 将不同项目的经验分开存储在对应的项目记忆中。