URL 配置 (URL Scheme)

總覽

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

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

支援的配置與別名

為方便起見，每個操作都支援一個主要 URL 配置以及多個備用別名。

1. 螢幕擷取 (Screenshots)

擷取全螢幕

擷取整個螢幕。

snapzy://capture/fullscreen
snapzy://capture-screen
snapzy://capture-fullscreen
snapzy://fullscreen
snapzy://screenshot/fullscreen

擷取區域

啟動互動式區域選擇工具。

snapzy://capture/area
snapzy://capture-area
snapzy://area
snapzy://screenshot/area

擷取應用程式視窗

擷取特定的應用程式視窗。

snapzy://capture/application
snapzy://capture/window
snapzy://application-capture
snapzy://window-capture
snapzy://screenshot/window

作用中視窗擷取

立即擷取目前作用中/取得焦點的視窗。

snapzy://capture/active-window
snapzy://capture/focused-window
snapzy://active-window-capture
snapzy://active-window
snapzy://screenshot/active-window

擷取並標註

擷取選定區域並直接在標註/標記編輯器中開啟。

snapzy://capture/area-annotate
snapzy://capture-area-annotate
snapzy://area-annotate
snapzy://screenshot/area-annotate

捲動擷取

啟動捲動擷取以擷取長網頁或文件。

snapzy://capture/scrolling
snapzy://scrolling-capture
snapzy://capture-scrolling
snapzy://scrolling
snapzy://screenshot/scrolling

擷取文字 (OCR)

選擇一個區域以使用 OCR 擷取文字。

snapzy://capture/ocr
snapzy://capture/text
snapzy://capture-text
snapzy://ocr
snapzy://text

智慧元素擷取

懸停擷取時自動偵測 UI 元素。

snapzy://capture/smart-element
snapzy://smart-element
snapzy://capture-smart-element
snapzy://smart

物件裁切

選擇一個區域來分離並裁剪出主要物件/移除背景。

snapzy://capture/object-cutout
snapzy://object-cutout
snapzy://capture-object-cutout
snapzy://cutout

2. 螢幕錄製 (Screen Recordings)

錄製螢幕

開始影片或 GIF 螢幕錄製。

snapzy://record/screen
snapzy://record-screen
snapzy://screen-recording
snapzy://recording
snapzy://record

錄製應用程式視窗

錄製選定的應用程式視窗。

snapzy://record/application
snapzy://record/window
snapzy://application-recording
snapzy://window-recording
snapzy://recording/window

3. 開啟檢視 (Open Views)

開啟標註編輯器

開啟一個空白的標註/標記編輯器。

snapzy://open/annotate
snapzy://annotate
snapzy://open-annotate

開啟影片編輯器

開啟一個空白的影片編輯器。

snapzy://open/video-editor
snapzy://video-editor
snapzy://edit-video
snapzy://open-video-editor

開啟雲端上傳

開啟您的雲端上傳歷史紀錄。

snapzy://open/cloud-uploads
snapzy://cloud-uploads
snapzy://uploads
snapzy://open-uploads

開啟歷史紀錄

開啟本機擷取和錄製歷史紀錄。

snapzy://open/history
snapzy://history
snapzy://capture-history

顯示快速鍵清單

顯示鍵盤快速鍵清單。

snapzy://show/shortcuts
snapzy://shortcuts
snapzy://keyboard-shortcuts
snapzy://show-shortcuts

4. 設定與偏好設定 (Settings & Preferences)

基本 URL 結構

使用以下任一路徑開啟設定：

snapzy://settings
snapzy://preferences

要開啟特定分頁，使用路徑或查詢參數：

snapzy://settings/<tab_name>
snapzy://preferences/<tab_name>
snapzy://settings?tab=<tab_name>

支援的設定分頁

設定目標	分頁名稱 (`<tab_name>`)	支援的別名
一般設定	`general`
擷取設定	`capture`	`screenshots`, `screenshot`
標註編輯器設定	`annotate`	`annotation`, `annotations`
快速存取面板設定	`quick-access`	`quickaccess`
歷史紀錄設定	`history`
快速鍵設定	`shortcuts`	`keyboard-shortcuts`
系統權限設定	`permissions`	`privacy`
雲端儲存設定	`cloud`	`uploads`
進階設定	`advanced`	`configuration`, `config`, `toml`
關於 Snapzy	`about`

「捷徑」應用程式範例

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

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

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

終端機與指令碼

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

open "snapzy://capture/fullscreen"

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

Raycast 與 Alfred

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

總覽