SnapClick v2.1.2

SnapClick v2.1.2 版本更新

本次更新对 屏幕测距、智能识别、截图标注与导出 进行了全面增强与细节打磨，进一步提升性能与日常操作流畅度。

---

📐 1. 屏幕测距与对齐辅助（Pixel-level Measurement）

• 高精度实时测距：支持拖拽两点实时测量直线距离与夹角，自动标注水平（dx）与垂直（dy）分量。
• 智能边缘吸附与元素识别：精准捕获屏幕窗口及 UI 元素边界，快速获取组件尺寸。
• 辅助参考线：自由拖拽创建横竖参考线，实时显示间距刻度，助力 UI 像素级对齐。
• 全屏十字准星：准确定位屏幕像素坐标与相对位置。
• Retina 双单位切换：支持在逻辑点（pt）与物理像素（px）间一键切换。
• 多测量结果保留：支持在屏幕上保留多条测量记录，方便对照及导出。

🔍 2. 智能识别（OCR / 翻译 / 扫码）

• 系统原生 OCR 识别：基于 Apple Vision 引擎，截图选区即刻提取文字，支持多语言离线识别与逐行校对。
• 截图即时翻译：集成原生翻译引擎，无需跳转即可快速完成多语言互译。
• 二维码 / 条形码识别：自动解析选区内 QR Code / Barcode，支持快速复制与链接跳转。

📸 3. 截图标注与导出增强

• 独立标注属性面板：快速调整画笔粗细、颜色、透明度及预设样式。
• 选区尺寸微调：支持选区悬停面板与键盘微调，精准控制截图区域尺寸。
• 文字擦除 / 抹除工具：支持智能抹除选区文字并自动修复背景。
• 高清矢量与 PDF 导出：支持将截图标注内容导出为高保真 PDF 矢量文件。
• 自定义命名模板引擎：支持按日期、时间戳、序列号等变量自定义截图命名规则。

⚡ 4. 性能优化与稳定性修复

• Finder 右键响应加速：优化 NSCache 图标缓存加载机制，右键菜单秒开无等待。
• 快捷键系统与多屏适配：优化多显示器、Retina 屏下的窗口吸附精度与全局快捷键冲突检测。
• 内存与渲染优化：降低截图与测距覆盖层在常驻运行时的系统资源开销。

SnapClick v2.1.0

SnapClick v2.1.0 重磅更新

SnapClick v2.1.0 带来了全新的屏幕测距与智能识别模块，同时对截图标注与系统性能进行了深度优化，让「截、量、标、识」全流程体验更加顺畅。

---

📐 1. 全新屏幕测距（Pixel-level Measurement）

• 测距模式：支持拖拽两点实时测量直线距离与夹角，自动标注水平与垂直分量。
• 智能测物与边缘吸附：自动识别屏幕元素边缘并高亮吸附，快速测量组件宽高。
• 参考线与对齐：自由拖拽创建横竖参考线，实时计算参考线间距，辅助 UI 精确对齐。
• 全屏十字准线：高精度全屏准星快速校准对齐。
• Retina 双单位支持：支持在逻辑点（pt）与物理像素（px）间一键切换。
• 保持测量：支持将多个测量结果保留在屏幕上，支持一键复制尺寸或截图导出。

📸 2. 截图标注与导出增强

• 标注工具选项面板：新增独立工具属性面板，快速调整画笔粗细、颜色、透明度与样式。
• 尺寸微调浮层：支持在选区阶段通过悬停面板与键盘微调精确控制截图宽高。
• 文字擦除 / 抹除：提供智能文字消除与背景修补能力。
• 多格式与 PDF 导出：支持将截图直接导出为高保真 PDF 矢量文件及自定义格式选项。
• 自定义命名模板：新增文件名模板引擎，支持日期、时间、序号等变量自定义保存命名。

🔍 3. 智能识别（OCR / 翻译 / 扫码）

• 高精度 OCR 文字识别：基于 macOS 原生 Vision 引擎，截选区域即可一键提取文字，支持多语言识别与逐行点击校对。
• 截图即时翻译：OCR 结果一键直译，支持中/英/日/韩/法/德/西等多语种互译。
• 二维码 / 条形码解析：截取包含 QR Code 或条形码区域自动快速解码，支持一键打开链接或复制内容。

⚡ 4. 体验优化与稳定性修复

• 选区识别优化：提升跨多显示器、Retina 屏下的窗口边缘吸附精度。
• 快捷键系统增强：全面统一测距、截图、录屏、录音及取色快捷键冲突检测与响应逻辑。
• 内存与渲染性能：优化覆盖层渲染管线，降低截图与测距时的 CPU / GPU 资源占用。

v2.0.2

v2.0.2

引擎稳定性修复

• 截图引擎：修复截图完成后应用意外切换到前台的问题
• 录屏引擎：稳定性与异常处理优化
• 取色器：性能与边界条件修复

截图标注增强

• 标注画布：导出与坐标系统一致性修复
• 标注编辑器：交互与渲染增强

应用图标

