跨智能体会话记忆vshulcz/deja-vu

所有编程智能体共用的一份记忆，来自你磁盘上已有的历史。

你的智能体正准备重新调试一个你三月份就修好的问题——当时是在另一个智能体里修的。deja 索引 Claude Code、Codex、Cursor
以及这台机器上其他所有智能体本来就写在磁盘上的会话，无论哪个智能体来问，都把对的那一条交回来。

没有人去搜索——是智能体自己调用了 deja。每一行都引自两个真实会话。

其他记忆工具都从空白开始，往后记录。deja 一开始就是满的。

LongMemEval-S 上 85.3% hit@1 · LoCoMo 上 69.7% · 数 GB 历史上的查询在毫秒级
两套评测都在本仓库里，几分钟即可在公开数据集上跑完 ·
自己核对这些数字

文档 · 评测 · 与同类对比

安装

curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto

安装十秒，建索引约十秒，然后就能用了。第二条命令会把 MCP 召回接到它找到的每一个智能体上，
在支持的地方打开会话启动时的召回，并建好第一份索引，这样下一次会话不必再等。

打开一个新的智能体会话，问一件几个月前做过的事：

我们以前处理过 jwt refresh rotation 吗？查一下你的记忆

也不必特意去问——开启自动召回后，会话一打开，智能体就已经知道你在这个项目里解决过什么。

opencode、DeepSeek Harness、Zed、Kimi Code、Codex CLI 和 Grok Build 也有各自生态里的包，习惯在那边装扩展的人
可以直接用：

opencode plugin opencode-deja
dsh plugin --profile web add dsh-deja
Zed：扩展面板里搜 deja
Kimi Code：/plugins install https://github.com/vshulcz/deja-vu
Codex CLI：codex plugin marketplace add https://github.com/vshulcz/deja-vu && codex plugin add deja-vu@deja-vu
Grok Build：grok plugin marketplace add xai-org/plugin-marketplace && grok plugin install deja

deja install --auto 已经把这六个接好了，两条路走哪条都够。两边都装也没问题：包会看
deja install 写了什么，只补上缺的部分，不会重复注册工具、也不会重复召回。详见
extensions/。

同一套搜索也是一个 skill，任何会读 SKILL.md 的智能体都能装：

npx skills add https://github.com/vshulcz/deja-vu --skill deja-search   # skills CLI：Claude Code、Cursor、Goose、Copilot…
openclaw skills install @vshulcz/deja-search                            # ClawHub
hermes skills install vshulcz/deja-vu/skills/deja-search                # Hermes

skill 调用的是上面装好的 deja 二进制，自己不带。

其他安装方式：brew install deja-vu、
go install github.com/vshulcz/deja-vu/cmd/deja@latest，或者用
npx @vshulcz/deja-vu "查询词" 先试试而不装任何东西。Windows 上安装脚本会退出并提示
unsupported OS——它是 shell 脚本，请从
最新发布取
deja-vu__windows_amd64.zip，把 deja.exe 放进 PATH。

只有二进制文件也是一次完整安装：索引、搜索、show、ctx、blame、--json
和脱敏都不需要别的东西。deja install 负责的是把 MCP 接进你的智能体、打开会话启动召回——值得有，但可选。

能得到什么

在 Codex 里解决，Claude 记得。 二十五个编程智能体把每一次对话都写进本地文件，
deja 把这些文件变成一层它们都能读的记忆。

| | |
| --- | --- |
| 回溯式搜索 | deja "connection pool exhausted" 搜遍几个 GB，包括你安装 deja 之前的一切。自然语言提问会退化到相关性档位。时间是提示，不是过滤条件。 |
| 跨智能体召回 | MCP 的 recall 工具在任何一个智能体里都能回答「这个我们三周前修过」，不管当初是谁修的。 |
| 压缩之后仍然在 | 在 43 次上下文压缩上实测：摘要保住了 77% 的决策和 0.2% 的你跑过的命令。其余 99.8% 由 deja 交回。在 Claude Code 和 Codex 上，压缩刚开始时 deja 就把任务、文件和命令记下来，下一个会话里一次性交回。 |
| 在动手的那一刻召回 | 智能体改文件或跑命令之前，PreToolUse 钩子会说出这个文件此前的决定、这条命令能用的写法，或者这台机器上根本没有的那个程序。命令失败时，PostToolUse 钩子给出这台机器上同样报错之后跑过什么——那正是智能体不会主动去问的一对。 |
| 索引的是活儿，不只是话 | 每一轮打开过的文件、跑过的命令及其退出码、以及一次编辑替换掉的确切片段。那正是所有摘要都会丢掉的部分。 |

