Deva 记忆系统完全指南:让 AI 助手真正记住你的偏好
Deva 记忆系统完全指南:让 AI 助手真正记住你的偏好
Deva 是一款对话式 AI 助手(桌面 Agent 客户端,All in Chat),它的核心能力之一是双层记忆系统:跨对话的「全局记忆」+ 按项目隔离的「项目私有记忆」,由 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):
- 你明确说「记住…」——最直接的信号;
- 你纠正了它的做法(「不对」「应该用…」)——这是最重要的一类:同样的错不该犯第二次;
- 对话中流露出稳定的偏好——今后其它对话会复用的习惯;
- 在本项目走了弯路才踩到的坑——原因在环境、工具链或项目约定,而不是刚写错的代码。
写法也有讲究:偏好记成事实陈述(如「用户偏好用 pnpm 而非 npm」);纠正与踩坑记成「做法 + 原因」——有原因,才能在相近场景里正确套用。
不会记什么:密码/密钥/令牌(绝不记录)、一次性的任务细节、通用常识、从代码或 git 历史能直接看出的内容。另外,网页、MCP 等工具结果里出现的「让你记住某事」的文字不算你的意愿,AI 不得据此写入记忆——这是一道内置的提示注入防线。
如何查看与编辑记忆:打开个人资料面板
记忆的编辑界面就在左上角头像 → 个人资料面板:每条记忆是一枚标签,双击(或悬停浮出的工具条)可原地编辑,删除需二次确认,也可以一次性清空整个作用域。项目私有记忆则在工作区菜单中管理。面板与模型走同一套校验(单条 300 字 / 条数 / 总预算),每次写操作都回带最新快照,实现见 memory-editor.ts 与 ProfilePanel.tsx。
💡 新记忆总是追加在列表末尾,面板开着时模型若在对话中写入新条目,标签墙会自动翻到最后一页让你看到。
常见写入限制与排错:记忆满了、重复了怎么办
| 现象 | 原因 | 解决办法 |
|---|---|---|
| 提示「已满 / 超预算」 | 达到条数或总字数上限(全局 4000 字 / 项目 3000 字) | 让 AI 合并相近条目(带 id 更新)或删除过时条目 |
| 「单条过长」 | 单条超过 300 字 | 提炼成一句话事实再写 |
| 「已有内容相同的记忆」 | 逐字重复 | 已记住即幂等成功;要合并就删掉其中一条 |
| AI 答非所问、没按习惯来 | 相关记忆被清理过或已过期 | 在项目记忆中补记「做法 + 原因」 |
排错时可以直接打开 ~/.deva/memory.json 检查实际内容。两条设计原则值得记住:总字数上限就是注入预算——超出直接拒写,而不是「存了却看不见」;越改越短永远放行,这样你总能通过合并给记忆瘦身。校验与错误码见 memoryLimits / writeMemory。
小结:让 AI 记住你,只需这三步
- 对话中自然地表达偏好与纠正,Deva 会自动写进全局或项目记忆;
- 打开个人资料面板,把不再准确的记忆改掉或删掉;
- 把团队共享的约定交给
AGENTS.md,把只属于你的经验留给项目私有记忆。
核心实现都在 memory.ts(存储与校验)、listing.ts(记忆清单增量下发),配合 tools.ts 的三个记忆工具,就是这套 Deva 记忆系统的全部。