离线优先 · 隐私优先 · macOS 截图与 OCR 工具
下载 · 功能 · 使用场景 · 快捷键 · 构建 · 更新日志 · 架构 · 隐私
前往 Releases 页面 下载：
SnapGlass-vX.Y.Z.dmg— 安装包SnapGlass-vX.Y.Z.dmg.sha256— SHA-256 校验文件
Warning
首次安装需在「系统设置 → 隐私与安全性」中允许打开（未签名应用）。 截图功能需授予「屏幕录制」权限。
| 模块 | 能力 |
|---|---|
| 📸 截图 | 可调整矩形 / 自由圈选 / 窗口 / 全屏 / 手动滚动截图（ScreenCaptureKit） |
| 🔤 OCR | Apple Vision 离线识别，Tesseract 降级支持，开发者模式双引擎对比 |
| 📦 条码 | QR / Code128 / EAN / PDF417 / Aztec / DataMatrix 识别 |
| ✏️ 标注 | 箭头、矩形、文本、画笔、高亮、模糊、裁剪，支持撤销/重做 |
| 🔐 隐私 | AES-256-GCM 本地加密历史，零网络请求，不访问系统钥匙链 |
| 🎨 UI | Liquid Glass 支持（macOS 26+），低版本自动降级 |
- 矩形区域 / 自由圈选 / 窗口 / 全屏 / 滚动截图
- 支持多显示器与混合缩放环境
- 实时十字准线，释放后二次调整选区
- 默认 Retina 像素，可切换标准 1x
- 支持 PNG/JPEG 编码与 JPEG 质量设置
- Apple Vision 本地框架，完全离线
- 超大图片自动分块识别并合并坐标
- 开发者模式支持 Vision vs Tesseract 双引擎对比
- 识别结果一键复制
- 7 种工具：箭头、矩形、文本、画笔、高亮、模糊、裁剪
- 完整撤销/重做支持
- 矩形标注自动填充与描边同色
- 裁剪工具支持移动、缩放、确认后执行
- 支持 QR / Code128 / EAN / PDF417 / Aztec / DataMatrix
- 截图后自动检测，一键复制内容
- 编辑器内手动识别
SnapGlass 可以帮助你：
- 从不可选文本的 PDF 中提取文字
- 从视频会议共享屏幕中抓取文本
- 从YouTube 视频 / 在线课程中复制文字
- 快速截图并标注后分享
- 识别截图中的二维码和条码
- 批量截图并自动 OCR 存档
| 操作 | 快捷键 |
|---|---|
| 区域截图 | ⌘ + ⇧ + 1 |
| 窗口截图 | ⌘ + ⇧ + 2 |
| 全屏截图 | ⌘ + ⇧ + 3 |
| OCR 识别 | ⌘ + ⇧ + O |
- macOS 13.0+
- Xcode 16+（构建）
- Swift 6.0（构建）
# 安装构建工具
brew install xcodegen swiftlint
# 生成 Xcode 工程
xcodegen generate
# 构建 Release 产物
./scripts/build.sh --version 0.5.1
# 构建后打开 Finder（产物统一输出到 release/vX.Y.Z/）
./scripts/build.sh --open
# 运行全量 Package 测试
./scripts/test.sh所有临时测试与正式构建产物统一归档到
release/vX.Y.Z/，不使用output/目录。详见Docs/RELEASE.md。
更多构建选项见 Docs/RELEASE.md。
SnapGlass/
├── App/SnapGlass/ # macOS GUI App
├── Packages/ # 核心功能模块（SPM）
│ ├── SharedKit/ # 共享工具（日志、加密、错误类型）
│ ├── CaptureCore/ # 截图（ScreenCaptureKit + CG 兼容）
│ ├── OCRCore/ # OCR（Vision + Tesseract 降级）
│ ├── BarcodeCore/ # 条码识别
│ ├── AnnotationCore/ # 标注工具集
│ ├── ScrollCore/ # 滚动截图拼接
│ ├── HistoryCore/ # 本地历史加密存储
│ └── AutomationCore/ # Automation 保留源码（不进入产品构建）
├── Docs/ # 项目文档
├── scripts/ # 构建与测试脚本
└── release/ # 发版产物归档
| 文档 | 说明 |
|---|---|
| 架构设计 | 协议分层与模块设计 |
| 隐私声明 | 数据处理与隐私保护 |
| 安全策略 | 安全边界与漏洞报告 |
| 贡献指南 | 代码规范与 PR 流程 |
| 发版流程 | 构建与发布规范 |
| CI/CD 说明 | GitHub Actions 工作流 |
| 更新日志 | 版本历史 |
欢迎贡献！请先阅读 贡献指南。
- 提交 PR：标题遵循 Conventional Commits 格式
- 报告问题：使用 GitHub Issues
- 安全漏洞：请通过 GitHub Issues 私下报告，勿公开披露
MIT License © SnapGlass Contributors