文档记忆与规则
文档目录

记忆三层结构

「记忆」页分三块——跨项目的用户画像、项目规则 AGENTS.md、项目长期记忆;越往下越具体,也越不常驻。

更新于 2026年11月10日

左侧栏「记忆」是一个独立的页面,副标题是「管理 Agent 对你的了解与项目知识」,里面只有两个页签:「关于你」和「当前项目」。三块内容就分在这两个页签里,加载顺序和用途各不相同。

三层分工

  • 用户画像:在「关于你」里,记录你的长期偏好与协作习惯,所有项目共用,每次会话都会加载。
  • 项目规则:在「当前项目」的 AGENTS.md 里,记录项目通用的规则,以及项目协作知识和专属偏好。
  • 项目长期记忆:在「当前项目」的 MEMORY.md 与它指向的 memory/ 专题里,写只在特定场景才需要的排查经过、部署手册、模块细节;平时只带索引,按需读取。

关于你

标题是「用户画像」,带「全局共享」徽标,说明写的是「记录你的长期偏好与协作习惯,所有项目共用。」

  • 左栏「资料状态」显示「最近更新」和「最近核验」两个时间,没记录时是「暂无记录」。
  • 下方是历史版本列表,空态「还没有历史版本。每次写入都会保留上一版。」
  • 右侧「画像内容」,有未保存改动时标题后追加「未保存」;上方是画像文件的绝对路径和「在文件夹中显示用户画像」。
  • 空画像显示「尚未建立画像。可以写下希望 Agent 记住的偏好,也可以在对话中逐步积累。」

这一层与其他内容不同:不会自动保存。改完必须点「保存」或按 Cmd/Ctrl + S,成功后提示「已保存,所有项目的后续 Agent 请求将使用这份画像」。

存在旧版画像或未完成的整合时,这里多一个「整合画像」按钮,说明是「全局画像在所有项目中共享。项目专属偏好可在「当前项目」中补充。」

当前项目

顶部是项目名和「N 个记忆文件」,说明「项目规则、协作知识与专属偏好,与 Agent 使用同一份文件。」——你在界面上改的就是 Agent 读的那份,没有第二份副本。

左侧「记忆文件」分两段:

  • 第一行固定是「项目 AGENTS.md」,规则层。
  • 下面是「长期记忆」,按目录树列出 MEMORY.md 索引和它指向的专题文件,索引排在最前,每行标文件大小,悬停出现「打开文件所在位置」。

注意

  • 用户画像是全局的,写进去的偏好会影响所有项目;只对某个项目成立的约定放到「当前项目」。
  • 画像有字数预算,超出后保存失败并提示「Profile 超过 5000 字符,未保存;请整理后重试。」,所以只放短句级的稳定事实。
  • 三层都不是聊天记录:会话里说过的话不会自动落进任何一层,需要长期生效就明确要求 Agent 记下来,或自己写进文件。
  • 规则(AGENTS.md)跟着项目目录走,随仓库提交就能带进版本库;长期记忆与此前的会话记忆放在工作区的独立目录里,删项目目录不会连带删除,反过来说也不会自动进版本库。
本页内容