deja-vu

让你的编码 Agent 不再重复调试已经修复的问题。

Claude Code、Codex、Cursor 和另外 40 多种 Agent 已经会将每次会话保存到磁盘。 deja 会索引所有内容，追溯数月之久，并将重要部分交给当前正在工作的 Agent。

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

_{没人进行过搜索——Agent 自己调用了 deja。两个针对合成语料库的真实运行：没有发布任何人的历史记录。}

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

_{适用于 macOS 和 Linux；十秒安装，约十秒完成索引 · Windows、Homebrew、npm 等安装方式}

_{我维护着 deja-vu，因此所有驱动、语料库和评分规则都在此仓库中 · 正面对比，以及如何重新运行你存疑的数据行 · 所有运行结果}

文档 · 基准测试 · 对比情况 · 将其集成到你的工具中

_{觉得有用？在 GitHub 上为 deja-vu 点赞。}

在终端中不带参数运行 deja，即可搜索所有 Agent 的历史记录。它会先显示未提交更改所涉及的会话，然后显示此项目中最近的会话；随着你输入，列表会逐渐缩小。

• ↑↓ 选择会话，↵ 跳转到匹配内容处打开，n 和 N 在匹配项之间切换，esc 返回。在会话中，/ 查找词语，] 和 [ 在你提问的轮次之间跳转。
• 搜索框接受筛选条件：带冒号的 Agent（codex:）、today、yesterday、week、month 和 in:<project>。
• ^s 按日期标题列出结果，最新的排在最前；再次按下则恢复最佳匹配优先。脚本中运行 deja search --sort date 可实现相同效果。
• r 在编写该会话的 Agent 中恢复会话。o 则在任何其他 Agent 中继续会话，并提供会话中提出的问题、做出的决定和未完成的事项作为起点。
• tab 在此项目、所有项目和 Deleted 之间切换；Deleted 显示 Agent 已删除、但 deja 仍保留的会话；按 R 可恢复会话。
• D 在确认后从 Agent 和 deja 中删除会话（脚本中运行 deja delete <id>）。
• ? 列出所有按键，^k 显示其余操作（复制会话 ID 或项目路径、忘记会话），q 从列表退出；esc 返回，并在搜索框为空时退出。

设置 DEJA_TUI=0 后，会改为打印文本摘要，也就是 deja brief 的输出。通过管道运行时，它会打印已索引的内容以及下一步要运行的命令。

亮点

• 开箱即满。 安装前数月的历史记录从第一天起即可搜索：在数 GB 的数据中运行 deja "connection pool exhausted"。
• 一份记忆，适用于每个 Agent。 在 Codex 中找到的修复方案，也能在 Claude Code、Cursor 或 opencode 中找回；所有四十三种 Agent共用同一索引。
• 无需主动询问。 在会话开始时、编辑文件或运行命令之前，以及命令失败之后，都会提供相关回忆。
• 压缩后依然可用。 在 43 次实测压缩中，摘要保留了 77% 的决定和 0.2% 的命令；deja 会补回其余内容（原理）。
• 索引实际工作，而不只是对话。 每轮打开的文件、带退出状态的命令，以及编辑所替换的确切文本片段。
• 知道哪些方案奏效。 deja promote <id> --state rejected 会标记被撤销的决定，之后每次命中都会注明该方案曾尝试过，以及放弃的原因；--state accepted 可撤销该标记。
• 提醒你情况有变。 命中结果会提示 本次会话操作过的 4 个文件已有更改；无法判断时则保持安静。
• 本地运行，保护隐私。 不需要模型或服务；只有启用语义回忆时才会使用嵌入。索引构建时会清除密钥和令牌（隐私）。
• 随你迁移。 使用 deja sync ssh laptop 在设备之间同步，无需经过云端；使用 deja handoff --to codex 在另一个 Agent 中继续。
• 单个 Go 二进制文件。 支持 macOS、Linux 和 Windows，可通过 Homebrew、Scoop、winget、npm 或 go install 安装。

将自己的工作化为卡片

deja stats --card 会在终端中绘制卡片；提供文件名则会生成 SVG，可用于个人资料 README。若要发布到其他地方，可以将其转换为 PNG——该页面会在你的浏览器中完成转换。

完整的功能参考请参阅文档。

安装

在 macOS 和 Linux 上，开头的两条命令就是完整的安装步骤：

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

该脚本会将二进制文件放入 ~/.local/bin。如果该目录尚未添加到 PATH，那么在同一个 shell 中运行第二条命令时会提示找不到命令：请运行脚本打印的 next: 行（其中包含完整路径），或者添加 PATH 配置行后打开一个新的 shell。

十秒即可安装，大约十秒即可建立索引，之后就能派上用场。第二条命令会将 MCP 记忆检索接入它找到的所有 Agent，在 Agent 支持的情况下启用会话开始时的记忆检索，并建立首个索引，这样下次会话就不必再等它完成。

开启一个新的 Agent 会话，然后问它几个月前做过的事：

我们之前处理过 JWT 刷新轮换吗？查一下你的记忆

你也不必特意询问——启用自动记忆检索后，Agent 在会话开始时就已经知道你在该项目中解决过什么问题。想亲自查找的话，运行 deja。

claude plugin marketplace add vshulcz/deja-vu && claude plugin install deja-vu@deja-vu

scoop install deja-vu
winget install vshulcz.deja-vu

隐私

索引和搜索都在本地进行。网络仅用于 deja update、deja sync ssh、deja doctor 中的版本检查、针对你配置的端点运行 deja embed（以及语义侧车文件构建完成后，每次搜索都会将查询发送到该端点），还有交互式命令每天查询一次最新版本。该查询不会发送会话数据；设置 DEJA_OFFLINE=1 可将其关闭，设置任意值的 DEJA_NO_UPDATE_NOTICE 也可关闭，同时还会隐藏新版本首次运行时显示的提示。

构建索引时会剔除凭据：云服务和提供商的密钥、令牌和 JWT、PEM 区块、URL 中的密码或正文中提及的密码。每项都会替换为 [redacted:<kind>]，其周围的文本仍可搜索。源转录仍会保留这些内容（一台机器的 42 个会话中共有 84 项）：deja secrets 会列出相关会话，但不会打印任何凭据值；deja secrets --scrub 会重写可处理的凭据，并在文件旁保留原始文件。

deja forget 会删除会话，并在重建索引时继续保持删除状态。~/.config/deja/exclude 可按每行一个项目排除项目，或使用 harness:opencode 排除整个存储库。安全模型说明了数据流，以及无法通过脱敏捕获的内容。

CLI

在终端中直接运行 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

搜索你的历史记录

如果裸查询的第一个词至少有四个字符，且与某个命令名只差一个字符，deja 会将该命令名打印到 stderr，然后照常搜索。deja search <query> 会跳过建议。

MCP 工具

该服务提供一个带有 mode 的工具 deja；deja install 会将其接入。每轮一个工具定义占用 477 个令牌，而在第零天测量的七个服务中，最大者占用 8,283 个令牌。六个较旧的工具名称（recall、recall_context、blame、fix、how、remember）仍会响应。deja mcp --context-search 是一个独立服务，提供单个 context_search 工具，适用于 Qwen Code 的 External Context MCP Profile v1（Qwen 页面）。

支持的 harness

aider · Amp · Antigravity · Claude Code · Cline · Codex CLI · Copilot CLI · VS Code Copilot Chat · Cursor · DeepSeek Harness · Gemini CLI · Goose · Grok Build · Hermes · Kimi Code · omp (Oh My Pi) · OpenClaw · opencode · Continue · Crush · pi · prime-agent (PrimeIntellect) · Qwen Code · Cherry Studio · Senpi · gajae-code · Kimchi Coding · Command Code · ZCode · Kiro · Kilo Code · Roo Code · Zed · Devin CLI · CodeWhale · Junie · JetBrains AI Assistant · Windsurf / Devin Desktop · CodeBuddy Code · Reasonix · TRAE CLI · Muse Code · MiniMax Code。

TRAE IDE 已接入，但无法读取：其聊天记录存储在加密数据库中。deja install trae-ide 会添加 MCP 服务和 Skill，而 trae-ide-auto 会添加钩子；只有在“设置” > Hooks 中启用后， TRAE IDE 才会运行这些钩子。

自定义存储位置通过 DEJA_*_ROOT 变量设置，同时也会遵循各 Agent 自己的路径迁移 变量。 会话格式注册表记录了每种 Harness 经观察得到的路径、记录架构和角色映射，并通过合成测试数据确保这些说明与解析器保持一致。

拥有独立软件包的 Harness

deja install --auto 会像配置其他 Harness 一样配置这里列出的所有 Harness，这是最简便的方式。它们也在各自的生态系统中提供软件包，适合从相应生态系统安装扩展，而不是通过 CLI 安装的用户：

两种方式都可以单独使用，一起使用也不会重复做任何事：每个软件包都会读取 deja install 已写入的内容，并使用你已有的 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

同样的搜索功能也提供为技能，任何加载 SKILL.md 的 Agent 都可以使用：

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

该技能会调用上述安装步骤中的 deja 二进制文件；它本身不包含该文件。

语义回忆（可选）

通过 DEJA_EMBED_URL 将 deja embed 指向本地 Ollama、LM Studio 或兼容 OpenAI 的端点，改写后的查询也能匹配到结果。如果没有可访问的运行时，词法搜索和 MCP 回忆功能会照常运行。OpenAI Platform 可使用其标准密钥：

export OPENAI_API_KEY='sk-...'
export DEJA_EMBED_URL='https://api.openai.com/v1/embeddings'
export DEJA_EMBED_MODEL='text-embedding-3-small'
deja embed

export DEJA_EMBED_URL='https://example.com/v1/embeddings'
export DEJA_EMBED_MODEL='embedding-model'
export DEJA_EMBED_KEY='...'
deja embed

export DEJA_EMBED_MODEL='multilingual-e5-small'
export DEJA_EMBED_QUERY_PREFIX='query: '
export DEJA_EMBED_PASSAGE_PREFIX='passage: '
deja embed

毫秒级检索；在 LongMemEval-S 上，清理后的 470 个问题集 hit@1 为 88.1%，全部 500 个问题的 hit@1 为 87.4%；在 LoCoMo 检索上，hit@1 为 70.5%。对于这台机器之前已经解决过的任务，token 数减少了 58%：两种方案各运行 11 次，未接入任何内容时分别为 53,558 和 126,222；在后续版本中交替运行两种方案时，分别为 52,815 和 103,443。两个检索测试工具都包含在此仓库中，可在几分钟内使用公开数据集运行：基准测试 · 单个任务的成本。

其余数据由 deja bench 测量：

deja bench recall     # ranking floor: 100 queries, half Russian, CI fails if recall drops
deja bench context    # 30 seeded task chains plus five negative controls
deja bench block      # does the answer survive into what deja hands over
deja bench prompt     # what the per-prompt hook fires on, and what it fires on wrongly
deja bench ingest     # what an update costs: unchanged, a turn, a new transcript, a rename, a rewrite
deja bench read       # what it costs to read a database-backed store, and what one long value does to it

工作原理

在 ~/.cache/deja 中创建本地倒排索引：解析 JSONL 和 SQLite 存储，编辑凭据，写入仅追加的 records.bin 和 token 桶，并在 manifest.gob 中跟踪每个文件的状态，使后续运行只导入发生变化的内容。MCP 服务、统计、分享和同步功能都读取同一个索引。详见docs/ARCHITECTURE.md。

常见问题

~/work/monorepo = work
~/work/worktrees = work

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

指南

围绕具体场景编写，而非围绕功能编写：

• 你的 Agent 会记得之前的对话吗？ — 各个 Agent 会在会话之间保留什么，又会丢弃什么
• 磁盘上的会话文件 — ~/.claude/projects 会变得多大，以及删除它会有什么代价
• Agent 丢失了你之前的上下文 — 崩溃、清除上下文，或会话恢复后内容为空时该怎么办
• 上下文窗口已满 — 压缩会保留什么、如何衡量，以及还有什么替代做法
• 恢复昨天的会话 — 在所有 Agent 中找到该会话，并在所属 Agent 中重新打开
• Agent 重复犯你已经修正过的错误
• 找到你解决过问题的会话
• 为什么 Agent 会在会话之间遗忘 · 各个 Agent 将历史记录保存在何处
• 恢复已删除的 Claude Code 会话 · Claude Code：找不到具有该会话 ID 的对话 · Codex 恢复会话 · 删除旧的 Claude Code 会话
• 安装当天，各种记忆工具分别了解什么 · 记忆插件对比
• 压缩会丢弃什么 · 切换 Agent · 审计 Agent · 导出对话 · 跨设备同步 · 记忆的成本 按运行环境：Claude Code · Codex · Cursor · Windsurf · opencode · DeepSeek Harness · Kimi Code · Zed · Grok Build · Gemini CLI · Qwen Code · OpenClaw · Goose · Cline · pi · Hermes · Copilot CLI · Copilot Chat · aider · Amp · Antigravity · Continue · Crush · Roo Code · Kilo Code · Kiro · Cherry Studio · Oh My Pi · prime-agent · Senpi · Kimchi · Command Code · ZCode · gjc · CodeWhale · Reasonix

在自己的历史记录上试用

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

安装只需 10 秒左右，索引也大约需要 10 秒。你的 Agent 下次开启会话时，就已经知道你在该项目中解决过的问题——包括安装之前的所有内容。

贡献

运行 make build test lint，然后参阅 CONTRIBUTING.md。添加运行环境请从解析器注册表开始。优先事项和非目标列于 ROADMAP.md。适合新手的议题已添加标签。

支持

请通过 issues 提交错误和问题。 如果你认为某项内容可能被利用，请改用 SECURITY.md 中的私密安全公告链接。关于 deja 会读取什么、绝不会发送什么，以及如何排除项目或忘记会话，请参阅隐私。

许可证

MIT © Vladislav Shulcz