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
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 版本即可。上架前，优先使用本地插件目录。