故障排查

适用于 Pinlume 1.0.9

遇到问题时先确认 Pinlume 版本、macOS 版本、是否多显示器，以及问题能否稳定复现。不要一开始就删除应用数据或关闭系统安全机制。

截图是黑屏或没有画面

在“系统设置 → 隐私与安全性 → 屏幕与系统音频录制”确认 Pinlume 已启用，然后完全退出并重新打开。正式版和调试版是不同身份，需要分别授权。仍失败时重启 Mac，再测试单显示器捕获。

快捷键没有响应

打开“设置 → 快捷键”，查看组合是否被清除或注册失败。更换为未被 macOS、输入法或其他截图工具占用的组合。功能键可能受键盘的媒体键设置影响，需要同时按 Fn。

保存失败

重新选择保存目录，确认目录仍存在、磁盘空间充足并且文件名模板没有非法字符。外接磁盘、网络盘或云同步目录断开后，旧的目录授权可能失效。

滚动截图错位

缩小选区并排除固定导航、悬浮按钮、视频和动画；降低滚动速度，保持单一方向。超长内容建议分段捕获。

录屏卡顿或文件过大

降低帧率和质量，关闭不需要的摄像头、按键提示或高负载应用。确认保存盘速度与剩余空间。部署官网或更换服务器不会改善本机录制性能。

上传或翻译失败

检查网络、系统时间、provider 凭据和权限。S3 还需核对 endpoint、region 与 bucket。反馈时只提供错误码和步骤，不要公开密钥或正文。