跳至指南

在 Qoder 中使用 onemind

Qoder 支持原生 BETA Project 文件夹同步和显式 CLI Project 目标。onemind 不为 Qoder 提供技能能力。原生 BETA 同步还会在 ~/.qoder/AGENTS.md 中维护一个稳定的用户级引导区块；Project 内容保留在绑定文件夹中。

macOS App

在 App 中，先从团队连接 Qoder 并绑定 Project 文件夹，再进行 Mind 同步。

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

CLI

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

onemind project qoder .

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

onemind sync
onemind status

确认 <代码仓库>/AGENTS.md 包含 onemind 管理区块，然后重新打开 Qoder 对话或新建 Qoder 会话。Qoder IDE 与 Qoder CLI 都会自动识别代码仓库根目录的 AGENTS.md。onemind 会保留管理区块之外的指令，并在首次写入时备份到 <代码仓库>/.one-mind/AGENTS.md.backup。

运行 onemind qoder [PATH] 会调用与 onemind project qoder 相同的检测步骤，并添加一个非活跃目标。新的原生文件夹绑定以精确 Project、工具和设备为范围；不要用旧快捷命令移动已有原生绑定。

onemind 使用以下 Qoder 原生插件命令完成安装、列出和卸载。保留的 Qoder 1.1.5 制品已运行这一原生本地软件包契约；不声称已有认证供应商制品 CI：

qodercli plugins install "$ROOT/onemind" --scope user
qodercli plugins list --json
qodercli plugins uninstall onemind --scope user --keep-data

原生清单会把本地能力包标识为 onemind@local。Qoder 的 plugins update 只适用于 marketplace 插件，因此更新本地能力包时应重新安装新解压的版本。只有旧版 Qoder CLI 不提供原生 plugins 命令时，onemind 才使用兼容后备方案：把 skills/onemind 复制到 ~/.qoder/skills/onemind，再运行 qodercli mcp add -s user -t http onemind https://onemind.team/mcp。