跳至内容

截图教程检查清单:截取、编辑、审阅与导出

使用此截图教程检查清单规划任务、截取清晰的步骤、保护隐私数据、测试教程并验证最终导出文件。

8 分钟阅读工作流程作者:Temposhot Team

截图教程会在一些小地方出错:漏掉一个步骤、标签已变更、侧边栏里残留了姓名、PDF 中的文字太小。检查清单可以在读者发现这些问题之前把它们找出来。

将下面的列表复制到自己的模板中。每一项都是可以判定通过或未通过的检查。若某项由 Temposhot 的功能覆盖,其准确名称以粗体标出。检查项按工作顺序排列:规划、准备屏幕、截取、撰写、标注、删除隐私数据、由读者测试,最后导出。下图显示了该顺序。

八个方框组成的流程图,从规划任务到导出最终文件,中间依次经过屏幕准备、截取、撰写、标注、隐私审查和新读者测试。

范围与规划

  • 教程只涵盖一项任务,并有一个明确的结果。
  • 结果用一句话写出,并用作标题。
  • 写明读者对象:客户、新员工、客户端或同事。
  • 列出前提条件:账户类型、权限和需要提前准备的内容。
  • 注明教程对应的产品版本。
  • 指定负责人,负责后续更新。

任务超过约 15 个步骤时,拆分为两篇教程并相互链接。

一项任务,一个结果

只有一个结果,步骤才能保持有序。“向工作区邀请团队成员”只有一个结果:成员收到邀请邮件。“设置团队”则是三项任务共用一个标题。读者无法判断教程何时结束,因此该项检查不通过。

草稿中有两个结果时,在第一个结果出现的位置拆分。第一篇教程以该结果结束,第二篇从该结果开始。每一部分都有各自的标题、屏幕准备和测试运行。

写明读者对象与起始状态

读者对象决定详细程度。新员工需要知道每个菜单的位置。每天使用该产品的同事只需要控件的名称和要输入的值。同时写明起始状态。“你已以工作区管理员身份登录,且团队页面已打开”这样的说明,可以消除读者对第一步该做什么的大部分疑问。

为每个部分规划时间

录制前先规划时间。下面的时间预算针对由一人录制和审阅的 12 步教程。它显示了时间花在哪里,以及容易被跳过的部分。

12 步教程的 75 分钟时间预算时间线:15 分钟用于预演和屏幕准备,10 分钟用于截取,20 分钟用于撰写,10 分钟用于隐私审查,15 分钟用于读者测试,5 分钟用于导出。

在此预算中,审阅阶段占用的时间多于截取阶段。多数教程超时发生在审阅阶段,而不是录制阶段,因此应先规划审阅时间。

屏幕准备

  • 已登录一个带有示例数据的测试账户。
  • 已关闭邮件、聊天、日历和密码管理器窗口。
  • 已开启 macOS 专注模式,不会出现通知横幅。
  • 应用窗口为固定尺寸,与同一套件中的前几篇教程相同。
  • 主题和界面语言与套件中的其他教程一致。
  • 起始屏幕为读者开始时所在的屏幕。
  • 已在不录制的情况下预演一次任务。

使用示例账户和干净的数据

使用姓名、邮箱和数据均为虚构的测试账户。表格行中出现真实客户姓名是教程中最常见的隐私错误,而且截取之后很难去除。在示例账户中填入三到五行数据,使界面看起来经过实际使用,同时不包含任何真实记录。

不录制,先预演一次

预演可以找出点击后会发生变化的步骤,例如确认对话框、加载状态或悬停时打开的菜单。把每一处都记下来。下面的预演顺序将这些记录转换为录制顺序。

录制教程前的五个编号步骤:不录制地完整运行一次任务,记录每个对话框、等待状态和悬停菜单,将窗口设置为固定尺寸,使用 Action Capture 录制一次完整运行,并在编辑器中删除多余的页面。

保持窗口尺寸固定

固定的窗口尺寸使每一页的裁剪保持一致。设置一次尺寸,将其写入教程模板,并在每次运行前检查。如果某篇教程的窗口比下一篇宽 200 像素,控件会在页面之间移动,读者需要重新寻找。同一套件中的所有教程都使用相同的尺寸,即使屏幕内容不同。

