> ## 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.
# 记忆系统
> 记忆用于跨会话保存稳定职责、偏好、规则和项目经验。
记忆用于跨会话保存稳定职责、偏好、规则和项目经验。一次性要求和临时限制应写在当前任务中。
## 查看记忆并确认作用范围
| 层级 | 生效范围 | 适合记录 |
| ---- | ----------------- | ------------ |
| 个人记忆 | 当前 Waker 的不同会话和项目 | 职责、稳定偏好和通用规则 |
| 项目记忆 | 指定项目 | 项目结构、约定和交付规范 |
系统可能自动归纳记忆，但重要规则仍需人工检查。
1. 进入目标 Waker 详情。
2. 点击「记忆」，在「记忆概览」或「全部记忆」中查看内容。
3. 通过搜索框、分类卡片或项目下拉框定位目标记忆。
4. 在「全部记忆」中确认当前是个人范围还是项目范围。
5. 编辑项目记忆前核对项目名称和状态；初始化失败时点击「重试初始化」。
6. 不再使用的项目可归档，归档前确认后续任务不再依赖它。
新 Waker 尚未产生有效会话时，页面可能显示"暂无内容"。
个人规则跨项目生效，项目规则只在指定项目生效。不要把项目特例写入个人记忆。
## 编辑记忆
1. 在分类卡片中找到目标分类。
2. 点击「编辑」，用简短、明确的 Markdown 修改内容并保存。
3. 到「记忆时间线」确认出现手动编辑记录，再用新对话验证。
跨分类调整时使用「编辑完整记忆」；普通修改优先编辑单个分类。出现内容冲突提示时，先载入最新内容并比较差异，不要直接覆盖。
## 追溯、回滚和维护记忆
### 追溯变更
1. 切换到「记忆时间线」。
2. 按时间和来源筛选，打开记录查看范围、分类和变更内容。
3. Waker 突然遵循错误规则时，先查找最近的新增或更新记录。
### 回滚历史版本
1. 在记忆页点击「版本管理」。
2. 选择版本，查看完整内容及差异。
3. 核对作用范围后点击「回滚」。
4. 返回当前版本检查内容，并用新对话验证。
定期删除一次性要求、过期约定、未经确认的结论和重复规则；检查个人/项目范围是否正确。密码、Token 和客户隐私不得写入记忆。
## 记忆异常排查
| 现象 | 处理方法 |
| ------------- | ---------------------------- |
| 新 Waker 没有记忆 | 先完成有效会话，等待自动归纳；必要时手动添加稳定规则 |
| 项目记忆一直初始化中 | 刷新页面；确认项目仍存在；失败时点击「重试初始化」 |
| Waker 没遵循某条规则 | 确认规则所在范围；检查是否与更具体规则冲突；新开会话验证 |
| Waker 遵循了过时规则 | 在概览搜索关键词 → 查看时间线来源 → 编辑或回滚 |
| 保存时发生冲突 | 载入最新内容并比较差异，不要盲目覆盖 |
| 回滚后看似没有变化 | 确认个人/项目作用范围，并刷新当前版本 |
记忆修改后的验收方式：新开一条对话，提出能明确检验该规则的问题；不要只根据记忆页面显示内容判断实际使用效果。