跳到正文

安装

在 macOS 12+ 或 Windows 10+ 上安装 SnapByFace：选择正确的构建版本、安装自带模型的 300 MB 安装包，并处理 Gatekeeper 或 SmartScreen 的警告。

SnapByFace 以原生桌面安装包的形式分发。下载体积约 300 MB，因为人脸模型（det_10g.onnx 与 w600k_r50.onnx）就打包在里面 —— 安装之后 SnapByFace 不会再去下载任何模型。

1. 下载正确的版本

平台安装包
macOS，Apple Silicon（M1–M4）SnapByFace-<version>-macOS-arm64.dmg
macOS，IntelSnapByFace-<version>-macOS-x64.dmg
Windows 10/11，64 位SnapByFace-<version>-Windows-x64-Setup.exe

:::tip 不确定自己的 Mac 是哪一种？苹果菜单 → 关于本机 会显示芯片型号。Apple Silicon 版本在视频处理上明显更快。 :::

2. 在 macOS 上安装

  1. 打开 .dmg。
  2. 把 SnapByFace 拖到 Applications（应用程序） 快捷方式上。
  3. 推出磁盘映像，从「应用程序」或 Spotlight 启动 SnapByFace。

Gatekeeper 可能会拒绝打开未经公证的应用。SnapByFace 是一个人做的 —— Apple 公证需要价格不低的开发者证书，我还没去办，所以你的系统会弹出警告。应用本身是安全的：先核对下载页上的 SHA-256 校验值，然后在终端里清除隔离属性：

xattr -cr /Applications/SnapByFace.app

3. 在 Windows 上安装

  1. 运行安装程序，接受默认安装位置。
  2. 如果 SmartScreen 提示 ”Windows 已保护你的电脑”，选择 更多信息 → 仍要运行。SnapByFace 是一个人做的，还没有已验证的发布者证书 —— 这就是 SmartScreen 标记它的原因。可以核对下载页上的 SHA-256 校验值确认文件是原版。
  3. 从「开始」菜单启动 SnapByFace。

4. 首次启动

首次启动向导会自动打开，请你添加参照照片和素材目录。参见 首次启动向导。

首次启动时 SnapByFace 还会创建它的工作目录：

~/.snapbyface/     # macOS：/Users/<你>/.snapbyface   Windows：C:\Users\<你>\.snapbyface
├── snapbyface.db  # SQLite 索引：素材、人脸、特征、结果
├── license.dat   # 激活状态
├── config.json   # 你的设置（阈值、视频抽帧间隔、语言）
└── logs/         # snapbyface.log

:::note 运行 SnapByFace 不需要联网。人脸检测、特征提取与检索都在你自己的 CPU 上跑。唯一的外发请求是可选的设备统计 ping（默认开启，可在设置里关掉）。另外，如果你决定购买授权，购买页面也需要联网。 :::

5. 更新与卸载

  • 更新： 直接把新版本安装覆盖旧版本。~/.snapbyface/ 里的索引会保留，已经分析过的素材不会被重新分析。
  • 卸载： 删除应用（/Applications/SnapByFace.app，或 Windows 上的 应用和功能）。~/.snapbyface/ 会保留 —— 如果你想删除全部索引数据与激活状态，需要手动删掉它。

下一步