跳至指南

在 OpenCode 中使用 onemind

OpenCode 同时支持 onemind macOS App 和 CLI。onemind 会将服务器组合的单一包写入精确绑定的 Project 目录中的 AGENTS.md。原生 BETA 同步还会在 ~/.config/opencode/AGENTS.md 中维护一个稳定的用户级引导区块；Project 内容保留在绑定文件夹中。

macOS App

  1. 登录 OneMind BETA.app，在团队中连接 OpenCode（宿主支持已验证 Connect 时）。
  2. 打开 Mind，选择目标 Project，并绑定这台 Mac 上的精确文件夹。
  3. 打开已批准的 Mind，选择同步，勾选工具/设备，然后选择立即同步。等待已确认的交付。
  4. 原生 App 会在 ~/.config/opencode/opencode.json 中写入并验证远端 MCP 条目，并将连接标记为"已连接"。从该文件夹新建 OpenCode 任务。有关等待中、离线和恢复状态，请参阅 Mind 同步。

原生 App 管理其自身的连接和文件夹绑定；CLI 代码仓库检测是单独的终端工作流。

CLI

运行：

onemind project opencode .

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

onemind sync
onemind status

确认 <代码仓库>/AGENTS.md 包含组合后的 onemind 管理区块。从该代码仓库新建 OpenCode 会话。

明确运行 onemind integrations install opencode 会把已签名 onemind skill 准备到 ~/.config/opencode/skills/onemind。此步骤安装 skill 包，但不验证 OpenCode 插件或 MCP 连接是否已安装；该包显示为 package prepared。