跳至指南

在 Pi 中使用 onemind

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

Pi 也可从共享 Agent Skills 目录 ~/.agents/skills 加载另行安装的 onemind 技能。

macOS App

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

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

CLI

运行：

onemind project pi .

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

onemind sync
onemind status

确认 <代码仓库>/AGENTS.md 包含组合后的 onemind 管理区块。首次写入时，onemind 会将之前的文件保存到 <代码仓库>/.one-mind/AGENTS.md.backup。从该代码仓库新建 Pi 会话。

Pi skill 安装到 ~/.agents/skills。使用 onemind integrations install pi 安装或更新集成。