向 AI 提供报错信息：什么时候发截图，什么时候提取文字

在 Mac 上向 AI 询问报错时，能复制的消息优先直接提供文字。如果文字在图片里，或对话框不允许选中，可以用 OCR 提取。问题涉及界面布局和显示效果时，再附上截图，不必把每一种报错都变成图片。

先判断问题需要哪些证据

构建失败和按钮位置不对，需要的说明并不相同：

• 文字： 错误消息、调用栈、命令和配置值，需要保留准确字符，以及有用的换行和前后输出。
• 截图： 面板被裁切、颜色异常、控件重叠，或问题与位置有关。选区需要包含足够的界面，才能看清元素之间的关系。
• 两者一起： 界面明显异常，同时对话框里还有重要错误码。图片交代现场，核对过的文字提供准确消息。

如果终端或编辑器已经允许复制输出，就直接复制。对截图做 OCR 会多一道转录过程，可能改变标点、缩进，或混淆 0 和 O 等字符。

用 Frset 提取无法选中的报错

比如应用弹出了一个无法选中文字的错误对话框。可以使用 Frset 的截图工具：

1. 从菜单栏或你设置的快捷键启动截图。
2. 选中错误消息，并保留理解问题所需的邻近标签。
3. 在截图工具栏中选择提取文字。
4. 对照原图检查 OCR 结果，尤其注意错误码、路径和标点。
5. 更正识别错误，复制相关文字。
6. 粘贴到 AI 对话中，并补充触发报错的操作。

Frset 支持 macOS 13 或更高版本。屏幕捕捉需要相应的 macOS 屏幕录制权限；OCR 使用 Apple 的本地文字识别能力，不需要 AI API 密钥。如果图片已经在 Frset 的剪贴板历史记录中，也可以直接使用其中的提取文字，不必重新截图。

对于已经保存的图片，在系统和语言支持的情况下，也可以尝试 Apple 预览中的实况文本。基础步骤见图片文字提取指南。

补上错误消息没有交代的上下文

单独一条报错通常无法说明全貌。例如，先交代更新依赖后构建失败，再提供运行的命令、输出和相关配置。不要因为手头有整份日志，就把无关部分全部粘贴进去。

发送前补充这些信息：

• 原本想完成什么，实际发生了什么。
• 与问题有关的应用、运行环境或依赖版本。
• 准确的报错，以及有助于判断原因的前后输出。
• 最近改过什么，已经尝试过哪些方法。

在多个应用间收集信息时，Frset 的剪贴板历史记录可以帮助你按内容、标题或别名找回之前复制的片段。粘贴时给每段加上说明，区分命令、输出和配置。多选文字会以换行拼接；发送前要检查拼接后的完整消息。

不把节省 token 写成固定倍数

将满屏文字截图换成简短、准确的报错摘录，可能减少一次提问所需的输入，但不能保证固定的节省比例，也不能保证回答完全相同。图片处理和计费取决于服务、模型和图片尺寸；Anthropic 在其视觉输入文档中说明了这些因素。

不要为了缩短输入而丢掉必要的视觉证据。如果问题是按钮为什么被挡住，识别出按钮文字并不能展示重叠的面板。保留截图，再补充需要准确字符的文字。

检查即将分享的内容

从准备发送的消息中移除密钥、私有链接，以及无关的个人或客户信息。文字和图片都要检查。本地 OCR 不代表后续上传也在本地：将截图或提取结果发送给在线 AI，仍会把这些内容交给所选服务。

核对解释前，保留原始截图或日志。如果 AI 建议运行命令，先确认命令用途和操作对象，再执行。对于之后还会用到的片段，可以继续阅读如何保存和复用复制过的代码与命令。