远程 Mac 集群为何放大监听与磁盘风险
远程 Mac 集群把 checkout、装依赖与并行代理叠在同一形态的工作树上，vnode 与 FSEvents 流量在真正进入链接器之前就先打成事件风暴。不设上限时，M4 的 CPU 会耗在失效扇出而不是编译。
- Watcher 扇出：监听根若包含构建产物或包管理器缓存，会在多代理间成倍放大通知。
- 并行无界：共享 APFS 卷上未封顶的任务数会叠加 IO 抖动，缓存同时失效。
- 磁盘水位漂移：模拟器、容器层与黄金目录悄悄吃光余量，直到流水线中段链接失败才暴露。
构建完成后的制品搬运请与《跨区 Mac Mini M4 rsync 决策矩阵》对齐；访问与计费问题见帮助中心。姊妹调度文：Nomad 亲和与构建锁；全文索引：技术博客首页。
Watchman 与 Git 轮询对照
Watchman 适合 Apple Silicon 大增量图；监听侧顶穿 SLO 时，Git 轮询用延迟换稳定。按池标准化。
| 决策信号 | Watchman 优先 | Git 轮询优先 |
|---|---|---|
| 失效延迟目标 | 忽略目录足够严时可达亚秒级失效。 | 秒级到数十秒；高 churn 下曲线平。 |
| M4 在尖峰下的 CPU | 根目录收窄则低；忽略泄漏则尖刺。 | 主要与轮询间隔绑定的可预期突发。 |
| 运维风险 | 任务间需 watch-del-all 等卫生动作。 |
轮询过稀会漏掉极快的本地编辑。 |
| 集群默认 | Metro、RN、巨型 JS 图的主路径。 | sysctl 压力或风暴 SLO 失败时的退路。 |
在共享池上发布前强制合并一份 .watchmanconfig，排除 node_modules、Pods、build、.git/objects 等路径——漏忽略项应视为阻断上线的门禁。
{
"ignore_dirs": [
"**/node_modules",
"**/.git/objects",
"**/Pods",
"**/DerivedData"
],
"settle": 20
}
当风暴计数器持续升高时，把 settle 逐步抬到 40–80 ms 区间，用聚合窗口换更低的通知频率；若仍无效，再评估整池退回 Git 轮询。
sysctl、fs 限制与节流参数
监听调优必须与主机上限配对，避免单次任务在事件风暴中耗尽描述符。在扩大 M4 池的并行扇出前，先用 CI 用户身份采集 ulimit -n 与峰值句柄曲线。
- 描述符：软上限建议不低于观测峰值的 2×；否则重任务池应退回 Git 轮询或拆 workspace。
- 编译节流：16–24 GB 统一内存档位上，重 Swift / LTO 车道先封顶 2–4 路并行，直到构建锁等待时间回落。
- 准备阶段批处理：把重度写盘步骤打成一批，让 Watchman 看到单次突发而非碎写。
下面为可执行片段：先只读巡检，再示例会话级上调；持久化写入 sysctl.conf 前须与运维/安全确认。
# 只读巡检（CI 用户） sysctl kern.maxfiles kern.maxfilesperproc ulimit -n # 会话级示例（持久化前与运维确认） sudo sysctl -w kern.maxfiles=200000 sudo sysctl -w kern.maxfilesperproc=65535 ulimit -n 65535
与大仓构建锁协同
节流旋钮必须与「单一晋升写入者」同向：调度器负责放位，flock 守住 promote 临界区，详见《Nomad 亲和、构建锁与磁盘水位》。持锁期间应暂停过宽的 Watchman 根或临时降级为轮询，避免锁外仍在扇出失效。
若连续两次发版窗口内，构建锁平均等待超过 3 分钟，优先把编译并发减 1 再查工具链缺陷——多数时候是磁盘与通知争用而非编译器本身。
磁盘水位告警值建议（1TB / 2TB）
在 Mac Mini M4 上混跑 Xcode、模拟器与容器 CI 时，把 APFS 利用率当作发版门闩，而不是事后看板装饰。
| 卷利用率 | 1TB 验收动作 | 2TB 验收动作 | 告警严重度 |
|---|---|---|---|
| < 70% | 绿区：常规并发；周常轮转日志。 | 绿区：可多开模拟器；负载跨节点分散。 | 仅信息摘要。 |
| 70–80% | 黄区：排期清理 DerivedData；冻结新快照。 | 黄区：复核每 job 的制品预取体积。 | 值班周报汇总。 |
| 80–90% | 红区：规划升 2TB 或外迁冷制品；暂停非必要 batch。 | 红区：余量恢复前拦截新的重磁盘任务。 | 立即工单；高风险流水线熔断。 |
| > 90% | 硬失败：撕裂产物与 hook 失败概率高。 | 硬停晋升；持续则 drain 节点。 | Sev-1；冻结对共享树的集群写入。 |
验收清单：每主机 5 分钟探针余量并去重；黄区超 48h 开容量工单；rsync 扇出套用同门闩。
六步落地 runbook
- 用 Watchman 日志为每类 job 基线化通知量，再发布统一
.watchmanconfig忽略表。 - 按内存档位设定编译并发上限，每次发版后记录构建锁等待直方图。
- 加节点前在黄金镜像里对齐 sysctl 与
ulimit默认值。 - 把磁盘探针接到上表黄/红带，并镜像到事件系统。
- 为「风暴日」写清 Git 轮询退路，链接贴在调度 playbook 旁。
- 每次大版本 Xcode 或容器基底升级后重跑本矩阵——缓存体积变化会挪动阈值。
常见问题
Watchman 能替代调度器吗？不能。它只喂增量工具；放位与锁仍由编排层负责。
事件风暴为何反复出现？新覆盖率或 trace 路径绕过忽略——在 CI 里 lint 禁止的监听根。
何时全量 Git 轮询？无 Watchman 仍满足失效 SLO，且 fleet 扛得住轮询间隔时。