工作树分仓 · 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 标签文 解决主干合并车道饥饿；本文解决单机多工作树目录隔离与缓存世代；二者应在变更单里同时出现链接以免只优化其一。