Mind 同步
onemind Mind 同步会把团队已批准的指令交付到你 Mac 上每个 AI 工具的工作文件夹。把 Mind 设为手动,只在你选择时应用;设为自动,则无需额外步骤即可应用获批准的更新。
- 选择已批准的 Mind,点击同步。
- 核对 Project、AI 工具和设备;若面板提示,请在对应 Mac 上绑定 Project 文件夹。
- 选择手动,仅通过立即同步应用;或选择自动,应用获批准的更新。等待模式保存完成。
- 选择立即同步并等待确认结果。已请求同步或等待确认表示设备仍需应用并上报结果。
- 在该 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 任务中验证指导;交付本身不能证明工具正确使用了它。 |
要查看团队所有设备的同步历史与状态,请打开侧边抽屉的同步。详见同步活动。