vshulcz/deja-vu

别再让编程智能体重新调试你已经修好的问题。

Claude Code、Codex、Cursor、OpenClaw、Gemini CLI、OpenCode、Hermes 以及另外 37 个智能体本来就把每次会话写在磁盘上。
deja 在本地索引全部历史，并通过 MCP 和钩子把相关上下文交还给正在干活的智能体——无需 LLM，单个 Go 二进制。

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Português | Français | Deutsch | Русский | Türkçe | हिन्दी

官网与交互搜索 · 浏览器在线演示 · 中文快速开始 · 评测 · 与同类对比

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

_{macOS 与 Linux · Windows、Homebrew、npm 与插件市场 · 免安装只读检查本机已有哪些会话：npx @vshulcz/deja-vu sources · 浏览器在线演示 →}

_{每个驱动脚本、合成语料和评分规则都在本仓库里 · 正面对比，以及如何重跑你怀疑的那一行 · LongMemEval 和 LoCoMo 的运行记录}

安装

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

脚本把二进制放在 ~/.local/bin。如果这个目录还不在 PATH 里，同一个 shell 找不到第二条命令：运行脚本打印的 next: 那一行（带完整路径），或者在加上 PATH 那一行之后开一个新 shell。

连不上 raw.githubusercontent.com 时走 npm 镜像，版本是同一个：

npm i -g @vshulcz/deja-vu --registry=https://registry.npmmirror.com
deja install --auto

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

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

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

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

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

opencode plugin opencode-deja
dsh plugin --profile web add dsh-deja
magpie plugin add @vshulcz/magpie-deja
qwen extensions install https://github.com/vshulcz/deja-vu
# 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 vshulcz/deja-vu && grok plugin install deja
openclaw plugins install clawhub:@vshulcz/openclaw-deja && openclaw config set plugins.entries.deja-vu.hooks.allowConversationAccess true
pi install npm:@vshulcz/pi-deja
hermes plugins install deja-memory

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 脚本。请用 scoop install deja-vu（在 Scoop 自带的 main bucket 里）或 winget install vshulcz.deja-vu，或从 最新发布取 deja-vu_<version>_windows_amd64.zip，把 deja.exe 放进 PATH。

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

自己搜索

在终端里不带参数运行 deja，会打开一个覆盖所有智能体历史的搜索界面。最先列出的是你尚未提交的改动背后的会话， 然后是这个项目最近的会话，边输入列表边收窄。

• ↑↓ 选会话，↵ 在命中处打开，n 和 N 在命中之间跳转，esc 返回。在会话里按 / 找词，] 和 [ 在你问过的问题之间跳。
• 搜索框也认筛选词：带冒号的智能体名（codex:）、today、yesterday、week、month，以及 in:<项目>。
• r 在写下这个会话的智能体里恢复它。o 在任意其他智能体里接着做，新智能体一开始就带着这个会话问过什么、定下了什么、还有什么没解决。
• tab 在本项目、所有项目和 Deleted 之间切换；Deleted 是智能体已经删掉、deja 仍然保留的会话，R 把其中一个放回原处。
• ? 列出所有按键，其余操作在 ^k 里（复制会话 id 或项目路径、忘掉一个会话），在列表里 q 退出；esc 后退一步，搜索框为空时退出。

设置 DEJA_TUI=0 时改为打印文本摘要，也就是 deja brief 的输出。输出到管道时，它打印已经索引了什么、下一步该运行哪条命令。

能得到什么

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

还有：deja promote <id> --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 里的版本检查、指向你所配置端点的 deja embed（语义索引建好之后，每次搜索也会把查询发到那个端点），以及交互式命令每天一次查看最新发布，会用到网络。这次查看不发送任何会话数据；DEJA_OFFLINE=1 或 DEJA_NO_UPDATE_NOTICE=1 可以关掉它。

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

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

命令行

在终端里单独运行 deja 会打开搜索界面。带上查询词或下面任意一条命令时，它打印结果后退出：

$ 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

完整参考见命令文档。

MCP 工具

服务端只暴露一个工具 deja，用 mode 参数选择能力：recall、context、blame、fix、how、orient、remember、handoff。 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 · Cherry Studio · Senpi · gajae-code · Kimchi Coding · Command Code · ZCode · CodeWhale · Reasonix · Kiro · Kilo Code · CodeBuddy Code · TRAE CLI · Muse Code · Junie · JetBrains AI Assistant · Devin CLI · Windsurf / Devin Desktop · MiniMax Code · Zed。

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

自带插件包的智能体

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

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

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

在 Spec Kit 项目里，有一个扩展提供 /speckit.deja-vu.recall，在实现功能之前先搜索过去的会话：

specify extension add deja-vu --from https://github.com/vshulcz/deja-vu/releases/latest/download/deja-spec-kit.zip

可选的语义召回

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

证据

同一台机器已经做过的任务，少花 58% 的 token · LongMemEval-S（470 题清理集）上 88.9% hit@1 · LoCoMo 上 71.9% · 数 GB 历史上的查询在毫秒级
_{每组 11 次运行：53,558 token，对比未接入任何记忆时的 126,222；之后的版本上再各跑 11 次：52,815 对比 103,443 · 完成一个任务要花多少 · 两套检索评测都在本仓库里，几分钟即可在公开数据集上跑完 · 自己核对这些数字}

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

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

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

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

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

工作原理

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

常见问题

deja uninstall --all
rm -rf ~/.cache/deja ~/.local/share/deja ~/.config/deja

指南

• 快速上手与上下文： 快速开始（中文） · 编程智能体记得之前的对话吗（中文） · 为什么智能体会忘事（中文） · 上下文窗口满了（中文） · 智能体把你刚才的上下文弄丢了 · 压缩会丢掉什么
• 查找与继续工作： 接着昨天的会话做 · 找到当初解决它的那次会话 · 智能体又犯了你已经修过的错 · 换一个智能体
• 会话文件与日常维护： 磁盘上的会话文件 · 每个智能体把历史存在哪里 · 审计智能体做过什么 · 导出一次对话 · 跨机器 · 记忆要花多少 token

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

参与开发

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

许可

MIT © Vladislav Shulcz

⭐ Star deja-vu on GitHub