让每一次捕捉都顺利完成。
从首次授权到日常使用，这里整理了维维截图的常用操作、权限说明与排查方向。
快速入门
维维截图以菜单栏工具形式运行。打开应用后，从菜单栏选择需要的操作，或使用已设定的全局快捷键。
使用默认快捷键 Command + Shift + A，或从菜单栏选择“区域截图”。冻结画面后，悬停可选取窗口，也可拖动选区。
浮动工具栏提供移动、标注、OCR、保存、完成和取消。按 Esc 可以取消当前截图流程。
使用默认快捷键 Command + Shift + R，选择区域后进入待机状态，再从工具栏开始录制。录制中再次使用该快捷键可停止并保存。
系统权限
权限由 macOS 管理。维维截图只在对应功能开始前检查所需授权，并在屏幕录制权限缺失时引导你打开正确的系统设置页面。
屏幕与系统音频录制
截图、视频录制和系统音频内录需要此权限。在“系统设置 › 隐私与安全性 › 屏幕与系统音频录制”中允许维维截图后，再重试操作。
麦克风
只有在录制时选择麦克风音轨，系统才会请求麦克风权限。若拒绝，视频与其他可用音频源仍可继续录制。
用户选择的文件夹
启用自动保存时，请在设置中选择一个文件夹。应用通过 macOS 的安全作用域授权访问该位置。
使用设置中配置的组合键打开快捷历史。点击缩略图或复制按钮会将图片写入剪贴板并关闭面板；请在目标应用中自行粘贴。
常见问题
支持哪些 macOS 版本？
维维截图需要 macOS 14.0 或更高版本。OCR 可在 macOS 14 上使用。设备端多语言翻译和录屏鼠标点击效果需要 macOS 15 或更高版本。
为什么无法开始截图或录制？
请先检查“屏幕与系统音频录制”权限。若授权状态刚变更，退出并重新打开应用后再次尝试，通常可让系统状态生效。
OCR 翻译为什么不可用？
设备端多语言翻译仅面向 macOS 15 及以上系统。macOS 会自动识别原文，并翻译为你在设置中选择的目标语言。首次使用时，macOS 可能提示确认下载语言模型；安装完成后可在离线状态下使用。
截图历史保存在哪里？
截图历史保存在应用沙盒的 Application Support/QuickShot/History 目录中。关闭历史功能不会删除已有文件；你可在历史窗口中手动清空，也可通过设置自动清理。
如何使用快捷历史？
使用设置中配置的全局组合键，默认是 Command + Option + Shift + H。点击缩略图会复制图片到剪贴板并关闭面板；请在目标应用中自行粘贴。
视频可以导出为哪些格式？
视频录制支持 MP4 与 MOV 输出，使用 H.264 编码。可在录制工具栏或设置中调整帧率、格式、系统音频和麦克风选项。
故障排查
先做这三步
- 确认 macOS 版本符合功能要求。
- 检查对应权限是否已授予，并在变更权限后重启应用。
- 确认没有其他截图或录屏流程仍在进行，随后再开始一次新的操作。
快捷键没有响应
截图、录屏和快捷历史快捷键都可以在应用设置中修改。请检查当前组合键是否与其他应用或系统快捷键冲突。
自动保存没有写入文件
在设置中重新选择保存文件夹，并确认该位置可用。自动保存依赖你在 macOS 文件选择器中授予的文件夹访问权限。
粘贴的图片不对
快捷历史只会复制所选图片到剪贴板。请确认在目标应用中执行粘贴操作，并检查剪贴板是否被其他应用覆盖。
准备诊断信息
如果问题仍未解决，联系技术支持时请附上以下非敏感信息，便于复现和定位：
- macOS 版本与维维截图版本。
- 问题发生前执行的步骤，以及是否每次都能复现。
- 相关权限的当前状态。
- 若有提示，记录完整错误文案。
不要发送包含私人信息的截图、录屏、OCR 文本、保存文件路径或完整系统日志。若需要示例，请先自行打码或使用无敏感信息的复现素材。