Skip to main content
Nowledge MemNowledge Mem
连接

让 Cursor 接着上次的工作继续

把 Cursor 接入 Nowledge Mem,在新会话里找回保存过的项目背景。先安装本地插件,再验证启动上下文和记忆搜索。

给你的智能体

把这行交给你的智能体。它应该先使用统一安装指南;这一页保留为行为说明和排障参考:

读取 https://mem.nowledge.co/SKILL.md,按其中说明为 Cursor 安装或更新 Nowledge Mem。用 nmem status 和 Context Bundle 或 Working Memory 检查验证结果,并总结你改了什么。

今天最稳的路径:本地插件安装

现在最可靠的路径是把插件放到 ~/.cursor/plugins/local/nowledge-mem-cursor。即使 Marketplace 还没通过,这条路也可以直接给用户使用。

Marketplace 以后再说

如果将来 Nowledge Mem 出现在你的 Cursor Marketplace 账号里,你再切过去即可。下面这条本地安装路径才是现在面向用户的真实可用路径。

对用户来说,最重要的好处很直接:装一次,开一个新的智能体会话,规则、技能、启动钩子和 MCP 连线就一起到位了。

开始之前

  • Nowledge Mem 已在本地运行(安装指南),或你已经有可访问的远程 Mem 服务
  • 已安装 Cursor IDE
  • 推荐:如果你希望在会话开始时自动带上 Working Memory,并在需要时创建可恢复交接摘要,请让 nmem 出现在 PATH 中

如果 Nowledge Mem 已经在同一台机器上的桌面应用中运行,最省事的方式仍然是 设置 → 偏好设置 → 开发者工具 → 安装 CLI。这样 Cursor 就可以在会话开始时加载 Context Bundle 或 Working Memory,也能在需要时通过终端工具调用 nmem。

如果你要导入真实的 Cursor Agent 历史会话,Mem 会读取 Cursor 本地 ~/.cursor/projects 里的 Agent transcript。桌面端在同一台机器上可以自动同步;如果你想手动补导历史,先预览:

nmem t sync --from cursor --all-projects

确认列表没问题后再导入:

nmem t sync --from cursor --all-projects --apply

只导入某一个项目时,也可以直接指定它的 transcript 目录:

nmem t sync --from cursor --session-dir ~/.cursor/projects/Users-me-project/agent-transcripts --apply

一分钟安装

克隆或进入插件仓库

git clone https://github.com/nowledge-co/community.git
cd community

复制到 Cursor 的本地插件目录

mkdir -p ~/.cursor/plugins/local
rm -rf ~/.cursor/plugins/local/nowledge-mem-cursor
cp -R nowledge-mem-cursor-plugin ~/.cursor/plugins/local/nowledge-mem-cursor

如果你为了本地迭代想试软链接,也可以:

ln -s "$(pwd)/nowledge-mem-cursor-plugin" ~/.cursor/plugins/local/nowledge-mem-cursor

但 Cursor 团队已经确认,本地插件的软链接解析现在实际还不稳定,所以面向用户时应优先用复制方案。

重新加载 Cursor

重启 Cursor,或运行 Developer: Reload Window。

如果 Cursor 里看到的还是 Claude Code 风格文案或旧的插件 id,先把旧的导入版 nowledge-mem 包从 Cursor 里移除。这个包会提供用于启动上下文的 sessionStart hook,以及用于自动捕获会话的 stop hook,另外还包含 Nowledge Mem skills。本地包专门使用 nowledge-mem-cursor 这个插件 id,就是为了避开这个导入包的命名冲突。

开启新的智能体会话

打开一个新的智能体会话。

对于同机默认配置,插件内置的这些内容就是预期的零配置路径:

  • 插件清单
  • 常驻规则
  • 技能
  • 启动钩子
  • 本地 mcp.json

如果已经安装了 nmem,这个启动钩子会在新会话开始时把 Context Bundle 先带进上下文;旧版 CLI 会自动回退到 Working Memory。

仅在远程 Mem 时配置 MCP

