检索图片
添加图片目录，让 SnapByFace 把每张人脸索引成 512 维特征，然后按人物或按图片查看匹配结果，含相似度、预览与素材导出。
添加图片目录
添加任意图片目录即可，SnapByFace 会递归扫描，包含子目录。支持格式：JPG、JPEG、PNG、BMP、TIFF、WebP、HEIC/HEIF。
第一次分析之后，只有发生变化的文件才会被重新处理：SnapByFace 会比较文件大小、修改时间、SHA-256 摘要与索引版本，跳过一切未变化的文件。参见 大素材库。
一张图片是怎么判定命中的
- 读取图片，用随包分发的检测器检出人脸。
- 每个检出的人脸被编码成 512 维特征。
- 把每个人物的参照特征与索引里的人脸比对 —— 使用 FAISS 向量检索；没有 FAISS 时改用 NumPy 检索。
- 当余弦相似度达到或超过阈值时即判定命中 —— 默认 0.45。
怎么看结果
结果视图有两种视角：
- 按人物 —— 人物列表，选中一个即显示他出现过的所有素材文件。
- 按素材 —— 图片与视频列表，选中一个即显示其中匹配到的人物。
每条命中都带一个相似度百分比：表示两个特征有多接近。它不是概率，也不是人工意义上的确凿程度。
双击任意结果可以打开原尺寸预览，用眼睛确认一遍。
:::tip 如果漏掉了正确的匹配，把阈值调低一些。如果混进来陌生人，把阈值调高。改阈值只会重新匹配已有特征，不会重新分析你的照片 —— 参见 阈值调优。 :::
添加、替换或删除人物
- 建完索引再加人物很轻 —— SnapByFace 是拿已经算好的特征重新匹配，不会再读一遍图片。
- 更换某人的参照照片只更新该人物的特征，素材不需要重新分析。
- 删除人物会把他的匹配从视图里移除，随时可以再加回来。
导出
- 导出命中的素材 —— 把匹配的照片，以及视频命中对应的完整原视频，复制到你指定的目录。
导出的都是副本；原文件不会被改动。
试用限制
没有授权时，结果视图最多显示每位人物 5 条、每次搜索 20 条，并且累计最多发起 100 次分析。检索本身没有限制 —— 激活即解锁已经找到的匹配，不需要重跑任何东西。参见 软件激活。
常见问题
- 为什么某张照片没出现在结果里？ 它的人脸打分低于阈值、人脸太小或太暗没被检出，或者参照照片质量太差。
- 为什么同一张照片列出两次？ 它里面的两张不同的人脸分别匹配到了两个不同人物 —— 合影出现这种情况是正常的。
- 目录顺序会影响结果吗？ 不会。结果按人物和按素材分组，与来源目录无关。