Project 与文件夹
Project 是 onemind 中的工作范围；Project 文件夹是特定设备上的精确本地目标。另一台设备上的同名文件夹不是同一个绑定。
- 打开 Mind；若角色允许，选择添加项目，填写名称、目标和说明。
- 在 macOS App 中可选择现有本地文件夹。在浏览器中先创建 Project，再到 App 中绑定文件夹。
- 对于已有 Project，打开管理项目并选择绑定本地文件夹，或在其 Mind 同步面板选择在这台 Mac 上绑定这个 Project 的文件夹。
- 核对精确文件夹与设备。若 Project 已创建但文件夹关联失败，请在该 Project 上重试关联，不要重复创建 Project。
绑定会为兼容且已连接的工具准备设置，启用同步并保持上传关闭，在手动自动化模式下不会应用 Mind，核对目标后再选择立即同步；在半自动或自动模式下，该 Project 已批准的 Mind 会自动到达这个文件夹。已有禁用选择保持禁用。Project 信息更新和删除请求需要管理员批准；Team Project 不能删除。
文件夹移动或 Mac 重新授权后，请重新绑定这个已有 Project 的精确文件夹。不要用主目录或其他 Project 的文件夹代替。
多个 AI 工具可以共用同一个 Project 文件夹。每个工具写入自己的原生指令文件，例如 Codex 的 AGENTS.md、Claude Code 的 CLAUDE.md 和 Antigravity 的 GEMINI.md，并保留其他工具的管理内容。某个工具同步失败不会影响其他工具当前的指令。
Project 详情与审批
编辑 Project 的名称、目标、说明、状态或健康度，会创建一个待处理草稿，管理员批准后 Matrix 才会发布该变更。如需提交变更，打开管理项目，更新相应字段，然后选择请求批准。页面会显示："项目更新已提交管理员审批。批准前会继续使用当前信息。"
状态有三个值：
| 状态 | 含义 |
|---|---|
| 规划中 | 工作尚未开始 |
| 进行中 | 工作正在进行 |
| 已暂停 | 工作暂时停止 |
健康度有四个值：
| 健康度 | 含义 |
|---|---|
| 未评估 | 未记录健康状态 |
| 进展正常 | 工作进展顺利 |
| 存在风险 | 工作可能无法达成目标 |
| 受阻 | 工作无法继续，直至障碍解除 |
管理员从通知中打开待处理编辑，并排查看拟议信息与当前信息，然后选择批准更新或拒绝更新。批准将通过 Matrix 发布变更；拒绝则保留当前信息。现任管理员可批准自己的草稿。只有管理员可批准或拒绝；任何成员均可提交变更请求。
Project 文件更新
Project 文件更新请求由 CLI 或通过 MCP 连接的 AI 工具创建，当磁盘上的 Project 文件相对于 Matrix 已批准版本已过期时触发。CLI 后台服务会在你的 Mac 上应用批准结果。BETA 网页端和 macOS App 可让你审核并决定待处理的请求；它们不会创建或应用请求本身。
如需审核待处理的请求，打开其通知或进入审核文件更新面板。
- 阅读面板中显示的拟议文件内容。
- 勾选我已审核完整的拟议文件。
- 选择以下四个操作之一：
| 操作 | 效果 |
|---|---|
| 批准 | macOS App 在下次检查时应用更新，写入前重新验证两个文件哈希值。 |
| 拒绝 | 保持本地文件不变；请求关闭。 |
| 稍后处理 | 不更改本地文件，请求保持待处理状态，可稍后返回处理。 |
| 取消 | 关闭面板但不记录决定。 |
面板显示请求的当前状态：
| 状态 | 含义 |
|---|---|
| 等待审核 | 请求已就绪，等待你的决定。 |
| 已批准；等待本地客户端 | 已批准；macOS App 尚未应用文件。 |
| 本地客户端已应用并验证 | 更新已应用，两个哈希值均已确认。 |
| 已拒绝 | 已拒绝请求；本地文件未变更。 |
| 文件已更改，需要新的请求。 | 此请求创建后远程文件发生变更，请提交新请求。 |
| 此请求已过期。 | 请求未及时处理，需要新请求。 |
| 本地更新失败。请在客户端检查恢复步骤。 | 在 Mac 上应用失败，请检查 macOS App 的恢复步骤。 |
只有设备所有者可批准或拒绝请求，因为此决定是设备级的。若远程文件在请求创建后发生变更，面板将显示冲突状态，需要提交新请求。