URL 配置 (URL Scheme)

總覽

任何可以開啟 URL 的應用程式 — Raycast、Alfred、「捷徑」(Shortcuts) 應用程式、終端機或瀏覽器 — 都可以觸發 Snapzy 操作。只需開啟 snapzy:// 連結即可。

需求 — Snapzy 必須在執行中，URL 配置操作才能運作。如果尚未開啟，macOS 將會先啟動它，然後執行該操作。

支援的操作

擷取全螢幕

snapzy://capture/fullscreen

擷取區域

snapzy://capture/area

擷取標註

snapzy://capture/area-annotate

物件裁切

snapzy://capture/object-cutout

捲動擷取

snapzy://capture/scrolling

擷取文字 (OCR)

snapzy://capture/ocr

擷取應用程式視窗

snapzy://capture/application

錄製螢幕

snapzy://record/screen

錄製應用程式視窗

snapzy://record/application

開啟標註編輯器

snapzy://open/annotate

開啟影片編輯器

snapzy://open/video-editor

開啟雲端上傳

snapzy://open/cloud-uploads

開啟歷史紀錄

snapzy://open/history

顯示快速鍵清單

snapzy://show/shortcuts

開啟設定

snapzy://settings

開啟設定分頁

snapzy://settings?tab=shortcuts

「捷徑」應用程式範例

您可以在 macOS 的「捷徑」(Shortcuts) 應用程式中建立個人自動化：

開啟「捷徑」並建立一個新捷徑。
新增開啟 URL (Open URLs) 操作。
輸入 snapzy://capture/area。
在「捷徑」設定中指派鍵盤快速鍵。

現在，您可以從任何捷徑或自動化工作流程觸發區域擷取。

終端機與指令碼

在「終端機」或 shell 指令碼中，使用 open 指令：

open "snapzy://capture/fullscreen"

這對於將 Snapzy 整合到需要進行視覺迴歸擷取的更大型自動化管線或 CI 工作流程中非常有用。

Raycast 與 Alfred

Raycast 和 Alfred 都支援開啟自訂 URL。建立一個指向任何 snapzy:// 路徑的新指令碼或開啟 URL 操作，綁定熱鍵，即可在不接觸選單列的情況下觸發擷取。

總覽