Cursor
现在就可以通过 Cursor 本地插件目录安装 Nowledge Mem,以后如果 Marketplace 可见,再切换过去。
今天最稳的路径:本地插件安装
现在最可靠的路径是把插件放到 ~/.cursor/plugins/local/nowledge-mem-cursor。即使 Marketplace 还没通过,这条路也可以直接给用户使用。
Marketplace 以后再说
如果将来 Nowledge Mem 出现在你的 Cursor Marketplace 账号里,你再切过去即可。下面这条本地安装路径才是现在面向用户的真实可用路径。
对用户来说,最重要的好处很直接:装一次,开一个新的智能体会话,规则、技能、启动钩子和 MCP 连线就一起到位了。
开始之前
- Nowledge Mem 已在本地运行(安装指南),或你已经有可访问的远程 Mem 服务
- 已安装 Cursor IDE
- 推荐:如果你希望在会话开始时自动带上 Working Memory,并在需要时创建可恢复交接摘要,请让
nmem出现在PATH中
如果 Nowledge Mem 已经在同一台机器上的桌面应用中运行,最省事的方式仍然是 Settings -> Preferences -> Developer Tools -> Install CLI。这样 Cursor 就可以在会话开始时加载 Working Memory,也能在需要时通过终端工具调用 nmem。
一分钟安装
克隆或进入插件仓库
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 风格文案、save-thread,或者 beforeSubmitPrompt、stop 这类钩子,先把旧的导入版 nowledge-mem 包从 Cursor 里移除。这个本地包正确加载后,只应该看到 sessionStart 和四个 Nowledge Mem skills。本地包专门使用 nowledge-mem-cursor 这个插件 id,就是为了避开这个导入包的命名冲突。
开启新的智能体会话
打开一个新的智能体会话。
对于同机默认配置,插件内置的这些内容就是预期的零配置路径:
- 插件清单
- 常驻规则
- 技能
- 启动钩子
- 本地
mcp.json
如果已经安装了 nmem,这个启动钩子会在新会话开始时把 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:14242
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-memMCP 服务器地址,就能恢复同样的行为 - Cursor 里不再出现旧的 Claude 风格包界面,比如
save-thread、beforeSubmitPrompt或stop
你会得到什么
- 打包好的
.cursor-plugin/plugin.json - 用于启动时加载 Working Memory 的
hooks/hooks.json - 用于本地 Nowledge Mem MCP 连接的
mcp.json - 一条常驻规则,用来约束工作记忆简报、路由式检索、提炼与交接摘要语义
- 四个技能:
read-working-memory、search-memory、distill-memory与save-handoff
新用户真正关心的事
对第一次安装的用户来说,最重要的其实只有三件事:
- 本地 Mem:装好插件后直接开新会话
- 远程 Mem:装好插件后,把
nowledge-memMCP 服务器改到远程地址;如果还想保留启动简报和交接摘要,再把nmem也指向同一个远程服务 - 想把体验拉满:保留
nmemCLI,让 Cursor 能在新会话开始时先带上 Working Memory,也能在需要时生成交接摘要
重要约束
这个包故意 不 暴露 save-thread。
因为 Nowledge Mem 目前还没有在这里提供 Cursor 的一等实时会话导入器,所以摘要型保存必须继续叫 save-handoff,不能伪装成 save-thread。如果你需要导入真实 Cursor 对话,请使用应用里的 对话 -> 导入 -> 查找 AI 对话。本页里的插件语义必须保持清楚,未来真正的会话线程保存能力出现时才不会混乱。
包结构
这个包已经按 Cursor 插件格式组织好:
.cursor-plugin/plugin.json
rules/nowledge-mem.mdc
skills/*/SKILL.md
hooks/hooks.json
hooks/session-start.mjs
mcp.jsonCursor 的本地插件目录要求 .cursor-plugin/plugin.json 位于插件根目录。这个包已经满足这个约定,所以前面的本地安装流程就是现在可以直接给用户使用的正式路径。
以后如果上架 Marketplace
如果未来 Cursor Marketplace 接受了这个插件,再安装 Marketplace 版本即可。上架前,优先使用本地插件目录。
相关内容
Droid
Install Nowledge Mem in Factory Droid through the community marketplace and bring Working Memory, routed recall, distillation, and resumable handoffs into your sessions.
Codex CLI
Your Codex agent remembers past decisions, finds relevant context, and learns from every session, across all your AI tools.