多显示器时自动关闭 macOS 台前调度（Stage Manager），拔掉外接屏后自动恢复原状。
它是唯一「记得你原本设置」的 Stage Manager 开关：多屏自动关，单屏恢复成 你关掉之前的状态——包括「你本来就没开」的情况，它不会自作主张给你打开。
外接显示器时，Stage Manager 的应用条带会吃掉屏幕边缘、干扰窗口拖拽； 回到单屏时又往往想把它开回来。手动去系统设置里点开关，一天要来回点两次。
Apple 没有公开控制 Stage Manager 的 API——同类项目 StageControl 正因此搁浅。 本工具的路线是用辅助功能（AX）直接操作系统设置里的真实开关，绕开了这个死路。
macOS 27 实测（macOS 13+ 同理，未逐一验证）：
defaults write com.apple.windowmanager GloballyEnabled不生效。 偏好值会落盘、WindowManager 也不重启，但系统行为完全不变；killall -HUP WindowManager与真killall WindowManager同样无效 （已用系统设置里的 checkbox 读回坐实）。- 唯一可靠通道是点击「系统设置 › 桌面与程序坞」里的 Stage Manager 开关。 点击后 UI 值、偏好值、真实窗口行为三者同步改变。
- launchd 任务点不了它。 launchd 起的进程拿不到辅助功能（AX）权限
（System Events 一律
AppleEvent timed out），AX 授权绑定在用户登录会话上。
因此架构是两进程：
┌─────────────────────────────┐ request.json ┌──────────────────────────────┐
│ guard（launchd，每 3s） │ ────────────────────▶ │ daemon（用户会话常驻） │
│ 数显示器（NSScreen）→ 决策 │ ◀──────────────────── │ 真正点击系统设置里的开关 │
│ 只检测、不点 GUI │ result.json │ 轮询请求 → 点击 → 读回校验 │
└─────────────────────────────┘ └──────────────────────────────┘
- 显示器数用
NSScreen口径（镜像屏/休眠屏会改变实际可用屏数，system_profiler会虚报）。 - 每次点击都有读回校验（UI 值 + 偏好值双确认），不报错≠成功。
- 状态文件区分「本工具关的」与「用户自己关的」：只有前者会被恢复。
- 请求带单调递增 seq + inflight 改名占位 + 超时租约回收，防重复执行与静默停滞。
要求：macOS 13+（Stage Manager 引入版本），Command Line Tools（xcode-select --install）。
git clone https://github.com/Test2049micro/StageManagerGuard.git
cd StageManagerGuard
./install.sh然后手动完成唯一一步授权（macOS 按二进制授权，只能本人操作）：
系统设置 › 隐私与安全性 › 辅助功能 → 勾选
install.sh结束时打印的那个 python3 路径
未授权时 daemon 会持续报 AppleEvent timed out，功能不生效（但不会做错事）。
若看到 osascript 原始报错（"Not authorized to send Apple events"），daemon 会
把它翻译成同样的指引写进日志，照做即可。
./uninstall.sh- 可靠性：实测 6/6 成功（单次 34–40 秒），但有明确前提。
一组受控实测（交替开关 6 次，逐次核对系统真实状态）：daemon 自报成功 6/6，
实际状态达成 6/6，零偏差。每次耗时 34–40 秒。
更早的开发期曾有累计 34 次
cannot open settings pane失败——差异来自那批测试 与 guard 的 3 秒轮询抢同一批状态文件（harness 缺陷），以及面板冷启动本身需 18–28 秒。待你在自己的多屏环境复测：单屏实测通过不代表多屏触发路径一定顺畅。 - 未经真实多显示器端到端验收。 开发后期外接显示器已物理下线， 「多屏 → 自动关闭」主路径只在打桩（stub screen_count=3）下验证了决策与链路， 真实插拔场景的体验尚未坐实。若你试用，欢迎带日志开 issue。
- 点击过程中会短暂弹出系统设置窗口（空闲 2 分钟后自动关闭）。
- 如果你在工具点击进行中手动改这个开关：工具按「多屏关 / 单屏恢复成关之前 的值」的契约行事，点击那一轮里的手动改动可能被本轮覆盖；一轮结束之后的 手动改动工具永远不会碰。
- 单次耗时 34–40 秒的三个来源（均为实测，非估算）：
- 系统设置面板冷启动 ~16 秒（仅当窗口此前被关掉时需要）；
- 每次
osascript调用 ~8–11 秒（AX 建连开销，无法消除）； - 点击后系统偏好值（
GloballyEnabled）约 5 秒才跟上 UI 值。 第 3 条会与第 2 条叠加：第一次读回时偏好值往往还没跟上，于是需要第二轮确认。 读回校验要求 UI 与偏好值一致才算成功，所以慢但不会误报。
- 若 Apple 未来重命名该开关或移动面板，读回校验会失败并保持原状不乱动 （失败方向安全：不会把用户没开的功能打开）。
- 多屏判定以
NSScreen实际在役数为准；镜像模式下两屏计为两屏。 - 非英文系统：系统设置里的开关名与面板标题随语言本地化（如简体中文「台前调度」
「桌面与程序坞」）。已内置中/英候选名匹配（中文值取自 Apple 官方 loctable），
但中文系统未经实机验证；其它语言需自行往
TOGGLE_CANDIDATES/WINDOW_CANDIDATES补译名（可直接从DesktopSettings.appex/Contents/Resources/Localizable.loctable取）。
# 1) 两个任务都在
launchctl print gui/$(id -u)/com.local.stage-manager-guard | grep -E 'state|last exit'
launchctl print gui/$(id -u)/com.local.stage-manager-daemon | grep -E 'state'
# 2) 探测与决策正常
python3 src/stage_manager_guard.py --probe
# 输出如 {"screens": 2, "pref_enabled": true, "closed_by_script": false}
# 3) 日志（代码自写、自动轮转，上限约 2MB×2）
# ~/Library/Application Support/StageManagerGuard/guard.log
# ~/Library/Application Support/StageManagerGuard/daemon.log常见故障：
| 症状 | 原因 | 处置 |
|---|---|---|
daemon.log 反复 AppleEvent timed out |
未给辅助功能权限 | 系统设置 › 隐私与安全性 › 辅助功能，勾选 install.sh 打印的 python3 |
daemon.log 反复 cannot open settings pane |
AX 树间歇性惰性 | 会自动重试；若持续数小时，重启 daemon：launchctl kickstart -k gui/$(id -u)/com.local.stage-manager-daemon |
| 崩溃但 launchd 日志为空 | plist 的 stdout 指向 /dev/null | 崩溃 traceback 会写进 guard.log（FATAL: 开头） |
| 显示器变了但没动作 | guard 探测失败会拒绝猜测 | 看 guard.log 是否有 ABORT；确认 ./bin/DisplayProbe screens 能跑通 |
make build # 编译 DisplayProbe（macOS 自带 swiftc）
make test # 跑回归测试（无第三方依赖）MIT