十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Cursor 记忆召回规则接入指南:用 MemPalace Cursor Rules 让 Agent 先查记忆库再作答

Cursor 记忆召回规则接入指南:用 MemPalace Cursor Rules 让 Agent 先查记忆库再作答 Cursor 记忆召回规则接入指南用 MemPalace Cursor Rules 让 Agent 先查记忆库再作答【免费下载链接】mempalaceThe best-benchmarked open-source AI memory system. And its free.项目地址: https://gitcode.com/GitHub_Trending/me/mempalaceMemPalace 提供一组可选的 Cursor Rules它们的作用是在 Agent 回答过去做过什么、做过什么决定、某个人的信息、某个项目的来龙去脉等可能已存入记忆宫殿的问题前先触发一次mempalace_search/mempalace_kg_query检索而不是凭模型记忆直接作答。本文以 examples/cursor/rules/README.md 为主体结合规则源文件、共享召回协议与 Cursor hooks 实现完整讲解两种规则变体的差异、安装步骤、底层协议与排障路径帮你把 MemPalace 的100% 召回、逐字引用、绝不猜测落地到 Cursor 工作流中。这套规则解决什么问题MemPalace 的核心承诺是100% recall, verbatim, never guess完全召回、逐字引用、绝不猜测——当记忆宫殿里可能存有答案时Agent 必须先读宫殿、再用模型记忆回答。而默认情况下Cursor 中的 Agent 只会基于当前会话上下文与自身参数化记忆作答不会主动去翻~/.mempalace/palace里的历史抽屉drawer。本目录下的两个.mdc规则文件就是用来纠正这一行为的最小开关它们通过 Cursor 的 rules 机制在可能命中记忆的对话轮次里把一条search-before-answer指令注入到系统上下文提示 Agent 调用 MCP 工具检索记忆库。适用对象非常明确来自 README未安装 Cursor 插件的用户想获得召回行为但走的是手动/最小化接入路径只想在某个特定项目内启用召回的用户rules 可以做成 project scope只在指定仓库生效如果你已安装 Cursor 插件插件根目录自带alwaysApply: false的同一份规则则不需要重复复制本目录内容二选一即可。选哪个文件matched 召回 vs 全量召回规则目录下有两个候选文件且只能二选一不要同时安装两个文件alwaysApply触发时机适用场景mempalace-recall.mdcfalse由 Cursor 的 matcher 依据规则description判断该轮对话与召回相关时才触发推荐。既能在相关问题上召回又不必为无关工作支付常驻上下文成本mempalace-recall-always.mdctrue作用域内每一段对话、每一轮都生效你希望召回被强制注入每轮上下文并接受相应成本两者的差异本质是 Cursor rules 的alwaysApply语义alwaysApply: falsematched 变体规则不常驻。Cursor 会读取文件 YAML frontmatter 里的description字段做相关度匹配只有当用户提问涉及过去工作、历史决定、人物、项目等召回相关主题时才把该规则纳入上下文。仓库根目录 rules/mempalace-recall.mdc 也保留了一份与推荐变体逐字相同的副本。alwaysApply: truealways-on 变体规则每轮都加载。规则正文自己也明确指出Even with this rule always loaded, only actually call the tools when the question touches memory——规则常驻不等于每轮都要搜实际调用工具仍然要按问题是否触碰记忆来决定。README 对该选择给了明确提醒always-on 变体更重它会在每一轮对话中占据上下文空间并让 Agent 更倾向于调用mempalace_search从而带来额外的 MCP 延迟与 MemPalace 的memory should feel instant记忆应当即刻可得预算相悖。因此默认应优先使用alwaysApply: false的变体除非你确实希望召回被强制带入每段对话。规则文件里到底写了什么两个.mdc文件都采用 Cursor rules 的格式YAML frontmatterdescriptionalwaysApply Markdown 指令正文。以推荐变体 mempalace-recall.mdc 为例frontmatter 中的description完整定义了 matcher 的判定依据同时也是决定该不该触发的语义来源When the user asks about past work, prior decisions, people, projects, or events that may be filed in MemPalace, callmempalace_search(ormempalace_kg_queryfor relational or time-bound facts) before answering from model memory. Return stored content verbatim; never guess when the palace might know.正文指令是一条精炼的三步协议先搜后答以一段简短的关键词查询调用mempalace_search对关系型或带时间约束的事实改用mempalace_kg_query逐字引用引用抽屉返回的原文verbatim绝不转述summarize或改写paraphrase已存储内容空结果也要明说结果为空就直接说明不要凭空编造答案MCP 服务不可用时把错误暴露出来不要回退到猜测。最后一条关键约束是召回是问题驱动的不是条件反射——纯绿地工作greenfield如重命名变量、修拼写不需要召回。这一约束在 always-on 变体里同样存在避免全量规则演变成每轮无脑搜索。安装User scope 与 Project scopeUser scope对所有工作区生效把推荐变体复制到~/.cursor/rules/mkdir -p ~/.cursor/rules cp examples/cursor/rules/mempalace-recall.mdc ~/.cursor/rules/Project scope仅当前仓库生效复制到项目内的.cursor/rules/mkdir -p .cursor/rules cp examples/cursor/rules/mempalace-recall.mdc .cursor/rules/启用强制变体 / 重载需要更激进的 always-on 行为时改复制mempalace-recall-always.mdc同样只复制两者之一。随后重载 CursorCmd-Shift-P→Developer: Reload Window。仓库内规则的配套示例MCP 接入与 hooks 接线位于 examples/cursor/README.md其中包含完整的 hooks.jsonsessionStartstoppreCompact三钩子与最小化变体 hooks.minimal.json可作为你接线 recall 全链路时的对照参考。记忆召回的三层正交架构要真正理解 rules 在整体中的位置需要把 recall 能力拆成三层——README 明确指出这三层彼此正交、可任意组合安装层作用所在位置sessionStarthook每次新建会话时注入一次wing 作用域的召回上下文hooks/cursor/mempalace-recallskill完整的 search-before-answer 协议可由模型调用或手动挂载skills/mempalace-recall/SKILL.mdRecall rule本目录文件在召回相关的对话轮次提示 search-before-answer本目录或插件根目录的rules/三层共同引用同一份规范协议integrations/shared/recall-protocol.md。该文件被定义为single source of truth唯一事实来源并明确要求各 skill 与 rule链接到它而不是复述协议以避免规则与 skill 之间的内容漂移。三层各有分工、不重复叠加hook 负责每段对话启动时把 wing 作用域注入skill 负责模型主动可调用的完整协议含工具选择表与异常路径rule 负责对召回相关问题的轻量提醒。若已通过插件安装同名alwaysApply: false规则则不要重复复制本目录文件。底层协议何时搜、怎么搜、用哪个工具integrations/shared/recall-protocol.md 是全部 Cursor / Antigravity / Claude Code / Codex / OpenClaw 集成共享的规范。其要点可作为使用规则时的操作指南何时触发召回——在回答以下问题之前搜索宫殿过去的工作、此前的决定我们上次做了什么 / 定了什么 / 试过什么某个人、项目或实体who is …、what is …更早会话里发生过的事remember when …、last time …、the thing we discussed可能随时间变化的偏好、事实或关系。若问题是纯绿地工作、与记忆无关则不搜索——recall 是问题驱动、非反射式的。协议六步skill 与 rule 同源若 sessionStart hook 注入了additional_context先遵循其 wing 作用域再继续回答人物/项目/历史事件/既往决定前先调mempalace_search关系型或时间型事实调mempalace_kg_query对不确定的事实明说let me check the palace再去查询——答错比答慢更糟逐字返回引用抽屉原文绝不转述/压缩——这正是整套系统的意义所在实质性会话结束后用mempalace_diary_write记录连续性若后台 hook 已做则不要重复建档事实发生变化时按时间语义选择操作单值替换用mempalace_kg_supersede无替代地结束用mempalace_kg_invalidate独立/并存事实用mempalace_kg_add。工具选择表协议与 skill 均收录你需要工具按语义找任意记忆mempalace_search从这里开始实体的关系型 / 时间型事实mempalace_kg_query替换单值事实mempalace_kg_supersede实体的时间线故事mempalace_kg_timeline近期会话连续性mempalace_diary_read作用域未知时确认有哪些 wing / roommempalace_list_wings、mempalace_list_rooms记录当前会话mempalace_diary_write其中mempalace_search接收短的自然语言query关键词或问题不是系统提示词、也不是整段粘贴的对话可附带wing/room过滤与limit默认 5。这些工具名并非杜撰——从实现侧可以确认mempalace/mcp_server.py 中注册了mempalace_search语义搜索可选 wing/room/source_file 过滤mempalace_kg_query亦在同一文件的工具清单中见 mempalace/mcp_server.py服务内部还会把回答人物/项目/历史事件前必须先查mempalace_kg_query或mempalace_search、绝不猜测作为内置指令注入见 mempalace/mcp_server.py与 rules 的行为方向完全一致。异常路径与索引损坏恢复规则与协议都强调当宫殿答不上来时行为边界必须清晰否则召回就退化成幻觉。空结果直接说明宫殿里没有相关内容不要编造答案填坑可建议扩大搜索去掉 wing 过滤或把新信息建档。MCP 不可用 / 工具报错把错误如实暴露提示用户用mempalace status检查服务或重跑安装不要静默回退到模型记忆猜测。索引损坏 / compactor 报错若服务返回涉及 HNSW segment writer、ChromaDB compaction 失败或写入后卡在 Not connected说明磁盘上的向量索引已与chroma.sqlite3失步但 SQLite 中的抽屉行仍然完好。此时应从 SQLite重建索引而不是重新 mining。协议给出的 CLI 步骤为先停掉 MCP 服务可选备份 palace 目录再执行mempalace repair --mode from-sqlite --archive-existing --yes mempalace repair-status # divergence 应显示为 0然后重启 MCP 服务。协议特别注明不要为恢复而从源文件 re-mine——那会丢失经 MCP 服务新增的抽屉与日记条目它们没有对应源文件。过期或冲突事实优先采信知识图谱的时间有效答案并按单值替换 / 结束 / 并存分别使用mempalace_kg_supersede/mempalace_kg_invalidate/mempalace_kg_add。反模式规则落地后的红线协议与 skill 列出的反模式值得在团队内形成共识当宫殿可能知道时仅凭模型记忆回答过去工作 / 人物 / 决定——应先搜索转述或概括存储内容而非逐字引用每轮都反射式搜索包括与记忆无关的纯绿地编码任务把整段对话或系统提示词塞进query参数——查询要保持短小、关键词驱动。与 hooks、skill 的搭配建议Rules 只解决了答之前先搜这一件事不会替你保存会话。推荐的最小完整闭环是用 hooks/cursor/install.sh 或 examples/cursor/hooks.json 接好stop每MEMPAL_SAVE_INTERVAL默认 15 次 stop 触发一次保存提示与sessionStart注入 wing 作用域召回上下文钩子保证记忆持续写入安装本目录推荐的alwaysApply: false规则保证 Agent 在相关问题上先查后答让 Agent 在复杂召回场景下可挂载 skills/mempalace-recall/SKILL.md 获取完整工具选择与异常处理指南。更完整的 Cursor 端到端接入含 hooks 的 stdin/stdout schema 与调试日志~/.mempalace/hook_state/cursor_hook.log见 hooks/cursor/README.md 与其 STDIN_SHAPE.md渲染版文档位于 website/guide/cursor-hooks.md。需要理解召回与共享大脑协作的分工边界recall 回答问句、logstream 传递任务时可参阅 integrations/shared/coordination-protocol.md。【免费下载链接】mempalaceThe best-benchmarked open-source AI memory system. And its free.项目地址: https://gitcode.com/GitHub_Trending/me/mempalace创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表