macshot 教程：从稳定版和最少权限开始
macshot 是原生 macOS 截图和录屏工具，截图、标注、视频编辑、OCR 与滚动捕获都在同一个应用里完成。它需要读取屏幕像素，普通版还可连接多种上传服务，所以首次使用要把系统权限和网络功能分开验证。
1. 安装稳定渠道
brew install --cask macshot
安装后检查应用版本为稳定渠道，并关闭 beta 更新。也可以从官方 Releases 下载 DMG。系统要求是 macOS 12.3 或以上。
2. 第一次只开 Screen Recording
macOS 用 Screen Recording 权限控制截图与录屏。启动后只开启这一项，再用无敏感内容的测试窗口检查区域选择、窗口吸附、标注、复制和本地保存。麦克风用于录音，Input Monitoring 用于点击或按键提示，应在实际需要时单独开启。
3. 检查本地历史
截图和录屏存到用户选择的目录，最近捕获还会进入应用支持目录中的历史记录。设置历史上限，确认删除后文件是否仍在导出目录。自动 PII 遮挡可能漏掉账号、密钥或人脸，分享前要看最终成品。
4. 选择普通版或 Offline
普通版可以把指定文件上传到 Google Drive、imgbb 或 S3 兼容服务，并通过 Sparkle 检查更新。Google Drive OAuth token 以 0600 权限保存在本机，授权范围为应用创建的文件。不需要上传时可选 Offline 变体，它在编译时移除云上传代码，并使用独立的 DMG、bundle 和更新源。
5. 录屏前再增加权限
先录制十秒测试视频，确认系统音频、麦克风、帧率和导出格式。v4.3.0-beta.1 集中修复时间轴、导出、短时录制与历史保存问题，说明测试版仍在处理录屏边缘情况；重要素材应保留原文件。
与 Flameshot 对比
Flameshot 使用 Qt，覆盖 Linux、Windows 和 macOS，重点是跨平台截图、标注与命令行流程。macshot 只支持 macOS，但增加原生录屏、视频编辑、Apple Vision OCR、滚动捕获和 Offline 变体。需要跨平台时看 Flameshot；需要 macOS 原生录屏与编辑时评估 macshot。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
适合谁用
适合 macOS 上制作教程截图、录屏、长图和本地 OCR。屏幕权限可读取屏幕内容，历史目录会保留捕获文件；自动 PII 遮挡可能漏检，分享前仍需人工查看最终图像或视频。
原教程未展开的系统信息
核心功能
截图与标注
区域、窗口、多屏和滚动截图可直接进入原生编辑器，使用箭头、文本、形状、遮挡与测量工具。
录屏与视频编辑
支持 MP4/GIF、系统音频、麦克风、点击提示、裁剪、变速和多种视频效果。
本地识别与脱敏
使用 Apple Vision 做 OCR、二维码、人脸和前景处理，并提供 PII 自动遮挡；识别结果仍需人工复核。
技术栈和运行条件
语言
Swift 5、AppKit
框架
ScreenCaptureKit/macOS capture APIs、Apple Vision、AVFoundation、Sparkle
关键依赖
- macOS 12.3 或以上
- Screen Recording 权限
- 录音需要麦克风权限
- 点击提示或按键显示可能需要 Input Monitoring
运行环境
本地保存截图、录屏和历史；Google Drive OAuth、imgbb、S3 上传与 Sparkle 更新是可选网络出口
常见问题
macshot 当前应该安装 v4.2.1 还是 v4.3.0-beta.1？
普通用户应选稳定版 v4.2.1。v4.3.0-beta.1 仍标为预发布，只适合愿意测试并能接受回归风险的用户。
macshot 为什么需要 Screen Recording 权限？
macOS 用该权限控制屏幕像素读取，截图和录屏都需要它。权限可在系统设置中撤销，首次验证不要同时授予其他权限。
macshot 会自动上传截图或收集遥测吗？
官方隐私政策称没有遥测，也不运营存储服务器。上传功能需要用户选择，文件会直接发送到 Google Drive、imgbb 或所配 S3 服务。
macshot Offline 与普通版有什么区别？
Offline 变体在编译时移除上传和云存储集成，并使用独立的 bundle、DMG 和 Sparkle 更新源，适合不需要分享上传的环境。