截取

  • Action Capture 已打开(Command+3)。
  • Parse clicked elements 已开启,因此标题以 Click "[[element-name]]" 开始。
  • 在 Visual Annotations 下设置 Show cursor on click captures 和 Mark clicked area。
  • Choose Capture Target 中的目标与任务相符:单个应用使用 Specific Window,多个应用使用 Active Window,固定区域使用 Capture Area,仅在必要时使用 Full Screen。
  • 无需点击即会出现的屏幕,可使用 Shift+Command+2 或 Capture now 保存。
  • 在任何私人屏幕出现之前使用 Pause capture。
  • 通过 Finish capture 结束运行,文档随即在编辑器中打开。

Action Capture 指南说明了每项设置。

示例运行使用的设置

下表的设置与上述检查项一致。设置保存在 Mac 上,并在之后的运行中复用,因此每套教程只需设置一次。

教程运行的设置面板各行:捕获每次鼠标点击,开启解析点击元素的标题,在点击截图上显示光标标记,矩形点击标记,默认的手动截取快捷键,以及截图中不包含工具栏。

仅当浮动工具栏本身是报告的一部分(例如错误报告)时,才开启 Include toolbar in captures。对于教程,步骤中的工具栏会分散读者的注意力。

按任务选择截取目标

截取目标决定每个保存的步骤包含的内容。下表列出了每类任务通常的选择。

四种 Action Capture 目标的比较表,列出每个目标适合的任务类型及简短示例:Specific Window、Active Window、Capture Area 和 Full Screen。

Active Window 在步骤之间切换,适合在多个应用之间移动的任务。其他三个目标在整个运行过程中保持相同的取景框,因此截取期间移动的窗口可能会切掉某个控件。任务只在一个应用中进行时,选择 Specific Window,可以避免这种截断。

私人内容前暂停,并使用 Capture now

Pause capture 会停止接收点击,但保持运行处于打开状态。在包含私人数据的屏幕出现前使用它,屏幕关闭后再恢复。暂停期间的点击不会保存为步骤,因此私人屏幕上的误点击不会进入文档。

有些屏幕没有点击操作。状态消息、已完成的进度条或结果页面都是读者需要看到的屏幕。选择 Capture now 或按下手动截取快捷键,即可将该屏幕保存为无需点击的步骤。

Action Capture 运行所用三个快捷键的表格:Command+3 打开 Action Capture,Shift+Command+2 保存无需点击的步骤,Command+period 结束运行并打开文档。

规划免费版的步骤上限

免费方案对每次 Action Capture 运行设有步骤上限,Temposhot Pro 可取消该限制。上限为 5 个步骤。运行达到上限时,录制暂停,已保存的步骤在 Finish capture 之后仍保留在文档中。12 步教程只有使用 Pro 才能在一次运行中完成。免费版应将其录制为三次运行,每次 4 个步骤。每次运行结束后,从 Add Pages 菜单中选择 Capture new images…,即可将下一次运行添加到同一文档中。

不应计入的点击

Temposhot 会忽略彼此间隔过近的点击,因此一次操作不会产生重复步骤。先打开菜单再选择某一项的点击,仍会产生两个步骤:一个对应菜单,一个对应菜单项。如果菜单步骤没有提供有效信息,请在编辑器中将其删除。

Mouse click capture 设置决定哪些点击会被计入。Capture only while a key is held 仅在按住所选按键时记录点击,因此设置屏幕时产生的点击不会成为步骤。Skip clicks while a key is held 则与之相反。

顺序与撰写

  • 每页对应一个操作。删除由误点击产生的页面。
  • 缺失的屏幕通过 Add Pages 菜单中的 Capture new images… 添加。
  • 每个 Page title 以动词开头,并写明确切的控件。
  • 界面标签的拼写和大小写与界面保持一致。
  • 每页描述包含数值、条件和结果,共一至三句。
  • 决策点单独成页,并写明所选的选项。
  • 最后一页展示读者应看到的结果。
  • 附一条简短的“如果未成功”说明,指明获取帮助的途径。

