记忆三层结构
「记忆」页分三块——跨项目的用户画像、项目规则 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)跟着项目目录走,随仓库提交就能带进版本库;长期记忆与此前的会话记忆放在工作区的独立目录里,删项目目录不会连带删除,反过来说也不会自动进版本库。