故障排查

授权了权限，但还是不能采集

如果重启后仍然不行，检查 StepShot 是否被拖进了「应用程序」文件夹。从 DMG 里直接运行的副本每次打开都是一个新位置，系统会把它当成另一个应用，权限也就跟着失效。

截图拍到的是点击之后的画面

正常情况下不会——截图取自点击前一刻的缓存画面。如果出现了，通常是实时取帧通道没能建立，软件退回到了较慢的即时截图方式。重启应用一般能恢复；持续出现请把 macOS 版本告诉我们。

热键按了没反应

多半是别的应用先占了这个组合。系统不允许任何程序查看其他程序注册了哪些热键，所以只能在注册时发现——启动时会提示，设置里对应那一行也会标出来。换一个组合即可。详见快捷键。

提示磁盘空间不足，无法开始

开始前会按一小时录制的用量估算所需空间。提示里会写明可用、预计和所需三个数字。清理磁盘，或在设置里把项目位置换到空间更充裕的卷。

如果存储位置在移动硬盘或网络卷上、系统无法报告容量，软件会放行并记录一条日志——在这种情况下误拦截比带着警告开始更糟。

采集中途崩溃或强制退出了

项目是完整的。每记录一步就重写一次清单，所以磁盘上的内容一直读得出来，最多丢掉最后一步。

下次打开时，项目库会把这份没有正常结束的草稿标出来，你可以直接打开继续编辑，或者把它标记为已完成。软件不会替你修复——一份被打断的教程该怎么处理是作者的判断。

屏幕录制的视频同样可以恢复，最多损失末尾几秒。

步骤标题很奇怪，或者只有「点击」两个字

标题来自辅助功能读到的控件信息。有些应用（尤其是自绘界面的）提供的信息很少，这时只能给出较弱的描述。确认辅助功能权限已授予会有帮助，但有些应用确实提供不了更多——直接改标题即可，改过之后它就属于你。

导出的 PDF 里有一步被切开了

不应该发生——每个内容块在绘制前都会先量高度，放不下就整体挪到下一页。如果你遇到了，请把那份项目的排版设置告诉我们。

导出的文档里语言是混的

这是有意的。步骤标题是采集当时写下的数据，属于作者的文本，切换界面语言不会改写它们；而「共 N 步」、页脚这类导出时生成的内容会跟随当前界面语言。用一种语言采集、用另一种语言导出，得到的就是混合结果——这比假装翻译了更诚实。

还是没解决

写信到 support@stepshot.app，附上 macOS 版本和 StepShot 的版本号（在设置窗口底部）。