Project 與資料夾
Project 是 onemind 中的工作範圍。其 Project 資料夾是特定裝置上的精確本地目標；另一台裝置上的相似資料夾名稱並非相同的綁定。
- 開啟 Mind；若你的角色允許，選擇新增 Project，填寫名稱、目標和說明。
- 在 macOS App 中可選擇現有本地資料夾。在瀏覽器中先建立 Project，再到 App 中綁定資料夾。
- 對於已有 Project，開啟管理 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 才會發布此變更。若要提交變更，開啟管理 Project，更新相關欄位，然後選擇請求批准。頁面將顯示「項目更新已提交管理員審批。批准前會繼續使用目前資料。」
狀態有三個值：
| 狀態 | 含義 |
|---|---|
| 規劃中 | 工作尚未開始 |
| 進行中 | 工作正在進行 |
| 已暫停 | 工作暫時停止 |
健康有四個值：
| 健康 | 含義 |
|---|---|
| 未評估 | 尚未記錄任何健康訊號 |
| 進展正常 | 工作進展順利 |
| 存在風險 | 工作可能無法達成目標 |
| 受阻 | 工作無法繼續，直至障礙解除 |
管理員從通知中開啟待審編輯，並排並閱讀建議資訊和現有資訊，然後選擇批准更新或拒絕更新。批准後，Matrix 會發布變更；拒絕則保持現有資訊不變。現任管理員可批准自己的草稿。只有管理員可以批准或拒絕；任何成員均可提交變更請求。
Project 檔案更新
Project 檔案更新請求由 CLI 或透過 MCP 連接的 AI 工具建立，當磁碟上的 Project 檔案相對於已批准的 Matrix 版本過時時觸發。CLI 背景服務在你的 Mac 上套用批准。BETA 網頁版及 macOS App 讓你審核並決定待審請求；它們本身不會建立或套用請求。
若要審核待審請求，開啟其通知或前往審核檔案更新面板。
- 閱讀面板中顯示的建議檔案內容。
- 勾選我已審核完整的建議檔案。
- 從以下四個操作中選擇一項：
| 操作 | 效果 |
|---|---|
| 批准 | macOS App 在下次檢查時套用更新，並在寫入前重新驗證兩個檔案雜湊值。 |
| 拒絕 | 保持本機檔案不變；請求關閉。 |
| 稍後處理 | 請求保持待審狀態，本機檔案不變。你可以稍後再處理。 |
| 取消 | 關閉面板，不記錄任何決定。 |
面板顯示請求的目前狀態：
| 狀態 | 含義 |
|---|---|
| 等待審核 | 請求已準備好等待你的決定。 |
| 已批准；等待本機用戶端 | 你已批准；macOS App 尚未套用檔案。 |
| 本機用戶端已套用並驗證 | 更新已套用，兩個雜湊值均已確認。 |
| 已拒絕 | 你已拒絕請求；本機檔案不變。 |
| 檔案已變更，需要新的請求。 | 此請求建立後，遠端檔案已變更；請提交新請求。 |
| 此請求已過期。 | 請求未在時限內處理；需要新的請求。 |
| 本機更新失敗。請在用戶端檢查復原步驟。 | 在 Mac 上套用失敗；請在 macOS App 中檢查復原步驟。 |
只有裝置擁有者可以批准或拒絕請求，因為決定範圍限於裝置。若請求建立後遠端檔案發生變更，面板會顯示衝突狀態，需要提交新請求。