按画面搜索照片，输入的是画面内容，不是文件名。在装了 Phoaly 的 Mac 上，这句话 会在本机编码，再和本地照片索引比对，照片和搜索词都不会离开电脑。
这篇教程讲该输入什么、画面搜索能知道什么、不能知道什么，以及怎样和日期、人物、 地点、分类一起使用。
本地画面搜索怎么工作
Phoaly 扫描文件夹时建立两样东西：
- 每张照片一个向量，来自画面内容。
- 一个文字编码器，把你的句子变成同一空间里的向量。
搜索时只编码你输入的那句话。照片向量已经存在，所以第二次搜索很快，即使图库 很大；文字模型也可以按需加载，空闲五分钟后释放。
画面搜索接受中文和英文描述。索引只建一次，每次查询只编码一句话。
该输入什么
像向一个没看过这张照片的人描述画面那样输入：
- 主体：小孩、狗、婚纱、自行车。
- 场景：海边、城市、室内、夜晚。
- 光线或天气：日落、雾、雪、霓虹。
- 构图：特写、广角、俯拍。
短句比完整句子更好。「城市灯光」比「我去年晚上拍的那张城市灯光照片」更容易 命中。
一组可用的查询
| 你记得的 | 可以输入 |
|---|---|
| 一种气氛 | 海边的日落 |
| 一个物体 | 黄色自行车 |
| 一个场景 | 夜晚的窄街 |
| 人物和场景 | 草地上的小孩 |
| 一次庆祝 | 生日蛋糕 |
| 一个季节 | 树上的雪 |
第一句没中，就换名词或场景。如果灯不是主体，先试「夜晚的街道」，再试 「城市灯光」。
画面搜索不知道什么
画面搜索匹配的是照片看起来像什么。它不知道文件之外的所有事：
- 它不读取照片里的文字。招牌、收据和文档请用文字识别工具。
- 它不知道人物姓名，除非人物分组已经命名。
- 它不知道照片背后的故事。
- 它不替代 RAW 显影或调色工具。
像素之外的信息，用文件名、文件夹、拍摄日期或地图来找。
文件名搜索和画面搜索
Phoaly 也搜索文件名。文件名搜索使用 FTS5 trigram 索引，中文子串和英文名字 中间的片段都能匹配。
两种搜索回答不同的问题：
- 文件名：「IMG_4821 在哪？」或「京都那批文件在哪个文件夹？」
- 画面：「哪些照片看起来像海边的日落？」
如果文件名搜索没有结果，Phoaly 会对这个词切换到画面搜索一次。这样不会走进 死胡同，也不会把每次查询都变成画面搜索。
和分组一起用
搜索和其他维度组合起来更有用：
- 按拍摄时间排序，看结果的顺序。
- 按文件夹分组，看命中的照片在哪里。
- 按地点分组，缩小一次旅行的范围。
- 按相机分组，把手机照片和相机拍摄分开。
- 按分类筛选，只留人物、食物、自然或城市。
一个查询加一个分组，通常比更长的查询更快。
隐私与模型生命周期
文字编码器和照片向量都在这台 Mac 上运行。你输入的句子在本地编码，和本地索引 比对，不会发送到服务器。
文字模型按需加载，空闲五分钟后释放。照片索引是可丢弃的，随时可以从文件夹重建。
常见问题
画面搜索会上传照片吗？
不会。照片、缩略图、向量和搜索词都留在 Mac 上。
可以用中文搜索吗？
可以。中文和英文描述都支持。
为什么搜不到？
换一个名词或场景再试。画面搜索匹配外观，不匹配故事或文件名。如果照片格式 无法建立索引，重建索引后再试。
能搜到截图里的文字吗？
画面搜索不是文字识别工具。图片里的文字请用文件名或专门的 OCR 工具。