用途:以截图方式验证 macOS 应用的一个窗口、表单或界面状态,适合选择或改进确定性的快照自动化路径,将预期 UI 状态与捕获图像比对,解释视觉漂移并决定修复层级。
主要能力:强调“先声明预期再截图”,每次运行只验证一个目标状态;优先使用项目已有的确定性捕获路径(应用内/进程内渲染、内置 UI 测试框架、混合应用的浏览器驱动,最后才用 Accessibility 或窗口截图);先记录影响判读的布局事实;区分确定性结构与数据相关变化;结果按 Matches、Drift、Better than expected 三类报告;修复最窄的正确层级后重跑同一目标。
使用方式:先在项目中查找已有截图或 UI 测试入口,选好捕获路径并说明理由;写出 3-7 条预期要点;运行一次命令或测试入口捕获目标状态并保存绝对路径;对照预期分三类报告结果;根据情况修复自动化、应用或预期,再重跑,直到干净通过或三次迭代后记录残余风险。
适用场景:验证 macOS 窗口/表单/界面的截图、改进快照自动化、比对预期与实际图像、解释视觉漂移。
限制:不适用于设计或构建 UI 本身,不适用于驱动真实浏览器(应改用 run-playwright 或 run-agent-browser),也不适用于用调试器诊断运行时内部。避免从截图反推预期、一次批量验证多个不相关流程、默认先用 Accessibility 脚本、把不稳定数据硬编码进预期,或仅返回“看起来没问题/有问题”。参考文件包括 references/expectation-loop.md、drift-analysis.md、capture-modes.md、troubleshooting.md。