Phoaly 的画面搜索让你描述画面内容来找照片。文字编码器和照片向量都在这台 Mac 上运行，索引只建一次，你输入的句子不会离开电脑。
这篇介绍功能怎么工作、边界在哪。具体怎么描述，见 画面搜索指南。
它能做什么
输入一句短描述，得到匹配的照片：
- 「城市灯光」
- 「海边的日落」
- 「草地上的小孩」
- 「生日蛋糕」
匹配依据是画面，不是文件名。中英文描述都支持。不需要先打标签、建相簿或遵守 命名规则。
怎么工作
这个功能由两半组成，它们在同一向量空间里相遇：
- 照片向量。 建立索引时，每张照片得到一个表示画面内容的向量。
- 文字编码。 搜索时，你的句子被编码成同一空间里的向量。
搜索会比较句子向量和照片向量，按接近程度排序。照片向量只算一次，每次查询只 编码一句话。
如果文件名搜索没有结果，Phoaly 会对这个词切换到画面搜索一次。这个回退避免了 死胡同，也不会把每次查询都变成画面搜索。
文件名搜索和画面搜索
两种搜索回答不同问题，使用不同索引：
| 文件名搜索 | 画面搜索 | |
|---|---|---|
| 索引 | FTS5 trigram | 照片向量 |
| 适合 | 已知名称、中文子串、片段 | 画面看起来像什么 |
| 例子 | IMG_4821、京都 | 城市灯光 |
| 需要标签 | 不需要 | 不需要 |
| 本地运行 | 是 | 是 |
trigram 索引让中文子串和英文名字中间的片段也能命中。向量索引让一句描述能命中 一张从未命名的照片。
隐私模型
所有内容都留在 Mac 上：
- 照片向量存储在本地。
- 句子在本地编码。
- 照片和缩略图不会上传。
- 没有账号，也没有云同步。
激活只发送许可证密钥、随机设备 ID 和应用版本。画面搜索不会把查询发送到任何 地方。
性能模型
两个细节让大图库也能用：
- 索引按照片建立一次，不是每次搜索都建。
- 文字模型按需加载，空闲五分钟后释放。
浏览器针对大图库设计：虚拟列表、游标分页，缩略图只在视口内解码。公开的基准是 10 万项图库。
边界
画面搜索不是通用的图像理解系统：
- 它不读取照片里的文字。招牌、收据和文档请用文字识别工具。
- 它不知道人物姓名，除非人物分组已经命名。
- 它不知道故事、客户或交付状态。
- 它不做 RAW 显影，也不替代编辑器。
这些问题请用文件名、文件夹、地图、拍摄日期或其他工具。
适合的位置
画面搜索最适合「记得画面，不记得文件」的情况：
- 不知道文件夹，却想找某次旅行的一张照片。
- 在庞大的家庭存档里定位一个场景。
- 按气氛快速拉出一组图片。
- 把描述和日期范围、人物组合起来查。
它是整理器里的搜索工具，不是另一个图库。
常见问题
会上传照片或搜索词吗？
不会。照片向量和文字编码都在本地。
需要标签或相簿吗？
不需要。索引直接来自画面。
支持中文搜索吗？
支持。中英文描述都可以。
为什么有些照片搜不到？
画面搜索匹配外观，不匹配故事或文件名。换一个名词或场景再试。如果文件格式 无法建立索引，重建索引后再试。