滚动捕获

如何使用

滚动捕获会为你代劳，省去截取多张截图并手动拼接的麻烦。只需选择可滚动区域，以稳定速度向下滚动，并让 Snapzy 处理这些画面。

1. 使用快捷键 ⇧⌘6 或 URL snapzy://capture/scrolling 触发捕获。
2. 拖动选择框以 仅覆盖可滚动的内容区域。避开静态页眉、侧边栏或页脚，因为它们会干扰拼接。
3. 按下 HUD（悬浮控制面板）上的 开始。
4. 缓慢且稳定地向下滚动。你将在覆盖层中看到实时预览，显示拼接后的图像不断变长。
5. 点击 完成 或按下 Enter 保存。

自动滚动 (Auto Scroll)

为了提供完全自动化的捕获体验，Snapzy 提供了基于 macOS 辅助功能 API (Accessibility APIs) 驱动的 自动滚动 (Auto Scroll) 功能。

工作原理

1. 锁定选择区域并点击 开始 (Start) 后，HUD 上将显示 自动滚动 (Auto Scroll) 按钮。
2. 点击 自动滚动 开始捕获。Snapzy 将自动发送精确的滚动事件来为您滚动内容。
3. 指针保护 (Pointer Guard): 为保持滚动焦点，鼠标指针必须保持在选定的捕获区域内。如果将光标移出选择区域：
   • 自动滚动将暂停。
   • 警告提示 HUD 将要求您 将鼠标移回选择区域内。
   • 将光标移回选择区域内后，捕获将自动恢复。
4. 自动完成: 一旦 Snapzy 检测到已到达页面底部或高度限制，它将自动完成拼接并保存捕获。
5. 安全停止: 如果由于动态弹窗或布局变化导致连续多次拼接对齐失败，自动滚动将自动停止，以便您手动完成捕获。

[!IMPORTANT] 由于自动滚动会生成模拟滚动事件，Snapzy 需要在 macOS 系统设置中启用 辅助功能 (Accessibility) 权限。如果缺少该权限，系统会提示您进行授权。

幕后原理：拼接是如何工作的

Snapzy 使用混合捕获流水线，即使在复杂的布局下也能确保准确的结果：

• 流式帧环 — 一个捕获选定区域并将其保存在环形缓冲区（ScrollingCaptureFrameRing）中的高帧率流。
• 回退静止帧 — 如果滚动流遇到卡顿或掉帧，Snapzy 会立即触发回退静态捕获以防止拼接缝隙。
• Vision 辅助拼接 — 本地 Vision 算法比较重叠切片、识别匹配、检查置信度阈值并忽略冗余帧。
• 安全检查 — 如果滚动速度过快或向后滚动，拼接器会暂停并显示警告 HUD，这样你就可以调整速度，而无需重新开始捕获。

获得整洁捕获的最佳实践

1. 紧密圈选

排除不可滚动的页眉、粘性导航栏或固定的侧边小部件。拼接器要求整个选定的块能进行统一滚动。

2. 平滑滚动

使用鼠标滚轮或触控板以连贯的动作向下滚动。避免快速跳过段落。

3. 避开悬停元素

在滚动时保持鼠标光标远离选择区域，以防止悬停卡片阴影或提示工具动画破坏重叠部分。

诊断与日志

如果你遇到问题（例如拼接错误或文本对齐错误），可以检查 Snapzy 的诊断日志：

滚动捕获会将时间数据、帧环统计信息和 Vision 置信度水平记录到你的本地日志文件中：

~/Library/Logs/Snapzy/snapzy_YYYY-MM-DD.txt

你可以使用终端过滤日志中的滚动调试语句：

grep 'ScrollingCaptureDebug' "$HOME/Library/Logs/Snapzy/snapzy_$(date +%F).txt"