URL 方案 | Snapzy Docs

概述

任何能够打开 URL 的应用（如 Raycast、Alfred、“快捷指令”应用、终端或浏览器）都可以触发 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 的“快捷指令”应用中创建个人自动化：

打开“快捷指令”并创建一个新的快捷指令。
添加 打开 URL 操作。
输入 snapzy://capture/area。
在“快捷指令”的设置中分配一个键盘快捷键。

现在你可以从任何快捷指令或自动化工作流中触发区域捕获。

终端与脚本

在终端或 Shell 脚本中，使用 open 命令：

open "snapzy://capture/fullscreen"

这对于将 Snapzy 集成到更大的自动化流水线或需要视觉回归捕获的 CI 工作流中非常有用。

Raycast & Alfred

Raycast 和 Alfred 都支持打开自定义 URL。创建一个指向任何 snapzy:// 路径的新脚本或打开 URL 的操作，绑定热键，即可在不触及菜单栏的情况下触发捕获。

概述