工作樹分倉 · DerivedData 路徑 · 依賴緩存世代 · 六步 Runbook · 決策矩陣與 FAQ
在少量遠程 Mac 組成 Mac Mesh、卻要同時維護 release、hotfix 與長周期 feature 的平臺負責人與移動端 Tech Lead常被三類工單纏住：同一工作副本被 CI 與人類來回 checkout 撕碎、DerivedData 與依賴緩存目錄在多分支間串味、以及半截構建佔住席位鎖卻找不到對應工作樹。本文先回答誰遇到什麼問題：共享池上「多分支並行」與「無人值守 Runner」爭用同一磁碟與鎖語義；再給出結論：用 Git Worktree 的可審計目錄布局 + 每樹獨立的構建與緩存根 + 與租約欄位對齊的命名約定把並行從「群聊默契」變成可驗收清單；結構上依次交付隱性痛點拆解、三種工作流對照表、六步落地 Runbook、可引用閾值與決策矩陣。與 Runner 拓撲和 SSH 接力請交叉閱讀 共享構建池與 Runner 編排；與並發席位、鎖 TTL 與飢餓防護請見 並發席位與互斥實操；與 Monorepo 緩存鍵與扇出請見 影響範圍構建與緩存鍵；與鏡像漂移巡檢請見 Golden Image 漂移清單；需要把上述規則落到獨佔、可合同化 SLA 的雲端 Mac 節點可走 訂購頁 與 幫助中心。
當你把多臺遠程 Mac 當成 mesh 使用，卻仍在每臺機器上只維護單一檢出目錄時，release 熱修與長周期 feature 會在同一工作副本上互相踩踏。下面五條在 2026 年的跨區團隊工單裡反覆出現；把它們寫進 README 與 Runner 說明，比再多掛一臺 Runner 更能降低「偶發紅構建」的玄學指數。
單一 git checkout 與 CI 競態：人類為熱修切分支的同時，自託管 Runner 正在同一目錄拉取另一組對象；表現為編譯器讀到半截索引文件或測試夾具隨機缺失，復盤時卻找不到「誰覆蓋了誰」。
DerivedData 與模塊緩存共享根：多分支並行卻把 Xcode 派生目錄、SwiftPM 緩存或 CocoaPods 沙箱指向同一物理路徑；一次清理命令可能抹掉另一分支半小時前的增量編譯成果。
鎖語義與目錄名脫節：並發席位鎖或租約記錄裡只寫了主機名與 PID，卻未寫入 worktree path 與 HEAD 短哈希；排障只能 SSH 上去「看誰佔著」，無法把隊列指標與具體工作樹對齊。
Runner 默認路徑與交互會話重合：同一用戶主目錄下既跑 xcodebuild 無人值守任務，又進行 Archive 或真機調試；GUI 彈窗、鑰匙串授權與後臺 Job 爭用同一登錄會話，放大為夜間回歸集體超時。
跨區拉取與佔席疊加：在 mesh 中把重編譯放到遠端節點時，若 worktree 未固定依賴緩存世代，網絡類重試會無限放大並長時間佔用席位，觸發與 Merge Queue 與 Runner 標籤飢餓 文檔中描述相似的「假飢餓」。
把上述五條映射到「可交付物」：每分支獨立工作樹清單、每樹派生與依賴根路徑表、Runner 檢出路徑白名單、席位鎖四元組（主機、樹路徑、租約 id、工具鏈指紋）、以及一次最小可復現的 clean 與增量對照命令。沒有這五張紙，就不允許把「並行多分支」寫進季度目標。
再補一層協作視角：當節點成為公共設施，評審粒度要從「我本地能編過」提升到「下一位同事在同一臺機器的另一棵樹上是否仍能編過」。這意味著變更單裡必須附上：受影響的 worktree 列表、是否觸發全量清理、以及回滾到單樹模式的開關條件。
最後，別把「並行」誤解成「並行佔用同一默認可變目錄」。即便磁碟緊張，也應先評估 git worktree 與對象庫共享帶來的收益，再決定是否在第二臺節點上複製整倉；否則你只是把衝突從 Git 層推遲到 rsync 與緩存 tarball 層。與共享池字節路徑和 staged publish 相關的工程細節，務必與 產物扇出與 rsync 對照 文交叉閱讀。
當你把隱性稅拆成清單後，團隊會自然問：「我們到底該多目錄 clone、頻繁 checkout，還是引入 worktree？」下一節用對照表把磁碟、fetch 成本與操作風險放到同一頁上評審。
沒有銀彈，只有與你分支並行度、磁碟預算、以及團隊對 Git 心理模型相匹配的選擇。請把矩陣列印在評審頁上：只允許勾選一格作為本季度默認，並在腳註寫明「何時觸發擴容到下一格」。
| 模式 | 適用前提 | 主要收益 | 主要風險 |
|---|---|---|---|
| 單目錄頻繁 checkout | 個人獨佔節點、串行發布、無 CI 與人類混跑 | 心智最簡單；磁碟佔用最低 | 與 Runner 與人類並發時極易競態；不可審計 |
| 多目錄全量 clone | 分支並行度低、磁碟充裕、需要完全隔離的 hooks 與鉤子腳本 | 爆炸半徑清晰；適合強合規隔離 | fetch 與對象複製成本高；漂移治理負擔大 |
| Git Worktree 多樹共享對象庫 | 2–6 條活躍分支、共享池磁碟中等、需要可審計並行 | 共享 .git/objects；切換分支不破壞其他樹的工作區 | 路徑與清理策略必須寫清；新手誤刪 .git/worktrees 元數據會傷根倉 |
並行分支的底線是：每一套可寫構建產物都必須能映射到一棵明確的工作樹；否則你只能把紅構建歸因給「運氣」。
若你最終落在 worktree，請把「分樹」定義成可機器校驗的四元組：裸倉或主工作區路徑、每樹 HEAD、派生數據根、以及依賴緩存根。任何一步無法在三行內寫清楚，就不算分樹完成。
下列順序刻意把「最便宜的核對」放在最前；任何一步失敗都應停止向下猜測並保存輸出。與 Runner 註冊、標籤路由與 SSH 主機別名相關的拓撲欄位，請與 共享構建池 SSH 與 Runner 編排 對齊。
凍結裸倉位置：選定單一 bare 或主工作區作為對象權威；禁止在 Runner 腳本裡隱式 git clone 到未登記路徑。
登記每棵 worktree：用 git worktree list --porcelain 導出機器可讀清單提交到內部倉庫；欄位至少包含 path、branch、HEAD。
綁定派生與依賴根：為每樹設置 OBJROOT、SYMROOT、DerivedData 或 SwiftPM 緩存目錄，命名中必須含分支代號與短哈希，避免清理腳本誤傷鄰樹。
分離 Runner 檢出路徑：為 CI Job 使用獨立 worktree 或獨立 clone 根，禁止與人類交互會話共用 ~/Projects/main 類模糊默認路徑。
把租約寫進元數據：領取席位鎖時寫入樹路徑、工具鏈指紋與預計佔用時長；與 鎖 TTL 與預約窗口 文對齊欄位，避免懸掛鎖。
演練 prune 與回收：在 staging 節點上演練 git worktree remove 與孤兒目錄掃描，確認不會刪除仍在隊列中的 Job 目錄。
~/mesh/repos/acme.git # bare 推薦 ~/mesh/wt/acme-release-2a9f # worktree: release/* ~/mesh/wt/acme-hotfix-7c1e # worktree: hotfix/* ~/mesh/ci/acme-merge # Runner 專用 clone 或 worktree DerivedData 根示例： ~/mesh/dd/acme--release--2a9f ~/mesh/dd/acme--hotfix--7c1e
提示：若 Monorepo 已上 affected builds，請把「樹路徑」欄位併入緩存鍵與觸發規則，詳見 影響範圍構建文，避免只優化計算圖卻忽略磁碟側串味。
這一節只收錄能在路徑與鎖欄位裡點名的事實，避免「感覺 Xcode 偶卡」這類不可審計表述。需要鏡像批次與快照回滾口徑時回到 Golden Image 漂移清單。
xcodebuild clean 與按樹增量清理必須分屬不同運維角色；任何「全清」必須附帶受影響的樹列表與 Job id 範圍。注意：不要在同一維護窗口同時滾動 Xcode 大版本、調整 DerivedData 根路徑、並改動 Runner 標籤；三角變更會讓回滾無法二分。
把「能不能並行」從口號落成可勾選門禁；任一格無法勾選，就降級為串行發布或增加節點。下表可與 並發席位與互斥 的隊列表合併評審。
| 組合 | 推薦默認 | 必須滿足的硬條件 | 常見失敗信號 |
|---|---|---|---|
| 小團隊 · 低並行 · 無混跑 | 單目錄 + 嚴格發布窗口 | 節點獨佔或明確日曆預約 | 熱修周期間 feature 分支「神秘」紅構建 |
| 小團隊 · 中並行 · 有混跑 | worktree 2–4 棵 + Runner 獨立根 | 派生與依賴根分樹；鎖元數據含樹路徑 | 清理腳本誤刪鄰樹半成品 |
| 平臺組 · 高並行 · mesh 多區 | 專用 CI 節點扇出 + 人類節點分區 | 標籤路由、席位上限與緩存鍵世代三線對齊 | 隊列深度上升但 CPU 仍空閒（鎖與路徑錯配） |
長期靠「某位核心同事腦內地圖」維護共享池，會在人員流動時把風險集中爆發；把 worktree 清單與路徑表沉澱成倉庫資產，才能把 Mac Mesh 從個人技巧升級為公司基礎設施。
常見誤區：看到紅構建就先全量 clean；多數時候應先核對是否與其他樹共享 DerivedData 根或是否半截 Job 仍佔席。
純腳本臨時創建目錄而不寫清單，在審計場景下很難證明「哪棵樹在何時佔用哪段磁碟」；當多分支並行需要與獨佔節點、可預期地區與網絡檔位一併歸檔時，個人筆記本或口頭約定的共享機往往缺少可籤字的變更單與 SLA。對於要把 iOS 持續集成、接力開發與席位隔離落在可合同化雲端 Mac Mini上的團隊，VpsMesh 的 Mac Mini 雲端租賃通常是更優解：按區域與規格擴展池容量，並把路徑、鎖與 Runner 拓撲寫進同一套運維語言；價格見 價格頁，接入與運維說明見 幫助中心，需要新增專用 CI 節點可走 訂購頁。
最常見是單一 DerivedData 根、單一 CocoaPods 或 SwiftPM 緩存目錄、以及 Runner 默認檢出路徑與人類會話重合。應把每棵 worktree 的構建產物與依賴緩存寫到可預測且帶分支代號的子路徑，並與 共享池席位鎖欄位 對齊。
省磁碟與 fetch 次數、共享對象庫；犧牲的是錯誤配置時的爆炸半徑與心理模型複雜度。若團隊不熟悉 git worktree 命令族，應先用第二節對照表評審再落地；與 Runner 拓撲細節見 共享構建池文。
Merge Queue 與 Runner 標籤文 解決主幹合併車道飢餓；本文解決單機多工作樹目錄隔離與緩存世代；二者應在變更單裡同時出現連結以免只優化其一。