只有在你使用远程 Mem 时,才打开 Settings(Cmd/Ctrl+Shift+J)-> Features -> Model Context Protocol,然后更新 nowledge-mem 服务器的 URL 与 headers。

如果你还希望 sessionStart 启动钩子和 save-handoff 技能也连接到远程 Mem,就需要把当前机器上的 nmem 客户端也指向同一个远程服务:

nmem config client set url https://your-server
nmem config client set api-key your-key

这里有两个独立通道:

  • Cursor 的 MCP 设置负责插件里的记忆工具
  • nmem config client ... 负责这台机器上终端侧的启动简报和交接摘要能力

更新

如果你走的是本地插件目录:

  • 推荐复制方式:用新的 nowledge-mem-cursor-plugin 覆盖 ~/.cursor/plugins/local/nowledge-mem-cursor,然后重新加载 Cursor
  • 可选软链接方式:更新 community 仓库后重新加载 Cursor;如果 Cursor 又不识别插件,就切回复制方式

如果以后 Marketplace 可用了,再从本地版本切过去即可。

安全地自定义

想调整行为时,优先使用 Cursor 自己的规则文件:

  • .cursor/rules/*.mdc
  • .cursorrules

Nowledge Mem 插件自带的规则应继续作为默认值保留,不要直接去改 ~/.cursor/plugins/... 里的已安装插件文件。完整对照表见 安全地自定义连接行为。

第一次成功应该看到什么

当下面几件事成立时,就说明插件已经接通了:

  • 你已经把插件放进 ~/.cursor/plugins/local/nowledge-mem-cursor
  • 你重新打开了一个新的 Cursor 智能体会话
  • 如果装了 nmem,一开始就能看到 Working Memory 已经进了上下文
  • 同机默认配置下,不需要手改 MCP 就能工作
  • 远程模式下,只要改好 nowledge-mem MCP 服务器地址,就能恢复同样的行为
  • Cursor 里不再出现旧的 Claude 风格包界面,比如 save-thread、beforeSubmitPrompt 或 stop

你会得到什么

  • 打包好的 .cursor-plugin/plugin.json
  • 用于启动时加载 Context Bundle 或 Working Memory 的 hooks/hooks.json
  • 用于本地 Nowledge Mem MCP 连接的 mcp.json
  • 一条常驻规则,用来约束工作记忆简报、路由式检索、提炼与交接摘要语义
  • 四个技能:read-working-memory、search-memory、distill-memory 与 save-handoff
  • 通过桌面端自动同步或 nmem t sync --from cursor 导入真实 Cursor Agent transcript

新用户真正关心的事

对第一次安装的用户,真正要记住的就这么几条:

  • 本地 Mem:装好插件后直接开新会话
  • 远程 Mem:装好插件后,把 nowledge-mem MCP 服务器改到远程地址;如果还想保留启动简报和交接摘要,再把 nmem 也指向同一个远程服务
  • 想把体验拉满:保留 nmem CLI,让 Cursor 能在新会话开始时先带上 Context Bundle 或 Working Memory,也能在需要时生成交接摘要

重要约束

这个包提供 save-thread 作为显式兜底,也提供用于生成简洁可恢复摘要的 save-handoff。

当 Cursor 提供 transcript 路径时,stop hook 会自动捕获当前 Cursor Agent 会话。历史会话或遗漏的会话仍可使用 Mem 桌面端或 nmem t sync --from cursor 导入;两条路径都会读取本地 agent-transcripts JSONL 文件,并把新增消息去重追加到 Mem 线程里。

包结构

这个包已经按 Cursor 插件格式组织好:

.cursor-plugin/plugin.json
rules/nowledge-mem.mdc
skills/*/SKILL.md
hooks/hooks.json
hooks/session-start.mjs
mcp.json

Cursor 的本地插件目录要求 .cursor-plugin/plugin.json 位于插件根目录。这个包已经满足这个约定,所以前面的本地安装流程就是现在可以直接给用户使用的正式路径。

以后如果上架 Marketplace

如果未来 Cursor Marketplace 接受了这个插件,再安装 Marketplace 版本即可。上架前,优先使用本地插件目录。

相关内容

On this page