如何用截图制作客户支持指南

本指南会把一张已解决的支持工单整理成可复用的可视化文档。你将选择一个问题，明确指南适用条件，在安全环境中复现解决过程，截取关键步骤，补充升级处理条件，再请不了解工单背景的人测试成稿。

简而言之： 支持指南应帮助客户确认自己遇到的问题、完成一条经过验证的解决路径、检查是否成功，并在问题仍未解决时知道需要提供什么。

选择一个已解决的客户问题

最适合先写的是反复出现、解决办法已经验证的问题。查看近期工单，找出支持人员总是用相同方式回答，而且客户无需针对账户的人工干预就能解决的问题。

一份指南只对应一个结果。“允许 macOS 屏幕录制权限”范围明确；“修复 Shotomatic 权限”则可能混合屏幕录制、辅助功能、文件访问和操作系统限制，需要分别检查。

不要把尚未确认的临时办法写成正式文档。投入时间截图并作为标准做法发布前，应先在当前产品版本中验证解决方案。

明确指南适用条件

开头应帮助客户判断是否找对了指南。写清可见症状、受影响的产品区域、相关平台，以及会改变处理路径的账户或权限状态。

可以使用简短的适用条件块：

在以下情况下使用本指南：
- 客户看到[具体症状]。
- 客户正在使用[平台或产品区域]。
- [必要条件]成立。

在以下情况下使用其他指南：
- 客户看到[相似但不同的症状]。
- 问题需要管理员或支持人员处理。

这段简短说明能避免客户把正确步骤用在错误问题上。

用测试数据复现解决过程

安全的测试账户既能保护客户信息，也能让截图反复使用。用样本姓名和样本文件还原客户的起始状态，并关闭通知。

正式截图前先完整走一遍解决流程。记录客户必须完成的前置条件，例如登录、打开特定工作区，或请管理员授予访问权限。

如果解决过程会修改数据或权限，测试时还要准备恢复方案。不要为了反复还原状态而一直使用真实客户账户。

截取判断点和检查点

支持截图应在客户容易卡住的位置减少不确定性。截取难找的控件、必须选择的数值、分支条件、重要警告和最终确认状态。

不帮助客户判断或确认的画面可以省略。每次界面切换都放一张截图，只会让指南更难浏览，不一定能让解决过程更稳妥。

Action Capture 可以在你点击操作时记录经过验证的路径。完成后检查序列，删掉无关点击，每个判断或必要操作只保留一个页面。完整捕捉流程见如何在 Mac 上根据点击制作分步指南。

围绕客户下一步操作编写每个步骤

每一步都应写明操作、控件或数值，以及表示可以继续的结果。先写指令，再补充背景，让客户边操作边快速浏览页面。

例如：

打开 System Settings > Privacy & Security > Screen & System Audio Recording，然后启用 Shotomatic。macOS 要求重新打开应用时，选择 Quit & Reopen。

除非客户能在界面中看到同一个词，否则不要使用内部术语。如果支持团队称某项内容为“capture entitlement”，而界面显示的是“Screen Recording”，就使用界面标签。

添加明确的成功检查

成功检查能把流程闭环。告诉客户现在应看到什么、哪个操作应当可用，或哪个文件应当已经生成。

检查结果必须能观察。“问题应该已经修复”无法帮助客户判断；“返回 Shotomatic，确认窗口预览已经出现”则给出了具体结果。

如果结果需要等待，写明等待时间和表示仍在进行的状态。不要因为没有解释系统延迟，让客户重新做一遍整份指南。

添加升级处理条件和所需证据

标准路径失败时，明确的升级处理信息可以减少来回追问。写清何时停止、收集什么，以及发送到哪里。

可以使用简短的转交清单：

• 结果第一次出现差异的步骤；
• 该画面的截图；
• 完整错误消息；
• 应用和 macOS 版本；
• 相关权限或账户状态；
• 问题是否每次都会出现；
• 已尝试的步骤。

附加证据前，删除或模糊私密信息。如果结果是工程缺陷，应整理成结构化缺陷报告，不要让客户自行判断原因。

请不了解背景的人测试指南

不了解背景的读者能发现原支持人员凭记忆补上的上下文。把指南交给没看过工单的人，请对方从写明的起始条件开始操作。

当读者能判断指南是否适用、无需额外解释即可完成解决流程、确认最终状态，并在失败时收集正确证据，指南才算完成。记录产品版本和指南负责人，界面变化后支持团队就知道该由谁复查。

需要从点击中收集支持流程并编辑成有序指南时，可使用 Action Capture。如果结果需要交给工程团队复现，而不是让客户自行解决，请参阅如何在 Mac 上用分步截图记录软件缺陷。