Codex 智能快照无法附加：无头浏览器进程冲突排查

Codex 点击“附加智能快照”后立即失败。系统权限没有问题，真正的原因是窗口捕获服务 选中了一个没有可见窗口的无头浏览器进程。

先区分快照类型

Codex 里有两条不同的捕获链路：

• 网页 DOM 快照读取标签页结构，依赖浏览器连接。
• 智能快照捕获 macOS 窗口和辅助功能文本。

当时网页 DOM 可以正常读取，但智能快照仍然失败。验证 DOM 快照，不能证明窗口捕获正常。

为什么不是权限问题

使用同一个窗口捕获接口测试系统文件管理器，截图和辅助功能文本都能返回； 测试 Chrome 时却持续超时。这说明系统授权和捕获服务正常，问题只出在浏览器目标。

进程清单显示，系统里同时存在一个正常 Chrome 和多组遗留的无头 Chrome。 这些后台实例带有 --headless 或 --no-startup-window 参数，没有可捕获的窗口。

安全清理

先用只读命令检查进程：

ps -axo pid,ppid,etime,command | rg 'Chrome|Playwright|headless'

只处理同时满足这些条件的实例：

• 启动参数明确显示无头模式。
• 对应自动化任务已经结束。
• 没有可见窗口。
• 父子进程关系已确认，不会影响正常 Chrome。

清理遗留进程即可，不需要删除浏览器配置、退出正常账号或重置系统权限。

验证结果

清理后，正常 Chrome 保持运行，遗留无头进程归零。使用原来的智能快照入口复测， 截图和辅助功能文本均正常返回，超时错误消失。

文中已删除真实进程号、任务名、用户目录、日志路径、标签页内容和精确时间。