跳到正文

首次启动向导

用向导完成初始配置：为每个人添加参照照片、添加要扫描的图片与视频目录，看着第一次索引建完，再开始查看匹配结果。

向导会在首次启动时运行，把你从空空如也的应用带到第一批匹配结果。以后想加人、加素材，在工作台里也能走同样的步骤。

第 1 步 —— 添加人物

SnapByFace 需要每个人一张清晰的参照照片。请用人物名作为文件名 —— 文件名就是人名：

People/
├── 张三.jpg
├── 李四.png

照片放在子目录里也可以，SnapByFace 会递归扫描。但名字始终来自文件名，不是目录名。

支持的图片格式：JPG、JPEG、PNG、BMP、TIFF、WebP、HEIC/HEIF。

对每张照片：

  • SnapByFace 会检出人脸（det_10g.onnx），并为这个人保存一个 512 维特征（w600k_r50.onnx）。
  • 检不出人脸的照片会被明确提示，以便你替换。
  • 含多张人脸的照片也会被提示 —— 请改用只有一个人脸的证件照。

:::tip 请使用正面、光线均匀、没有被遮挡的证件照。护照式照片比从合影里裁出来的图能得到更干净的特征，后续漏检与误判都会更少。 :::

第 2 步 —— 添加素材目录

添加一个或多个装着你要检索的照片与视频的目录。SnapByFace 会递归扫描，包含子目录。

  • 图片：JPG、JPEG、PNG、BMP、TIFF、WebP、HEIC/HEIF
  • 视频：MP4、MOV、AVI、MKV、M4V、WebM、TS

视频方面，SnapByFace 按固定间隔抽帧 —— 默认 1 秒，可在 0.1 到 30 秒之间调整。参见 检索视频。

:::caution 抽帧间隔是在分析那一刻确定下来的。以后改间隔，相关视频必须重新分析 —— 改相似度阈值不能替代这一步。 :::

第 3 步 —— 设备统计（可选）

向导会询问是否允许 SnapByFace 发送设备统计：机器码、应用版本与操作系统，用于统计装机量并支持你的授权。

你的照片、视频与人脸数据绝不会离开这台电脑。设备统计可以随时在设置里关闭。ping 的具体内容参见 软件激活 与常见问题。

第 4 步 —— 建立索引并查看

SnapByFace 会遍历你的素材，对每张图片和每个抽帧画面检出人脸，并把特征写进本机的 SQLite 索引。运行期间你可以：

  • 暂停 和 继续 任务。
  • 取消 任务 —— 已经完成的文件仍然保留索引。
  • 关掉软件下次接着做：下次启动时 SnapByFace 会询问是否继续未完成的任务。

索引建完后，结果视图会以两种方式呈现：

  • 按人物 —— 每个你添加过的人物下面归拢它出现过的所有素材。
  • 按素材 —— 每张图片或每个视频下面列出在它里面匹配到的人物。

实用提示

  • 分析主要消耗 CPU。第一次处理大库常常要几个小时 —— 可以放到夜里跑，或者先只加一个目录。
  • 之后再加人物不会重新分析素材：SnapByFace 会拿已经算好的特征重新匹配一遍。
  • 你的原始文件永远不会被修改。SnapByFace 只读它们，写入只发生在 ~/.snapbyface/。

下一步