这些条目背后的撰写规则,参见如何撰写分步软件说明。

清理检查的数字

示例运行截取了 12 个步骤。其中两个是在工具提示和悬停菜单上产生的误点击,编辑器将其删除。缺少一个步骤,即一条没有点击的成功消息,因此使用 Capture now 将其添加。最后一页是结果屏幕,因此最终教程共 11 页。

示例教程的四组数字:示例运行中截取 12 个步骤,删除 2 个误点击页面,使用 Capture now 添加 1 个屏幕,最终教程共 11 页。

标题要写明控件

解析生成的标题如 Click "Invite" 是正确的,但信息不足。读者需要的是操作和位置。在示例中,标题改为“在顶部栏中选择 Invite”,描述中补充了需要输入的值。标题只写操作本身,细节放入描述。

决策页

依赖选择的步骤需要单独成页,使读者能看到选项及其结果。例如,一篇教程要求读者选择套餐,则需要分别为“选择 Team”和“选择 Business”各建一页,每页标题都写明所选的选项。如果把两个选项都放在同一页的描述中,读者需要自行查找适用的选项,而截图只会显示其中一种结果。

图片与标注

  • 每页使用 Framing(F)裁剪:Action Capture 页面使用 Focus on action,其他页面使用 Custom。
  • 每页只有一个主要标记,指向目标。
  • 整篇教程中,标记使用同一种强调色和同一粗细。
  • 文字标签放在目标旁边,而不是覆盖在目标上。
  • Step Numbers(N,Pro)仅在一页展示一系列步骤时使用。
  • 目标周围的上下文应足以让读者在真实屏幕上找到它。

标注与取景指南介绍了每种工具。

Action Capture 页面的取景

Action Capture 记录每次点击的位置,因此 Focus on action 可以围绕该位置对每页进行缩放。取景共五级,从 1(Wide)到 5(Tight)。级别 3(Balanced)适用于大多数教程页面,因为它能保留点击所打开的菜单。当自动裁剪切掉读者需要的控件时,使用 Adjust framing…。

一个标记,一种颜色

一页上有三个箭头和两个方框,会让读者需要自行判断正确的目标。当标题写明了控件名称时,每页一个箭头或一个轮廓就足够。整篇教程使用同一种强调色标记所有内容,使读者知道该颜色表示目标。

隐私与安全

  • 不保留任何真实姓名、邮箱、账号或照片。
  • 即使经过模糊处理,也不保留任何密码、令牌或恢复码。
  • 检查地址栏和文件路径中是否包含用户名或令牌。
  • Blur(B,Pro)应完全覆盖每个残留的敏感字段。
  • 仅分享导出文件。文档和 Capture History 中保存的是未经处理的原始图片。

检查地址栏和文件路径

地址栏和文件对话框中常包含页面正文不可见的用户名或令牌。确认每个步骤之前,应阅读每个浏览器屏幕的顶部和每个保存对话框。像 /Users/ 后跟真实用户名这样的路径,即使页面其余部分已清理干净,也属于泄露。

完整模糊,并以导出尺寸检查

Blur strength 的范围为 2 至 80,默认值为 12。将数值调高,直到被覆盖的字段在读者所见的尺寸下不显示任何可辨认的字符,然后检查导出的页面。部分覆盖的字段仍可能显示姓名的首尾字母。

教程截图隐私规则的 do 和 dont 表格:使用示例账户、完整覆盖字段、检查地址栏,以及仅分享文档导出文件。

原始图片的存放位置

文档和 Capture History 保存的是未经处理的原始图片。编辑器在其上叠加取景和模糊,因此从文档中删除标记并不会删除源画面中的数据。应将保存文档和 Capture History 的 Mac 视为私人数据仍然存在的位置。限制该 Mac 用户账户的访问权限,仅分享导出的文件。

新读者测试

  • 由未编写该教程的人员在测试账户上按步骤操作。
  • 对方在不提问的情况下完成任务。
  • 记录并修正每一处犹豫。
  • 对方达到的结果与最后一页一致。

