ChatGPT macOS「无法添加智能快照」的解决记录

最近 ChatGPT macOS 的智能快照突然不能用了。

不管截 Finder 、Edge 还是其他软件，按下快捷键后都会卡一会儿，然后提示：

无法添加智能快照
Unable to attach appshot

一开始我以为是权限问题，把“屏幕与系统音频录制”“辅助功能”“完全磁盘访问权限”都检查了一遍，ChatGPT 和 Codex Computer Use 也都有权限，但没有用。

重新启动、重新授权、换目标软件也都一样。

网上能搜到的线索很少，最后在 GitHub 找到了两个相关 Issue：

我又检查了本机日志：

~/Library/Logs/com.openai.codex/

发现每次失败都会出现：

captureNotFound
update_poll_failed
hadAxText=false
hadScreenshot=false

简单说就是：截图任务启动成功了，但 ChatGPT 随后查询结果时，却找不到刚刚创建的任务。

最后找到的原因

#25269 下面有位用户提到，他的 ~/.codex 是一个符号链接。把它改回真实目录，并清理旧的 Computer Use 注册后，智能快照就恢复了。

我检查了一下自己的电脑：

test -L "$HOME/.codex" && echo "是符号链接"
readlink "$HOME/.codex"

结果发现我的 ~/.codex 确实也被链接到了其他位置。

看来 ChatGPT/Computer Use 在处理符号链接时，可能把同一个助手识别成了两个不同路径。截图任务由一个实例创建，查询结果时却找到了另一个实例，于是就报 captureNotFound。

这只是根据修复前后的现象作出的推测，不是官方结论。

因为操作时需要完全退出 ChatGPT ，为了避免正在进行的任务中断，我让另一个本地 Agent 帮我执行了下面这些步骤：

~/.codex/computer-use/Codex Computer Use.app

macOS 的注册工具位于：

LSREGISTER="/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister"

注销旧路径：

"$LSREGISTER" -u "/旧路径/.codex/computer-use/Codex Computer Use.app"

注册新路径：

"$LSREGISTER" -f \
  "$HOME/.codex/computer-use/Codex Computer Use.app"

整个过程中最重要的是先备份，不要直接删除原目录。原来符号链接指向的位置也先保留，确认运行稳定以后再考虑清理。

重新启动 ChatGPT 后，我连续测试了三次智能快照，全部成功。

日志也从原来的：

captureNotFound
update_poll_failed
hadAxText=false
hadScreenshot=false

变成了：

failureReason=undefined
hadAxText=true
hadScreenshot=true
status=success

截图和窗口文字都能正常添加到对话里。

如果你也遇到“无法添加智能快照 / Unable to attach appshot”，可以先确认两件事：

test -L "$HOME/.codex"

以及日志里是否同时存在：

captureNotFound
update_poll_failed

只有 ~/.codex 是符号链接，并且日志特征相同，才建议尝试这个方法。

如果日志显示的是 Computer Use 崩溃、动态库缺失或者权限错误，那应该是另一类问题。

我也把这次成功修复的结果补充到了 GitHub：

原始解决线索来自这里：

希望能让以后搜索“无法添加智能快照”或者“Unable to attach appshot”的人少绕一点弯路。