MemPalace Cursor IDE Hooks配置指南会话召回与压缩前快照实战【免费下载链接】mempalaceThe best-benchmarked open-source AI memory system. And its free.项目地址: https://gitcode.com/GitHub_Trending/me/mempalaceMemPalace 是一款本地优先的开源 AI 记忆系统而它的 Cursor IDE Hooks 能让 AI 编程助手在 Cursor 中自动记住每次会话——新对话开始时自动会话召回sessionStart 唤醒上下文即将被压缩前自动压缩前快照preCompact 存档每 15 轮自动保存一次记忆。本文带你从零完成 Cursor Hooks 配置全程只需 5 分钟且零额外 LLM Token 开销。为什么需要 Cursor Hooks日常用 Cursor 写代码时你是否遇到过这些糟心事️ 换了个新会话AI 就失忆了完全不记得上次讨论的方案 长对话触发上下文压缩关键细节被摘要吞掉再也找不回来 同一个 bug 的上下文每次都要重新给 AI 讲一遍MemPalace 的解法是把对话**逐字verbatim**存进本地记忆宫殿再用语义检索在需要时精准召回。三个钩子分别在三个关键时刻出手钩子触发时机作用Wake Hook唤醒sessionStart新会话打开时注入按项目wing限定的召回指令AI 先查记忆再回答Save Hook保存stop每轮 AI 回复结束后每 15 轮默认提醒 AI 把关键内容归档进记忆宫殿PreCompact Hook快照preCompact上下文压缩前一刻同步挖掘对话记录并留下待保存标记确保压缩前内容已入库存档三个钩子的完整行为说明见 hooks/cursor/README.md官方图文教程见 website/guide/cursor-hooks.md。一键安装3 步配好 Cursor Hooks最快的路径是仓库自带的安装脚本 hooks/cursor/install.sh。它会把三个钩子脚本复制到~/.mempalace/hooks/cursor/并把配置合并进你现有的hooks.json不会覆盖无关钩子重复执行也安全幂等。第 1 步先预览不落盘--dry-run只打印将要写入的 JSONgit clone https://gitcode.com/GitHub_Trending/me/mempalace cd mempalace hooks/cursor/install.sh --scope user --dry-run第 2 步正式安装到用户级对所有 Cursor 工作区生效写入~/.cursor/hooks.jsonhooks/cursor/install.sh --scope user第 3 步只给某个项目装用项目级作用域写入repo/.cursor/hooks.jsonhooks/cursor/install.sh --scope project --target /path/to/your/repo 安装器还支持--variant minimal只装stop保存钩子和--uninstall干净卸载 MemPalace 条目。MemPalace 不会在pip install时偷偷改动你的编辑器配置——配置编辑器是神圣的事必须显式同意。手动配置 hooks.json最小与完整两套方案如果想手动控制只需编辑~/.cursor/hooks.json用户级或repo/.cursor/hooks.json项目级。最小配置只接stop保存钩子{ version: 1, hooks: { stop: [ { command: /绝对路径/hooks/cursor/mempal_save_hook_cursor.sh, loop_limit: 1 } ] } }完整三钩子配置推荐参考 examples/cursor/hooks.json在此基础上增加sessionStart指向 mempal_wake_hook_cursor.sh和preCompact指向 mempal_precompact_hook_cursor.sh两个条目即可。三个要点路径必须写绝对路径——示例文件里的$HOME占位符 Cursor 不会自动展开loop_limit: 1是保险丝防止保存提醒 → AI 回复 → 再次触发的死循环保存文件后 Cursor 会自动热加载hooks.json若钩子仍未触发重启 Cursor 并在 Settings → Hooks 面板检查会话召回实战新对话自动想起过去Wake Hook 是 Cursor 独有能力的核心。当你打开一个新会话sessionStart事件触发钩子读取workspace_roots[0]以工作区目录名推断 wing如~/projects/myapp→myapp返回additional_context告诉 AI回答前先按 wingmyapp 范围检索记忆宫殿AI 在第一个相关问题上就会调用mempalace_search召回历史决策、方案与结论多项目用户因此零配置获得按项目隔离的记忆空间。如果你希望 AI 在问过去的事时更主动地先搜记忆还可以叠加一份召回规则 examples/cursor/rules/mempalace-recall.mdc复制到~/.cursor/rules/即可它与钩子互补钩子保证每次新会话自动召回一次规则保证按需追问时先查后答、逐字引用、绝不瞎猜。压缩前快照实战preCompact 如何守住最后防线Cursor 的preCompact事件是只读观察型——文档明确它无法阻塞压缩。MemPalace 的应对策略很巧妙⚡同步抢跑压缩一旦发生就不可逆所以钩子在返回前同步执行mempalace mine把逐字对话含 Shell 结果、搜索发现、构建报错先挖进索引。即使超大对话导致挖掘超时被杀也没关系——mine是增量追加式的下次会干净续跑埋点待办同时落下一个.pending标记下一轮stop事件会强制触发一次保存提醒让 AI 用 LLM 视角再补写结构化记忆drawer 日记本地挖掘 AI 归档双层捕获确保压缩前的关键内容既有原文备份又有提炼摘要。关键环境变量配置清单所有开关都是环境变量按需微调即可默认值对绝大多数人够用变量默认值用途MEMPAL_SAVE_INTERVAL15每隔多少轮stop触发一次保存提醒调小更勤快调大更少打扰MEMPAL_CURSOR_SILENT未设置设为1关闭聊天窗口的保存提醒后台挖掘照常。Cursor 默认开启提醒——因为 Cursor 对话格式尚无官方解析器这条提醒是当前最可靠的逐字捕获通道MEMPAL_DIR未设置额外指定一个项目目录每次保存时一并挖掘对话记录始终会挖此选项纯增量MEMPAL_PYTHON自动探测macOS 从图形界面启动 Cursor 导致 PATH 缺 python3 时手动指定解释器路径MEMPAL_STATE_DIR~/.mempalace/hook_state计数器、待保存标记与日志的存放目录MEMPAL_DISABLE_HOOK未设置设为1即紧急开关三个钩子全部静默退出排查钩子未生效看这一份日志一切钩子行为都会追加到~/.mempalace/hook_state/cursor_hook.log格式为 ISO 8601 时间戳 事件 会话 ID[2026-05-27T02:16:01Z] [eventsessionStart] [convabc123] workspace~/proj wingproj [2026-05-27T02:42:09Z] [eventstop] [convabc123] counter 14 - 15 (interval15) [2026-05-27T02:42:09Z] [eventstop] [convabc123] TRIGGERING SAVE at counter15如果某次钩子解析不到输入比如 Cursor 升级改了 schema原始输入会被截断保存到同目录的cursor_last_input.log方便对照 hooks/cursor/STDIN_SHAPE.md 排查。常见坑位新钩子要开新对话hooks.json热加载后已存在的会话需重开才生效路径是绝对路径$HOME不会展开脚本可执行权限手动安装时记得chmod x三个钩子脚本成本与收益总结整套 Cursor Hooks 是纯本地 bash 脚本零额外 LLM Token、零 API 调用followup_message只是一条普通用户轮次不产生额外模型调用所有记忆数据留在你自己机器上。配好之后你会发现——新会话开场 AI 已经知道你上次为什么选了方案 B压缩后的长对话细节也随时能被语义检索找回。这就是 MemPalace 在 Cursor 里的完整形态会话召回让它记得压缩前快照让它不丢自动保存让它持续积累。【免费下载链接】mempalaceThe best-benchmarked open-source AI memory system. And its free.项目地址: https://gitcode.com/GitHub_Trending/me/mempalace创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
