跳至指南

Mind 同步

onemind Mind 同步会把团队已批准的指令交付到你 Mac 上每个 AI 工具的工作文件夹。把 Mind 设为手动,只在你选择时应用;设为自动,则无需额外步骤即可应用获批准的更新。

  1. 选择已批准的 Mind,点击同步。
  2. 核对 Project、AI 工具和设备;若面板提示,请在对应 Mac 上绑定 Project 文件夹。
  3. 选择手动,仅通过立即同步应用;或选择自动,应用获批准的更新。等待模式保存完成。
  4. 选择立即同步并等待确认结果。已请求同步或等待确认表示设备仍需应用并上报结果。
  5. 在该 AI 工具中从已绑定文件夹新建任务,请它说明适用的 onemind 指导,并在真实任务中验证一条相关规则。

原生 Project 同步维护一个小型、稳定的用户级引导区块,并把已批准内容写入精确 Project 文件夹。Codex 对应 ~/.codex/AGENTS.md 和 <project>/AGENTS.md。引导区块指向 Project 指令与已批准文件回执,不会把 Project 内容复制进全局指令。其他工具使用其注册的原生路径。onemind 保留管理区块外的内容,并在应用变更前要求备份和检查证据。

同步目标

同步面板列出当前 Mac 上所有已连接且绑定了 Project 文件夹的 AI 工具。每行显示工具名称、设备和当前同步模式。选择自动,每次 Mind 更新时应用获批准的更新;选择手动,仅在选择立即同步时应用。在半自动或自动自动化模式下,新绑定的文件夹、新连接的 AI 工具和新建的 Mind 默认为自动;你设为手动的行会保持手动。

当一个 Mind 有多个连接到同一 Project 的 AI 工具时,选择立即同步会一次性应用到所有符合条件的绑定。全部工具尝试完成后,面板显示类似以下的汇总:"同步结果:已同步 2 · 排队中 1 · 失败 0 · 不可用 0。"

包含 Project 内容的 Mind 只能同步到该 Project 的已绑定文件夹。将其同步到其他文件夹会出现 Project 目标错误。

CLI 用户激活 Project 目标后可运行 onemind sync 和 onemind status。CLI 支持三种同步模式:auto(在后台应用每次获批准的更新)、manual(只在运行 onemind sync 时同步)和 disabled(跳过后台协调;明确发起的分析仍独立运行)。新会话的密码学证明需要明确指定并通过认证的宿主适配器;onemind 并未为每个厂商捆绑此类适配器。

按 Mind 设置的手动与自动开关,决定该 Mind 的已批准更新何时到达你的 Mac。设置 > 偏好设置中另有账户级的自动化模式,控制 onemind 是否代你发起工具连接,以及已批准的 Mind 是否无需逐个设置就到达新绑定的文件夹;只有管理员可以选择自动。三种选项见通知与设置。

同步设置

Mind 首次与新的 AI 工具绑定同步前,需要完成同步设置。出现提示时,打开同步面板并选择完成同步设置。设置会写入引导文件并建立绑定。

若设置无法安全完成,面板显示:"无法安全完成 Mind 同步设置。请检查 AI 工具同步设置后重试。"若该目标已存在冲突的设置,面板显示:"此目标的同步设置存在冲突。请先检查 AI 工具同步设置,再使用这个 Mind。"在使用这个 Mind 前,请在那台 Mac 上检查 AI 工具的同步设置以解决冲突。

若 macOS App 更新后需要重新连接 Project 文件夹,请使用设置 > 存储恢复文件夹关联,凭据、草稿、绑定、备份和 Project 文件都会保留。

同步失败时

同步失败后,阅读同步面板中的错误提示,并按该错误的步骤处理:

显示内容处理方式
离线在那台 Mac 上打开 onemind,按需登录并重新连接工具。
没有绑定 Project 文件夹在 macOS App 中绑定精确文件夹。
等待确认/已请求同步保持 Mac 可用,选择刷新状态;它只重新读取证据,不会重放写入。
设置或文件冲突——设置无法完成在那台 Mac 上检查 AI 工具同步设置并重试。
设置或文件冲突——存在冲突的设置检查同步设置,在使用这个 Mind 前解决冲突。
与其他设置的文件冲突目标文件夹中有一个由其他设置管理的 AI 工具文件。请先在那台 Mac 上解决文件冲突,然后再次同步。
CLAUDE.md 导入冲突创建 CLAUDE.md 可能会改变 Claude 加载的共享指令。请先在那台 Mac 上配置此 Project 的 CLAUDE.md 及所需导入,然后再次同步。
本地写入失败onemind 无法在那台 Mac 上安全完成 AI 工具文件写入。请检查已绑定文件夹和本地文件后重试。
备份失败onemind 无法创建保护此次同步的备份,因此没有做任何更改。请检查备份后重试。
请求被拒绝同步服务因授权已变化而拒绝了此请求。请再次同步。
Project 目标不匹配这个 Mind 包含 Project 内容,只能同步到该 Project 已绑定的文件夹。
设备忙碌另一个同步仍在写入这个 AI 工具。请稍候片刻再试。
需要重新连接那台 Mac 上这个 AI 工具的连接或同步设置已过期。请重新连接 AI 工具后重试。
已同步交付已确认。请在新的 AI 任务中验证指导;交付本身不能证明工具正确使用了它。

要查看团队所有设备的同步历史与状态,请打开侧边抽屉的同步。详见同步活动。