资讯动态

如何让你的AI Agent自己想起历史?deja-vu MCP服务器与Hooks自动召回配置教程

发布时间:2026/10/14 17:43:57 来源:尧图企业网站定制
【免费下载链接】deja-vuMemory for Claude Code, Codex, Cursor and 38 more coding agents, built from the session history already on your disk. Local search, MCP and hooks, no LLM, one Go binary.项目地址https://gitcode.com/gh_mirrors/dej/deja-vu点击查看免费下载deja-vu 是一款本地运行的 AI Agent 记忆层它把 Claude Code、Codex、Cursor 等 41 款编程智能体已经写在磁盘上的会话历史建成索引再通过 MCP 服务器和 Hooks 把记忆自动召回给正在干活的 Agent——不需要 LLM、不需要向量库只装一个 Go 二进制。下面是完整的配置教程。为什么 Agent 每次都失忆用过 Claude Code 或 Codex 的同学大概都有这个体验上个月修好的connection pool exhausted这次又从头调试一遍上次定下的架构决策换个 Agent 接手就全盘重议会话被压缩compaction后任务目标、失败的命令全丢了。好消息是这些历史并没有丢。每个 Agent 都会把每次会话写到本地文件如~/.claude/projects、~/.codex/sessions只是没人把它们变成可检索的记忆。如上图所示没有人手动搜索——是 Agent 自己调用了 deja-vu 的 MCP 工具完成召回。三步装出记忆deja-vu 一键安装步骤deja-vu 的核心设计是安装即满血装完当天几个月前的历史就已全部可搜索官方实测 17.6 秒索引 19,195 个会话。macOS / Linux 上只需两条命令curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh deja install --auto第二条deja install --auto是关键它一次完成三件事把 MCP 召回接进它找到的每一个 Agent写入各 Agent 的 MCP 配置在支持的地方打开会话启动召回即 Hooks 自动召回建好第一份索引让下一次会话不必等待。其他安装方式brew install deja-vu、npm i -g vshulcz/deja-vu、go install .../cmd/dejalatestWindows 用scoop install deja-vu或winget install vshulcz.deja-vu。仓库入口 install.sh中文安装说明见 README.zh.md。装完后打开一个新会话问一句几个月前做过的事比如我们以前处理过 jwt refresh rotation 吗——开启自动召回后Agent 打开会话就已经知道答案你甚至不用特意去问。MCP 服务器配置一个工具八种模式deja-vu 的 MCP 服务器只暴露一个工具deja通过deja mcp以 stdio 方式启动用mode参数区分用途。官方配置文件 mcp.json 长这样{ mcpServers: { deja: { type: stdio, command: deja, args: [mcp] } } }少而精的设计带来了实打实的 token 收益一个工具每轮只占 477 token 的定义开销而同类服务器最大的是它的 17 倍。各mode的作用模式Agent 问什么返回什么recall问题、报错原文高相关历史片段≤4KBcontext同 recall最佳匹配会话的 Markdown 摘要含改过的代码blame文件路径哪些会话讨论过这个文件、定了什么结论fix失败的输出这台机器上次遇到同样报错后做了什么how工具名如go test本机真实跑通过的调用方式含完整参数orient无需参数本项目历史上跑过的命令和文件帮新会话定向remember一条持久决策存下来供以后召回handoff会话 id目标、结论、进度交接方便换 Agent 继续想不装 MCP 也能用deja warmup会写一个技能文件到~/.agents/skills/deja-search/SKILL.md教会 Agent 直接走 CLIdeja search --json等仓库副本见 skills/deja-search/SKILL.md。Hooks 自动召回记忆在五个时刻自己出现这是 deja-vu 最出彩的部分。deja install --auto会在 Agent 支持的地方挂上 hooks让记忆在五个时刻自动送达——Agent 不需要想起来问触发时刻Hook作用① 会话启动hook-context送达本项目相关的历史决策、未关闭的待办② 每次提问hook-prompt若这个问题已解决过直接提示deja-vu: you have been here③ 编辑/执行前hook-tool(PreToolUse)给出该文件/命令此前的结论和有效的调用方式④ 命令失败时hook-tool-after(PostToolUse)报出本机上次从同样报错中恢复的修复手段⑤ 上下文压缩前hook-precompact保住任务目标、结论、命令成败压缩后原样交还以 Claude Code 插件为例失败回调的声明在 claude-plugin/hooks/hooks.json 里一目了然{ hooks: { PostToolUseFailure: [{ matcher: Bash|PowerShell, hooks: [{ type: command, command: \${CLAUDE_PLUGIN_ROOT}/hooks/deja.sh\ hook-tool-after }] }] } }各 Agent 的挂载脚本统一是deja.sh分发到上述子命令源码入口 cmd/deja/main.goClaude Code 钩子脚本见 claude-plugin/hooks/deja.sh。每个 hook 都是本地词法检索端到端约 0.2 秒不会拖慢 Agent更不等待任何模型。终端里直接敲deja无参数就打开图中的搜索界面↑↓选会话、↵打开、r恢复、o换 Agent 继续支持codex:、today、in:项目等筛选。常用命令速查与自检装完怎么验证装完建议跑一遍deja doctor——它会逐项报告 MCP 是否接好、hook 是否生效、索引是否健康。平时最常用的几个命令deja jwt refresh token—— 全量历史搜索多词为 AND支持模糊词形deja brief—— 今日会话 deja 已送达过什么 最近工作概览deja wip—— 当前目录上一个会话在干什么、卡在哪条命令deja fix 报错—— 本机历史上从同样报错中恢复的修复deja friction—— 在 3 个以上会话里反复出现的错误附 Agent 名deja log --last—— 回放 Agent 上一次实际收到的召回内容排查它看到了什么。隐私方面可以放心索引、搜索全部本地~/.cache/deja建索引时密钥、token、PEM 等会自动替换为[redacted:kind]不想索引的项目逐行写进~/.config/deja/exclude即可。完整数据流见 docs/SECURITY-MODEL.md。总结十分钟给 41 个 Agent 装上共享记忆回到本文开头的场景接好 MCP Hooks 之后你在 Codex 里修好的坑Claude Code 接手时自动记得会话被压缩后任务和命令的成败记录原样交还新会话一打开项目过去的决策就已经在上下文里。这就是 deja-vu 的完整价值闭环install.shdeja install --auto两条命令完成全部接线MCP 单工具deja覆盖 recall / context / fix / how 等 8 种查询模式Hooks 在会话启动、每次提问、编辑前、命令失败、压缩前五个时刻自动召回全程本地、毫秒级。相关文档ARCHITECTURE.md索引与数据流、compaction.md压缩时保住了什么、docs/readme/README.zh.md完整中文说明。赞分享【免费下载链接】deja-vuMemory for Claude Code, Codex, Cursor and 38 more coding agents, built from the session history already on your disk. Local search, MCP and hooks, no LLM, one Go binary.项目地址https://gitcode.com/gh_mirrors/dej/deja-vu点击查看免费下载相关推荐让Agent自主搜索历史ctx的MCP服务器与Skill安装实践指南让Agent自主搜索历史ctx的MCP服务器与Skill安装实践指南 ctx 是运行在本地的编程 Agent 历史搜索引擎它把 Claude Code、Co如何通过MCP让AI Agent检索agent-beacon历史记忆serve与connect双模式配置指南如何通过MCP让AI Agent检索agent beacon历史记忆serve与connect双模式配置指南 agent beaconBeacon 是一款创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