捲動擷取

如何使用

「捲動擷取」能為您代勞，免去拍攝多張螢幕截圖並手動拼接的麻煩。只需選擇可捲動的區域，以穩定的速度向下捲動，即可讓 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 使用混合擷取管線來確保複雜版面配置下亦能獲得精確的結果：

• 串流畫面環形緩衝區 (Stream Frame Ring) — 一個高畫面播放速率的串流擷取所選區域，並將其保存在環形緩衝區 (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"