常见问题

隐私与离线使用

我的照片或视频会离开我的电脑吗？

不会。人脸检测、512 维特征提取与向量检索全部在你本机上完成。没有任何图片、视频或人脸特征被上传，整条链路里也不存在云端 API。

SnapByFace 需要联网吗？

识别与检索不需要 —— 它们在本地运行，拔掉网线照样能用。只有两件事会用到网络：在浏览器里购买授权，以及可选的设备统计 ping。安装过程不会下载模型，模型已经在 300 MB 的安装包里了。

设备统计 ping 到底是什么？

启动时发出的一条可选的、很小的请求，只包含：机器码、应用版本、操作系统、语言、是否已激活与套餐。它用于统计装机量并支持授权服务。

它不含任何照片、视频、人脸数据、文件路径、目录名、素材库规模或搜索行为。默认开启，可在设置里关掉；失败时（3 秒超时）会静默跳过，永不重试。

::::note 请把两句话分开说：识别与检索 100% 在本地，唯一对外的数据就是那条设备统计 ping，且它不携带任何素材数据。 ::::

需要注册账号吗？

不需要。没有注册流程，使用软件不需要邮箱，也没有登录。

SnapByFace 把我的数据存在哪里？

在你用户目录下的 ~/.snapbyface/：SQLite 索引、提取出的人脸数据、你的设置、激活状态与日志。

我能把它用在涉密素材上吗？

可以 —— 这正是纯本地运行的意义所在。既然没有任何数据被上传，实际的安全控制就是你已有的那些：磁盘加密、用户账号，以及对这台机器的物理管控。

性能

它能处理多大规模的素材？

设计目标是一台机器上数万张照片与数小时视频。瓶颈在于首次分析所需的 CPU 时间与磁盘速度；重跑很便宜，因为未变化的文件会被跳过。

为什么我的大素材库匹配很慢？

多半是 FAISS 不可用，SnapByFace 回退到了 NumPy 检索。匹配结果相同，只是更慢 —— 参见 故障排查。

改阈值会重新分析我的素材吗？

不会。改阈值是拿已经存在的特征重新匹配，所以素材库再大也很快。改视频抽帧间隔则不同：它改变了「存在哪些帧」，所以那些视频必须重新分析。

长时间任务可以暂停吗？

可以 —— 随时暂停、继续或取消，已完成的文件保留索引。

它用 GPU 吗？

SnapByFace 的 ONNX 模型跑在 CPU 上。索引期间 CPU 会比较忙；一暂停立刻释放。

导出

我能导出什么？

命中的素材：把匹配的照片，以及视频命中对应的完整原视频，复制到你指定的目录。

试用版导出受限吗？

激活之前导出就能用；试用版限制的是显示多少条匹配（每位人物 5 条、每次搜索 20 条）。参见 软件激活。

试用版能跑多少次分析？

每台机器累计 100 次。一次「分析」指对素材目录跑一轮 —— 浏览结果、导出、调整阈值后的重新匹配都不计数。超过 100 次后，发起新的分析前需要先激活；已经找到的结果仍可浏览和导出。

限时套餐到期后，我的结果会怎样？

软件和数据都还在：SnapByFace 照常能打开，已找到的结果仍可浏览和导出。但到期后不能再发起新的分析，结果视图也会回落到试用上限（每位人物 5 条、每次搜索 20 条），续费后恢复。用同一个机器码续费即可立即查看全部结果，不需要重新索引或重跑。

支持哪些文件格式？

图片：JPG、JPEG、PNG、BMP、TIFF、WebP 与 HEIC/HEIF；视频：MP4、MOV、AVI、MKV、M4V、WebM、TS。相机 RAW 文件（CR2、NEF、ARW 等）暂不支持，请先导出为 JPEG 或 TIFF。其他格式不会进入索引 —— 分析结束后 SnapByFace 会告诉你跳过了多少个媒体文件，不会静默消失。

导出会改动我的原始文件吗？

不会。SnapByFace 只读取你的素材；导出的都是副本。

能导出视频片段吗？

不能。视频命中在应用内预览到具体那一秒；导出时复制的是完整的原视频文件。

重置与卸载

怎么删除某个人？

从人物列表里把他移除，他的匹配就会从结果视图中消失。他的参照照片仍在你存放它的地方。

怎么从零重建索引？

关掉 SnapByFace，删除 ~/.snapbyface/snapbyface.db，再重新启动。激活状态在 license.dat 里，所以这不会让你的授权失效。

怎么重置所有设置？

在 SnapByFace 关闭的状态下删除 ~/.snapbyface/config.json。阈值会恢复为 0.45，视频抽帧间隔恢复为 1 秒。

怎么彻底卸载？

删除应用（macOS 上拖到废纸篓，Windows 上用 应用和功能），如果还要删掉索引、设置与激活状态，再删除 ~/.snapbyface/。

卸载会删掉我的照片吗？

不会。SnapByFace 始终只读取你的素材。

激活（简答）

激活需要联网吗？

不需要。授权码是一段 RSA-2048 签名，在你本机上验签。只有购买那一步需要浏览器。

换了硬盘或重装系统怎么办？

机器码会变，所以旧的授权码无法激活。请把新旧机器码连同购买时的邮箱发给支持团队。

哪些操作不会改变机器码？

改计算机名、插上 USB 网卡、安装虚拟机或 Docker、连接 VPN、增加内存条、升级 SnapByFace。

在哪里找机器码？

在「软件激活」对话框里的只读输入框中，旁边有「复制」按钮。完整流程见 软件激活。