Documentation

Documentation

安装

在 Mac 上获取 Snapzy 的多种方式。选择最适合你工作流的一种。

系统要求

  • macOS 13 Ventura 或更高版本
  • Apple 芯片或 Intel 芯片 Mac
  • 约 120 MB 可用磁盘空间
  • 仅在进行云端上传时需要互联网连接（可选）

下载 DMG

  1. 从 下载页面 获取最新的 .dmg 文件。
  2. 打开 DMG 文件并将 Snapzy 拖拽到你的“应用程序”文件夹中。
  3. 从“应用程序”或 Spotlight（聚焦搜索）启动 Snapzy。

Homebrew

如果你使用 Homebrew，可以直接运行以下命令进行安装：

brew install --cask snapzy

当你运行 brew upgrade 时，升级会自动处理。

Shell 脚本

通过 curl 安装最新版本（自动检测并获取最新 Release）：

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/install.sh | bash

如需安装特定版本，可传入 VERSION 参数：

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/install.sh | VERSION=<version> bash

从源码构建

Snapzy 是开源的。你可以使用 Xcode 在本地构建它：

  1. 克隆代码仓库：git clone https://github.com/duongductrong/Snapzy.git
  2. 在 Xcode 15 或更高版本中打开 Snapzy.xcodeproj。
  3. 选择 Snapzy target 并将你的 Mac 选择为目标设备。
  4. 按下 ⌘R 进行构建和运行。

首次运行权限

在首次启动时，Snapzy 将请求以下 macOS 权限：

  • 屏幕录制 — 捕获屏幕截图和录制所必需的。
  • 麦克风 — 可选，仅在你想要在屏幕录制中输入声音时需要。
  • 辅助功能 — 可选，用于全局键盘快捷键和窗口检测。

有关如何授予或撤销这些权限的详细信息，请参阅 权限与隐私。

卸载

要彻底删除 Snapzy、重置权限并清理应用数据：

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/uninstall.sh | bash

这会从 /Applications 中删除该应用，删除偏好设置与缓存，并重置 TCC 权限（屏幕录制、麦克风、辅助功能）。你可能需要注销或重启系统，以使权限更改完全生效。