• 清理冗余图标资源，保留 macOS 标准尺寸

SnapClick v2.0.1

v2.0.1 补丁更新

引擎稳定性

• AudioRecordingEngine / ScreenRecordingEngine: 异常处理与状态机加固
• CaptureOverlayWindow: 光标恢复与窗口拖动逻辑
• AnnotationEditorWindow: 标注画布导出与坐标系修复
• ScreenCaptureEngine: 多屏识别与权限提示优化
• SandboxManager: 沙盒路径解析与文件操作权限收敛

资源

• AppIcon: 更新图标资源
• CFBundleVersion 6→7

完整更新日志

SnapClick v2.0.0

v2.0.0 大版本更新

新增音频录制模块

• 全场景录音：系统内录、麦克风录制、混合模式
• 麦克风测试卡：实时波形显示 + 灵敏度校准
• 音频码率/采样率/声道配置
• 独立录制 HUD 窗口、预览面板与导出流程
• 录音前预热面板（设备/码率/倒计时）

录屏重构

• 新增 RecordHUDStandaloneWindow：全屏录制独立 HUD，不受选区窗口限制
• 新增 RecordQualitySettings：分辨率、帧率、码率、编码器配置
• 录制区域指示器、倒计时窗口、引擎管线全面优化
• 多屏悬停 / 点击窗口识别精度提升

截图引擎增强

• AnnotationCanvas 导出坐标系修正：flipped 视图与 lockFocus 一致
• CaptureOverlayWindow 选区→标注模式切换时光标恢复
• ScreenCaptureEngine 选区管理、窗口光标绘制统一
• RecordSelectionOverlayWindow 选区拖动 HUD 重构

状态栏菜单与设置

• 状态栏菜单分组重排：截图 / 录屏 / 录音 / 取色 / 屏幕贴图 / 设置
• 快捷键面板新增录音 / 录屏快捷键可视化
• 欢迎页新增录音功能引导
• 设置页：音频设备、码率、麦克风测试集成

权限与沙盒

• PermissionManager 新增沙盒路径解析与权限状态聚合
• 新增 SandboxManager：统一管理 App Group / 临时目录 / 容器路径
• 主 App 与 FinderExtension entitlements 同步更新

校验

• MARKETING_VERSION 1.2.4 → 2.0.0
• CFBundleVersion 5 → 6

SnapClick v1.2.4

v1.2.4 微更新

多屏截图与窗口识别全面重构

窗口识别

• 改用 CGWindowListCopyWindowInfo(.optionOnScreenOnly) 拿真实 Z 序窗口列表，再映射到 SCWindow；自动过滤 dock / WindowManager / controlcenter / systemuiserver 等系统 UI
• 按窗口层 / 在屏状态 / alpha / 尺寸 / 屏幕相交做属性过滤
• 排除 SnapClick 自身的覆盖层窗口，避免被识别为可截目标

单窗口精确截图

• 新增 captureSingleWindow()：macOS 14+ 走 SCScreenshotManager 拿指定窗口原生像素，降级路径用 CGWindowListCreateImage 在后台队列执行，避免主线程阻塞
• 就地标注模式下用窗口单独截图替换裁剪底图，不再把上层其它程序误截进来

屏幕捕获

• macOS 14+ 优先 SCScreenshotManager（异步、非阻塞、保留屏幕色彩空间）
• 失败回退到 CGDisplayCreateImage（后台 Task.detached 避免阻塞主线程）
• 修复单屏/多屏混合 Retina 错位

窗口选区坐标转换

• 新增 cgCoordFlipHeight 取所有屏幕 frame.maxY 最大值
• view → window → AppKit 全局 → CG 全局坐标完整链路修正
• 多屏幕下悬停 / 点击窗口命中准确

色彩空间对齐

• CaptureOverlayWindow 显式设置 targetScreen.colorSpace，避免 NSImage.draw 在 sRGB 默认窗口里出现 hover / 选中后的色温偏移

校验

• MARKETING_VERSION 1.2.3 → 1.2.4
• CFBundleVersion 4 → 5

SnapClick v1.2.3

v1.2.3 微更新

新增

• 状态栏四个独立截图入口：智能截图（Ctrl+Shift+A，viewfinder 图标）、选区截图（Ctrl+Shift+S，crop 图标）、窗口截图（Ctrl+Shift+W，macwindow 图标）、长截图（Ctrl+Shift+L）。快捷键设置页可分别绑定
• 智能截图顶部提示卡片：进入截图后屏幕顶部居中浮出一张半透明卡片，用纯文字手势提示让用户秒懂——默认态显示「智能截图 / 拖动框选 / 点击截取窗口 / ESC 取消」，鼠标悬停窗口时切换为「点击截取该窗口 | 或拖动选择截图区域」。无任何 emoji

修复

• 状态栏选区 / 窗口截图入口与之前合并的「智能截图」并存，满足不同使用习惯
• 智能截图悬停状态文案进一步精简为「点击截取该窗口 | 或拖动选择截图区域」
• 智能截图卡片宽度收窄（默认 420 / 悬停 260）、分隔符间距收紧，整体更克制