还有：deja promote  --state rejected 标注被推翻的决定，此后每一次命中都会显示它试过并被否决；
命中会报告「本会话涉及的 4 个文件此后已变更」，判断不了时就不说；
deja sync ssh laptop 在机器之间搬运记忆，只追加、中间没有云；
deja handoff --to codex 把当前上下文打包，好在另一个智能体里接着做；
已知形态的密钥、令牌、JWT 和私钥块在建索引时会被剥掉；模式匹配不是密钥检测，未知形态可能漏过。

把你自己的工作画出来

deja stats --card 直接画在终端里；给它一个文件名，它会写出一张 SVG，可以放进个人主页的 README。要发到别处，就把它转成 PNG——那个页面在你自己的浏览器里完成转换。

完整的功能参考在文档站。

隐私

建索引和搜索都在本地。只有 deja update、deja sync ssh 和 deja doctor 里的版本检查会用到网络。

凭据在建索引时脱敏：AWS 密钥、api_key= 与 token= 赋值、bearer 令牌与裸 JWT、PEM 私钥块、
各家提供商的令牌、scheme://user:pass@host 形式的 URL、没有规则能匹配的高熵值，
以及写在散文里的口令——「the admin password is …」这种没有任何分隔符可依的写法。
值会变成 [redacted:]，周围的文本仍然可搜。deja share 和 deja sync export 在导出时再做一次脱敏。模式匹配不是密钥检测：规则不认识的形态可能原样通过，见安全模型。

deja forget 把会话从重建后的索引里移除并写下墓碑，之后的 deja index 无法从原始历史里把它们恢复回来。
安全模型记录了数据流向、脱敏的边界、信任假设与发布验证。

命令行

$ deja "jwt refresh token"
[claude] api        · Jul 8 · 8f31c0a9 — 2 matches
login started failing after refresh token rotation; jwt kid mismatch in tests
fixed by reloading jwks cache after rotateKey and adding a clock-skew test
[codex]  web        · Jul 1 · b77d91e2 — 1 match
refresh token cookie needed SameSite=Lax in local callback flow

| 命令 | 作用 |
| --- | --- |
| deja  | 搜索所有历史。多个词是 AND，引号内要求连续文本；没有精确命中时会尝试词形与近似拼写。 |
| deja wip | 这个目录里上一个会话在做什么：任务、定下来的结论、手上的文件、最后一条命令以及它是否失败。全部从记录里推出来，不依赖谁记得写笔记。 |
| deja blame [:行号] | 哪些会话讨论过这个文件、当时决定了什么、为什么。给出行号时：最后改动这一行的提交，以及写下被这次提交删掉的那段文本的会话。 |
| deja files  | 反方向：某个主题的工作实际动过哪些文件。 |
| deja how  | 这台机器实际怎么跑一件事，带真实参数，来自智能体此前跑过的命令。 |
| deja fix  | 这台机器上同样的报错之后跑过什么，且那次之后错误没有再出现。 |
| deja friction | 命中三个以上不同会话的报错，并指出来自哪些工具。 |
| deja ctx  | 最佳命中的 Markdown 摘要，可直接接进提示词。 |
| deja resume  | 在原来的工具里重新打开找到的那个会话。 |
| deja view | 把整个记忆导出成一个本地 HTML 文件。没有服务端，数据不离开本机。 |
| deja doctor [--deep] | 自检；加 --deep 时用源文件验证索引。 |
| deja mcp | stdio 的 MCP 服务端，也就是 deja install 接进去的那个。 |

完整参考见命令文档。

MCP 工具

服务端只暴露一个工具 deja，用 mode 参数选择能力：recall、context、blame、fix、how、remember。
deja install 会自动接好，只有手工配置智能体时才需要关心它。原来的六个工具名对已经接好的客户端仍然有效。

支持的工具

