跳至指南

在 Cursor 中使用 onemind

Cursor 支持 CLI 选择的 Team Project 目标和独立激活的普通 Project 代码仓库目标。Project 指令目标为 .cursor/rules/one-mind.mdc。原生 BETA 同步单独在 ~/.cursor/plugins/local/onemind-team-context/rules/one-mind.mdc 维护稳定的用户级引导规则，不把 Project 内容复制到全局规则。onemind 不为 Cursor 提供技能能力。

macOS App

  1. 登录 OneMind BETA.app；若宿主支持可验证的连接，从团队连接 Cursor。
  2. 打开 Mind，选择目标 Project，在这台 Mac 上绑定精确文件夹。
  3. 打开已批准 Mind，选择同步，核对工具／设备后选择立即同步，等待交付确认。
  4. 从该文件夹新建 Cursor 聊天或 Agent 会话。等待、离线与恢复说明见 Mind 同步。

原生 App 自行管理连接和文件夹绑定；CLI 仓库检测是独立终端流程。

CLI

从 Cursor 打开的代码仓库运行：

onemind project cursor .

CLI 会检测 Cursor，并打印消息提示你打开 onemind，为检测到的文件夹选择 Project Mind。打开 onemind App，在同步设置中找到检测到的文件夹，并将其绑定到目标 Project Mind。然后运行：

onemind sync
onemind status

确认 <代码仓库>/.cursor/rules/one-mind.mdc 包含受管 Project 包。首次写入时，onemind 会在 .one-mind 文件夹中将之前的文件保存为备份。新建 Cursor 聊天或 Agent 会话。

可选的 ~/.cursor/plugins/local/onemind 宿主集成拥有独立生命周期，由 onemind integrations 管理。onemind 会原子替换自己拥有的规则区块，阻止版本倒退，并在验证失败时保留原规则。内置 Cursor rules/skill/MCP 能力包由 onemind 原子管理；明确的安装、更新或卸载操作会在可用时运行只读 cursor-agent --print --output-format json 标记探测。只有新鲜且精确的标记结果才是已连接证据；被动状态绝不启动 Cursor。

Cursor Project 组合同步和 Project 结构化 outbox 同步均可用。对于已激活的 Cursor Project binding，onemind 可以同步已审核记忆；当同步设置中该目标的上传已启用时，还会上传该 Project 的结构化 onemind 提案队列。onemind 不会读取 Cursor 的专有聊天数据库，也不会把任意文件变化当作长期知识。