测试人员提出一个问题,就重写该页。如果提出多个问题,则检查该教程是否涵盖了两项任务。

设置测试

只向测试人员提供导出的 PDF 和测试账户,不提供其他信息。开始前不要说明任务或结果。在旁边观察但不发言,记录每次犹豫、每次误点击和每个问题所在的页码。

新读者测试的五项记录清单:开始时间,每次犹豫所在的页码,误点击,测试人员提出的问题,以及测试人员停止或完成时所在的页码。

确定修正内容

在标题清晰的页面上出现犹豫,通常表示截图缺少该控件。发生误点击,通常表示标题所写的控件与屏幕不符。修正页面并重新导出。若第一轮测试发现的问题超过三个,则将新文件发给同一位测试人员进行第二轮测试。

导出与交付

  • 格式与目标位置相符:
目标位置导出方式
邮件、打印、离线阅读Export PDF
帮助中心或 wikiPNG 或 WebP 页面
幻灯片PNG 页面
归档或脚本导入包含 document.json 的 ZIP 包
  • PDF 选项已设置(Pro):封面、步骤编号、页码,以及描述位于截图之前或之后。
  • 按所选纸张尺寸逐页检查实时预览。

按纸张尺寸检查 PDF

导出对话框中的预览会以所选纸张尺寸显示页面,因此导出前应逐页检查。注意是否有标题换行并把截图向下推,以及截图是否在底边被裁切。宽幅应用窗口选择横向,高窗口选择纵向,并对整篇教程使用相同的方向。导出对话框的设置适用于文件的每一页,因此无法只修正单页的方向。

  • 文件名包含任务和日期,例如 invite-teammate-2026-10.pdf。
  • 共享云盘和文章中的旧副本会被替换。
  • 记录负责人和已验证的版本。

Temposhot 将文档保存在 Mac 本地,不提供托管分享功能,因此这些文件即为交付物。导出指南列出了所有格式。

按目标位置选择格式

一篇教程通常会发送到多个位置,同一份文档可以生成所有格式。例如,邀请教程发送到三个位置:用于入职邮件的 PDF、用于帮助中心的 PNG 页面,以及用于团队内容归档的包含 document.json 的 ZIP 包。从同一文档导出每种格式,这样三个文件的页面和标题保持一致。

文件名中包含版本

文件名是读者所持教程版本的唯一标识。文件名应包含任务、日期和版本,例如 invite-teammate-2026-10-v2.pdf。PNG 页面以页面标题命名,因此标题应足够简短,在文件夹列表中能够完整显示。

邀请教程导出文件夹的文件树:一个 PDF 文件,一个以页面标题命名的编号 PNG 页面文件夹,以及旁边的一个 notes.txt 文本文件。

常见问题

教程应包含多少张截图?

每个读者执行的操作一张,外加结果屏幕。大多数单一任务教程有 5 至 15 张。

每次点击都需要截图吗?

包含会改变读者所见内容的点击。跳过只使窗口获得焦点或只关闭工具提示的点击。

何时需要重新运行此检查清单?

每次修改教程之后,以及产品发布改变了教程所展示的屏幕时。参见如何保持截图文档为最新。

短教程可以跳过检查清单吗?

隐私和导出部分每次都需要执行,因为短教程同样可能显示真实姓名或错误的文件名。对于 3 步的任务,规划和截取部分可以缩减。

Temposhot 会自动检查教程吗?

不会。每个检查项都需要手动完成。Temposhot 记录步骤并生成文件,内容、隐私和测试结果由人员确认。

谁应负责教程?

编写该教程的人员,或拥有其所描述屏幕的团队。负责人会在每次产品发布后收到审阅触发通知,并在版本变化时更新教程和文件名。

将点击转换为清晰的分步指南

Action Capture 一次性覆盖本检查清单中的截取部分。下载 Temposhot,并在下一篇教程中执行此检查清单。

checklisttutorialsscreenshotsdocumentation

本文使用的术语: visual documentation

把重复性截图整理为成品

Temposhot 可按定时或每次点击进行截图,并将结果导出为 PDF、图片、ZIP 或 MP4。

相关文章