SnapClick v1.2.2

v1.2.2 微更新

新增

• 智能截图合一：Ctrl+Shift+A 整合区域+窗口——拖拽选区、点击截取悬停窗口（无需切换模式）
• 侧边栏 Liquid Glass 选中态：macOS Sequoia 风格磨砂玻璃 + 选中态蓝色图标

修复

• ESC 现在一次就能退出覆盖层（之前需按两次）
• 悬停窗口时不再出现「双层阴影」视觉残留
• 状态栏菜单合并为「智能截图」，删除冗余入口

v1.2.1

v1.2.1

新建文件模板

• 移除冗余的「主菜单」勾选列（保留单一启用开关）
• 名称支持双击 / ✏️ 按钮行内编辑，按回车或失焦提交，Esc 取消
• 编辑按钮放大并加 hover 背景，符合 macOS HIG 22pt 命中目标

性能修复

• 修复勾选框点击卡顿：图标预热从主线程同步改为 debounce(300ms) + 后台 utility 队列
• 之前每次切换 isEnabled 都会触发 6 个 dev tool + 多个目录/扩展名图标的 PNG/Base64 同步编码

视觉

• 侧边栏新增 3-5% 品牌蓝 tinted glass 渐变（顶部稍重、底部较淡）

SnapClick v1.2.0 - 侧边栏焕新，Office 文件不再损坏

SnapClick v1.2.0

侧边栏焕新，Office 文件不再损坏。

✨ 视觉焕新

• 侧边栏与主窗口全面采用 Apple Liquid Glass 风格：半透明毛玻璃材质（20–30% 背景透明度 + 40–60px 背景模糊）、1px 白色高光描边、28–32px 大圆角，呼应 macOS Tahoe / Apple Music / WWDC 2025 设计语言
• macOS 红黄绿窗口控制按钮嵌入侧边栏顶部，与 Logo / 导航项保持统一的呼吸间距
• 导航项改为悬浮胶囊设计：默认透明，hover 时浮现玻璃高光，选中项用发光 Liquid Glass 胶囊取代旧版蓝灰矩形
• 导航图标统一为 SF Symbols 单色风格，整体留白更克制
• 欢迎页与主窗口视觉保持一致，统一 Liquid Glass 背景

🛠 窗口架构重构

• 主窗口从自定义 NSWindow + HStack 迁移到 SwiftUI Window scene + NavigationSplitView，由系统管理原生交通灯按钮并自动给侧边栏让出安全区
• 新增 AppNavigation 单例：桥接状态栏菜单、Dock 点击、IPC 回调等非 SwiftUI 入口到 SwiftUI Window 场景，监听 mainRequestID / welcomeRequestID 触发 openWindow
• 状态栏、Dock 点击、欢迎页跳转路径全部走新的 AppNavigation 链路，旧的 NSApp.sendAction 关闭方式仅作兼容回退

🐛 修复：右键新建 Office 文件损坏

之前 在 Finder 右键新建「Excel 表格 / Word 文档 / PPT 演示」后，双击文件 Excel/Word/PowerPoint 会弹「文件格式或文件扩展名无效」。

根因：Shared/FileOperations.swift 中手写的 ZipWriter 中央目录头缺少 2 字节 mod date 字段（ZIP 规范要求），整个中央目录错位 2 字节，Office 解析失败。同时模板 XML 中 [Content_Types].xml 和 _rels/.rels 对三种格式都硬编码 word/document.xml，xlsx 缺少必需的 xl/worksheets/sheet1.xml 等子部件。

修复方案：参考 wflixu/RClick 的做法——

• 新增 SnapClick/Resources/template.{docx,xlsx,pptx} 三个真实 Office 模板文件（用 textutil / openpyxl / python-pptx 生成，含主题、样式、app metadata 等完整元数据）
• 删除 220 行手写 ZipWriter 编码器和 minimalOfficeData XML 拼装
• createNewFile 改为 Bundle.main.url(forResource:withExtension:) + FileManager.copyItem，FileOperations.swift 从 537 行瘦身到 310 行

后续若想扩展支持 .pages / .key / .numbers，只需把模板文件放进 Resources/ 并加到 Xcode project，代码逻辑零改动。

📦 工程

• MARKETING_VERSION / CFBundleShortVersionString 1.1.2 → 1.2.0
• SnapClick.xcodeproj/project.pbxproj 新增 Resources group 引用 3 个模板
• FileOperations.swift 移除 ZipWriter 私有类、minimalOfficeData 方法及 Data 扩展

📥 安装

下载下方的 SnapClick-v1.2.0.dmg，双击打开后将 SnapClick 拖入「应用程序」文件夹即可。

首次打开如提示「无法验证开发者」，请在「系统设置 → 隐私与安全性」中点击「仍要打开」。

🔐 权限（首次运行按引导授予）

• 屏幕录制（区域截图 / 取色）
• 辅助功能（全局快捷键）
• Finder 扩展（右键菜单）