快速开始

SnapByFace 只回答一个问题：给一张某人的证件照式照片，你文件夹里哪些照片和视频里出现了这个人？检测、512 维人脸特征与向量检索全部在你自己的电脑上完成。

三步工作流

1. 添加人物。 把 SnapByFace 指向一个参照照片目录，文件名用人物名命名 —— 文件名就是人名。子目录会被递归扫描。
2. 添加素材目录。 把它指向你的图片与视频文件夹，SnapByFace 会递归扫描。
3. 查看匹配结果。 按人物或按素材文件浏览结果，每条命中都带相似度百分比，双击即可打开预览。

你的第一次使用

1. 安装 SnapByFace（约 300 MB，模型已包含在内）。
2. 在向导里添加一张正面清晰的参照照片（证件照最佳），并给人物命名。
3. 先只添加一个素材目录、几百张照片 —— 小到能很快跑完。
4. 看看排在最前面的匹配，判断默认阈值（0.45）是否适合你的素材。
5. 结果满意后，再把剩下的素材库加进去，让它在后台跑。

匹配是怎么算的

• 人脸由随包分发的 det_10g.onnx 检测器检出，再由 w600k_r50.onnx 编码成 512 维特征。
• 当两个特征的余弦相似度达到或超过阈值时即判定命中 —— 默认 0.45，可在 0.30 到 0.80 之间调整。
• 向量检索使用 FAISS；如果没有安装 FAISS，SnapByFace 会回退到 NumPy 检索，结果一致但更慢。

哪些数据留在你的电脑上

所有识别与检索都在本地完成。你的照片、视频与人脸特征永远不会离开这台机器，没有任何图片或视频被上传。

:::note SnapByFace 把 SQLite 数据库、人脸数据与日志放在 ~/.snapbyface/（macOS 与 Windows 的用户目录）。没有账号，所以也没有任何东西会被同步到别处。 :::

唯一会离开你电脑的是可选的设备统计 ping —— 机器码、应用版本、操作系统、语言、是否激活与套餐。它不含任何照片、视频、人脸数据、文件路径、素材库规模或搜索行为。默认开启，可以在设置里关掉。

SnapByFace 不会做什么

• 不会把图片、视频或人脸数据上传到任何服务器。
• 不会重命名、移动或修改你的文件 —— 你的素材对它来说是只读的。
• 不会找出你没添加过的人；每条匹配都是与你提供的参照照片比对得出的。
• 不需要注册账号，也不需要登录。

系统要求

macOS	macOS 12 及以上，Apple Silicon 或 Intel
Windows	Windows 10 及以上
安装包体积	约 300 MB（人脸模型随包分发 —— 运行时无需下载）
图片格式	JPG、JPEG、PNG、BMP、TIFF、WebP、HEIC/HEIF
视频格式	MP4、MOV、AVI、MKV、M4V、WebM、TS

试用与激活

没有授权时你依然能跑完整的本地检索；结果视图最多显示每位人物 5 条、每次搜索 20 条，并且累计最多发起 100 次分析。激活后会解锁已经找到的全部匹配 —— 不需要重新检索。

下一步

• 安装
• 首次启动向导
• 检索图片 与 检索视频
• 软件激活