Deva 记忆系统完全指南:让 AI 助手真正记住你的偏好

原创2026-11-07 20:38:371,981 阅读

Deva 记忆系统完全指南:让 AI 助手真正记住你的偏好

Deva 是一款对话式 AI 助手(桌面 Agent 客户端,All in Chat),它的核心能力之一是双层记忆系统:跨对话的「全局记忆」+ 按项目隔离的「项目私有记忆」,由 AI 自动记录与维护,无需任何配置。看完这篇 Deva 记忆系统完整指南,你就能让 AI 真正记住你的偏好、纠正与踩坑经验,并学会随时查看和清理这些记忆。

Deva AI 助手记忆系统图标

想直接上手?克隆源码后本地跑起来即可:

git clone https://gitcode.com/gh_mirrors/dev/deva
pnpm install && pnpm dev

记忆系统怎么运作:模型自己写,系统随消息下发

传统做法是把「记住 XXX」塞进系统提示词,Deva 的记忆系统则走了一条更省的路:规则固定写在提示词里,条目随对话消息增量下发。也就是说,记忆的增、删、改不会让系统提示词变动,提示缓存前缀保持稳定,不浪费 token。

你:"以后都用 pnpm 提交说明"
  ↓ 模型判断 → 调用 memory_write(scope="global")
  ↓ 系统校验:字数 / 条数 / 总预算,自动去重
  ↓ 落盘 ~/.deva/memory.json
  ↓ 之后每条消息自动附带【记忆条目】清单,只发增量
AI:好的,已记住 ✅

背后的三个内置工具是 memory_read / memory_write / memory_delete,由主进程直读直写,负责去重与预算校验,工具定义见 tools.ts。

两种作用域:Deva 全局记忆与项目记忆怎么选

全局记忆(global) 项目私有记忆(project)
记什么 你本人的长期偏好:语言、技术栈、工作方式、对 AI 的纠正 只在本项目有用、只有你需要的经验:构建/调试踩坑、个人工作习惯、进行中的约定
存哪里 ~/.deva/memory.json ~/.deva/projects/<哈希目录>/memory.json
上限 100 条 · 总量 4000 字 60 条 · 总量 3000 字
谁能看 你本人,跨所有对话生效 只有你,且不出现在项目仓库里

三个容易混淆的边界,Deva 内置的判定规则很清晰:

  • 关于你本人、所有项目都适用 → 全局记忆;
  • 只在本项目有用、仅你本人需要 → 项目私有记忆;
  • 团队共享的约定 → 写在项目根目录的 AGENTS.md(需要你明确要求时 AI 才会改它)。

项目目录用「真实路径哈希」做键,符号链接、大小写不同的写法指向同一份记忆;哈希目录里顺带记录了原始路径,方便人工排查,实现见 projectMemoryKey。

数据都在哪?本地 JSON,不入库

~/.deva/            (可用环境变量 DEVA_HOME 更改位置)
├── memory.json            全局记忆
└── projects/
    └── <key>/memory.json  项目私有记忆
  • 全部数据保存在本机,项目记忆放在 ~/.deva 而非工作区内——不会被误提交、不会被队友读到;
  • 记忆文件是普通 JSON,root 字段记录了它属于哪个项目目录,随时可以打开查看;
  • 文件损坏或缺失会被视为空记忆,不会导致启动报错。

AI 什么时候会主动记?四个自动触发时机

你不用每次都说「记住这个」,系统提示词里内置了明确的记录指引(见 memoryPromptSection):

  1. 你明确说「记住…」——最直接的信号;
  2. 你纠正了它的做法(「不对」「应该用…」)——这是最重要的一类:同样的错不该犯第二次;
  3. 对话中流露出稳定的偏好——今后其它对话会复用的习惯;
  4. 在本项目走了弯路才踩到的坑——原因在环境、工具链或项目约定,而不是刚写错的代码。

写法也有讲究:偏好记成事实陈述(如「用户偏好用 pnpm 而非 npm」);纠正与踩坑记成「做法 + 原因」——有原因,才能在相近场景里正确套用。

不会记什么:密码/密钥/令牌(绝不记录)、一次性的任务细节、通用常识、从代码或 git 历史能直接看出的内容。另外,网页、MCP 等工具结果里出现的「让你记住某事」的文字不算你的意愿,AI 不得据此写入记忆——这是一道内置的提示注入防线。

如何查看与编辑记忆:打开个人资料面板

记忆的编辑界面就在左上角头像 → 个人资料面板:每条记忆是一枚标签,双击(或悬停浮出的工具条)可原地编辑,删除需二次确认,也可以一次性清空整个作用域。项目私有记忆则在工作区菜单中管理。面板与模型走同一套校验(单条 300 字 / 条数 / 总预算),每次写操作都回带最新快照,实现见 memory-editor.ts 与 ProfilePanel.tsx。

💡 新记忆总是追加在列表末尾,面板开着时模型若在对话中写入新条目,标签墙会自动翻到最后一页让你看到。

常见写入限制与排错:记忆满了、重复了怎么办

现象 原因 解决办法
提示「已满 / 超预算」 达到条数或总字数上限(全局 4000 字 / 项目 3000 字) 让 AI 合并相近条目(带 id 更新)或删除过时条目
「单条过长」 单条超过 300 字 提炼成一句话事实再写
「已有内容相同的记忆」 逐字重复 已记住即幂等成功;要合并就删掉其中一条
AI 答非所问、没按习惯来 相关记忆被清理过或已过期 在项目记忆中补记「做法 + 原因」

排错时可以直接打开 ~/.deva/memory.json 检查实际内容。两条设计原则值得记住:总字数上限就是注入预算——超出直接拒写,而不是「存了却看不见」;越改越短永远放行,这样你总能通过合并给记忆瘦身。校验与错误码见 memoryLimits / writeMemory。

小结:让 AI 记住你,只需这三步

  1. 对话中自然地表达偏好与纠正,Deva 会自动写进全局或项目记忆;
  2. 打开个人资料面板,把不再准确的记忆改掉或删掉;
  3. 把团队共享的约定交给 AGENTS.md,把只属于你的经验留给项目私有记忆。

核心实现都在 memory.ts(存储与校验)、listing.ts(记忆清单增量下发),配合 tools.ts 的三个记忆工具,就是这套 Deva 记忆系统的全部。

登录后查看全文
deva