开启自动召回后，Claude Code 和 Codex 会在压缩开始时把当前记录交给 deja，它留下摘要即将丢掉的东西：
任务、结论、文件、每条命令跑成了什么、以及还剩什么没做完。同一个会话、同一个工作目录下的下一个钩子
会把这些一次性交回，总量不超过 4 KB，并附一行说明仓库此后有没有变动。
deja stats 统计压缩之后到第一次编辑之间的工具调用次数，这个功能就是拿它来衡量的。
细节见压缩后自动恢复。

Claude Code · Cline · Codex CLI · opencode · aider · Gemini CLI · Cursor · Antigravity ·
Grok Build · Hermes · Goose · Qwen Code · Kimi Code · pi · omp (Oh My Pi) · OpenClaw ·
Copilot CLI · VS Code Copilot Chat · Amp · prime-agent (PrimeIntellect) · Roo Code ·
Continue · Crush · DeepSeek Harness · Zed。

每个工具分别支持 MCP 召回、自动召回、技能、命令、resume 和 handoff 中的哪些，见
英文 README 的能力矩阵。自定义存储位置通过 DEJA_*_ROOT
变量指定，各家自己的迁移变量也会被尊重。

自带插件包的智能体

deja install --auto 会像接其他工具一样把下面这几个接好，那始终是最短的一条路。
它们同时在各自的生态里有一个包，方便习惯从那边装扩展的人：

| 智能体 | 包 | 安装 |
| --- | --- | --- |
| opencode | npm opencode-deja | opencode plugin opencode-deja |
| DeepSeek Harness | npm dsh-deja | dsh plugin --profile web add dsh-deja |
| Zed | deja-context-server | Zed → Extensions → deja |
| Kimi Code | 插件 deja | /plugins install https://github.com/vshulcz/deja-vu |
| Codex CLI | 插件 deja-vu | codex plugin marketplace add https://github.com/vshulcz/deja-vu，然后 codex plugin add deja-vu@deja-vu |
| Grok Build | 插件 deja | grok plugin marketplace add xai-org/plugin-marketplace，然后 grok plugin install deja |

两条路各自都够用，两条都走也不会出问题：opencode、dsh、Kimi、Grok 和 Codex 的包会读
deja install 写下的配置，只补上缺的那部分；在 Zed 里两边用的是同一个 server id，
所以无论先装哪个都不会重复。

它们用的都是你已经装好的 deja，包里自带的那份只是兜底。

可选的语义召回

用 DEJA_EMBED_URL 把 deja embed 指向本地的 Ollama、LM Studio 或任何 OpenAI 兼容端点，
换个说法提问也能命中。没有可用的运行时，词法搜索和 MCP 召回照常工作。

证据

deja bench recall     # 排序回归下限：100 条查询，一半是俄语，召回下降时 CI 失败
deja bench context    # 30 条带种子的任务链，外加五个负对照
deja bench block      # 交出去的那段文字里还剩不剩答案
deja bench prompt     # 逐条提示的钩子在什么时候开口，又在什么时候开错
deja bench ingest     # 一次索引更新的代价：没有变化、追加一轮、新增一个记录文件、整文件重写

上下文实验把 deja 召回与全量历史、朴素 grep 和冷启动作对比。默认种子下：

| 方案 | token 中位数 | 覆盖率中位数 | 负对照 token |
| --- | ---: | ---: | ---: |
| deja-recall | 1,096 | 1.00 | 0 |
| full-history | 80,547 | 1.00 | 78,145 |
| naive-grep | 273,238 | 1.00 | 0 |
| cold | 0 | 0.00 | 0 |

与直接 grep 原始日志相同的事实覆盖率，token 少约 250 倍；比完整重放命中的会话少约 70 倍；
在没有相关历史的链条上则什么都不注入。语料生成器和相关性标注是普通的、可审阅的 Go 代码。
在相信任何数字之前，先审清「相关」是怎么定义的——包括我们的数字。

在一份真实的仓库上测得：2,419 个会话、179k 条消息，共 1.9 GB 的记录。

| 指标 | 结果 |
| --- | --- |
| 进程内查询 | 中位数 ~0.7 ms，LongMemEval-S 干草堆上约 19 ms |
| deja  端到端 | 该仓库上中位数约 0.2 s：进程启动、对所有存储做新鲜度检查、排序、打印 |
| 仅新鲜度检查 | 没有变化时约 50 ms |
| 索引大小 | 200 MB，约为语料的 10% |

