文档记忆与规则
文档目录

记忆维护与历史版本

Agent 写记忆会在右侧弹出「知识更新」清单;画像有历史版本可回滚,项目记忆被外部改过会停下保存等你确认。

更新于 2026年11月10日

记忆文件通常不需要手动修改:Agent 在对话里按证据增量维护,加一条偏好、补一条项目经验、把过期主题归档。可干预的环节是事后核对、冲突处理和版本回滚。

知识更新

Agent 实际写入记忆文件后,右侧工作区会多出一个「知识更新 · N」标签,标签上的数字是变动的文件数。

  • 每张卡片显示文件路径、「新增」或「删除」标记,以及被移除的 N 行。
  • 「源码」和「渲染」两个视图切换:一份是原始 Markdown,一份是渲染结果。
  • 「查看」打开原文件;全局画像走预览编辑器,项目记忆则把「记忆」页切到对应文件。
  • 右上「完成」收起这批提示。
  • 无法生成受限对比时显示「该文件已变化,但无法生成受限文本 Diff。」

历史版本

只有「关于你」里的用户画像有历史版本。

  • 列表每条显示时间、「当前」徽标和摘要(没有摘要时显示字数)。
  • 打开一条是「历史版本 · 时间」的全文预览,带「恢复此版本」。
  • 恢复不是覆盖旧记录:它把那一版内容写成新的当前版本,原来的历史仍然留着。
  • 每次写入都会保留上一版,所以回到任意一版都能追溯。

冲突与失败

  • 画像被其他会话改过时,编辑器顶部出现横幅「画像已被其他会话更新。你的修改已保留,请复制后与最新内容合并。」;点「载入最新内容」会先问「放弃当前草稿?」,取消是「保留草稿」。
  • 项目记忆文件被外部编辑器改过时,保存会停住并提示「文件已被外部更新,已停止保存以避免覆盖。请复制你的修改后刷新文件。」,按钮「刷新文件」;同时有「需要合并修改」状态。
  • 文件超过大小上限会报「内容过大(x MB),超过 10 MB 限制」。
  • 还有未完成的旧画像整合时写入会被拒绝,提示先把迁移收尾再更新;画像页此时保存按钮不可用。

旧内容处理

  • 旧画像存在时,「关于你」出现「整合画像」:不是后台静默操作,而是新建一个标题为「整合画像」的会话去执行合并。未保存草稿时提示「请先保存当前画像修改,再整合画像。」;没有可写项目时提示「请先选择一个可用项目,再整合画像。」
  • 部分旧画像读不出来时,显示「部分旧画像暂时无法整合,不影响查看当前全局画像。」并列出路径与原因。
  • 项目页对旧的记忆目录、旧的工作区规则显示黄色提示「待处理:长期记忆迁移、工作区规则迁移,请检查旧文件。」,免得新旧两份同时生效。
  • 旧规则合并完成前,原文仍会被 Agent 读到;合并后归档到非规则位置,不再参与加载。

注意

  • 项目记忆没有历史版本界面,想回退只能靠 Git 或自己备份;真正重要的项目知识建议随仓库提交。
  • 恢复画像版本会立刻影响所有项目,恢复前先确认那一版是不是你要的。
  • 「知识更新」只是提示,不需要审核。
  • 外部编辑器和 Agent 同时写同一个文件,后写的一方会被拦下,说明「已停止保存以避免覆盖」,这属于正常保护。
本页内容