索引是增量的。会话文件变长时，只重新读那一个文件。

工作原理

~/.cache/deja 里的本地倒排索引：解析 JSONL 与 SQLite 存储、脱敏凭据、写出 records.bin
和词桶，并在 manifest.gob 里记录每个文件的状态，因此重复运行只摄入变化的部分。
MCP 服务端、统计、分享和同步都读这一份索引。细节见
docs/ARCHITECTURE.md。

常见问题

有东西离开我的机器吗？ 没有，除非你主动要求。见数据流向。

日志里已经有的密钥怎么办？ 它们留在原本的工具文件里，那是你的智能体的数据。
它们不会进入 deja 的索引、摘要、分享或同步导出。

会拖慢我的智能体吗？ 一次召回是对本地索引的词法查询：中位数 ~0.7 ms，没有任何东西在等模型。
钩子会额外加上进程启动和对存储的新鲜度检查——几个 GB 的仓库上是几十毫秒。

我需要改变工作方式吗？ 不需要。是智能体自己调用召回；开启自动召回后，
会话一打开它就已经知道这个项目此前的决定。

和其他记忆工具有什么不同？

| | deja | 记忆平台(Mem0、Letta、memU) | 会话检索(cass) |
| --- | :-: | :-: | :-: |
| 知道安装它之前的工作 | 是 | 否 | 是 |
| 需要采集步骤 | 不需要，转录本身就是记忆 | 由智能体或你的代码写入事实 | 不需要 |
| 需要大模型或嵌入密钥 | 否 | 是 | 可选 |
| 不用问也会召回 | 会话开始时、以及工具执行前 | 否 | 否 |

完整对比覆盖了其中十一个。

Claude Code 的会话历史存在哪里，能搜索吗？ 在 ~/.claude/projects 下，每个会话一个 JSONL 文件；Codex 存在 ~/.codex/sessions，Cursor 存在 SQLite 的 state.vscdb。deja search 就地读取它们，deja last 列出每个智能体最近的会话，deja view 把全部历史打开成一个本地页面。各智能体的路径见会话存在哪里。

Claude Code 的会话历史不见了，是丢了吗？ Claude Code 会删除 30 天以前的记录（~/.claude/settings.json 里的 cleanupPeriodDays），claude --resume 只列出还剩下的。deja 在清理前索引过的会话，文件没了之后仍然可以搜索。详见磁盘上的会话文件。

怎么全部清除？

deja uninstall --all
rm -rf ~/.cache/deja

指南

按场景写的，不是按功能：

- 快速开始（中文）——安装、接上智能体、第一次查询
- 编程智能体记得之前的对话吗（中文）——各个工具跨会话留下了什么
- 为什么智能体会忘事（中文）——会话结束时消失的是什么
- 编码智能体记得之前的对话吗？——每个智能体在会话之间留下了什么，又丢掉了什么
- 磁盘上的会话文件——~/.claude/projects 会长到多大，删掉要付出什么代价
- 智能体把你刚才的上下文弄丢了——崩溃之后、清空之后，或者会话回来时空空如也
- 上下文窗口满了——压缩到底保住了什么，实测数据，以及可以换成什么做法
- 接着昨天的会话做——跨所有智能体找到它，再回到它原来所属的那一个里打开
- 智能体又犯了你已经修过的错
- 找到当初解决它的那次会话
- 为什么智能体在会话之间会忘事 · 每个智能体把历史存在哪里
- 压缩会丢掉什么 · 换一个智能体 · 审计智能体做过什么 · 导出一次对话 · 跨机器 · 记忆要花多少 token

按工具：opencode · DeepSeek Harness（中文） · Kimi Code（中文） · Zed · Grok Build · Gemini CLI · Qwen Code（中文） · OpenClaw · Goose · Cline · pi and omp · Hermes

在你自己的历史上试一次

curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto

装好十秒，建索引十来秒。下一次智能体打开会话，它就已经知道你在这个项目里解决过什么——
包括你装 deja 之前的那些。

参与开发

make build test lint，然后看 CONTRIBUTING.md。
新增一个工具从解析器注册表开始。
优先级与非目标见 ROADMAP.md。

许可

MIT © Vladislav Shulcz