Immich 高级搜索筛选器逐项拆解:人物地点相机 OCR 星级
语义搜索解决「说不出文件名但记得画面」的问题;高级筛选器解决的是条件明确的查询:「去年十月拍的所有视频」「小 M 出镜、在成都、用某台相机拍的照片」。两者在同一个搜索面板里。
筛选字段全清单
高级筛选面板能用的字段(按官方文档口径):
| 字段 | 能搜什么 | 典型用法 |
|---|---|---|
| 人物 | 选定一个或多个已命名人物 | 「全家福」= 同时选中全家人脸 |
| 上下文 | 语义描述 | 与智能搜索同源,可与其他条件叠加 |
| 文件名/扩展名 | 全名或片段 | 找 IMG_ 原片、找 DNG 修图源文件 |
| 描述 | 你给照片写的备注 | 按自己的备注体系检索 |
| OCR 文字 | 图片里出现的文字 | 搜截图内容、招牌、快递单号照片 |
| 地点 | 城市、省州、国家 | 逆地理解析自动打上的地名 |
| 标签 | 你打的标签 | 配合 标签体系 用 |
| 相机 | 机身、镜头型号 | 分离无人机/手机/相机拍的素材 |
| 时间段 | 起止日期 | 「去年春节前后一周」 |
| 媒体类型 | 图片/视频 | 清理视频占空间时按类型看 |
| 显示选项 | 归档中/收藏/不在任何相册 | 「不在任何相册」= 该整理的散图 |
| 星级 | 你评的星 | 精选照片池 |

三个组合技
「没整理的照片大扫除」:显示选项选「不在任何相册」+ 时间段限定去年 → 一次性看到所有没归档的散图,批量建相册或归档。
「某人的高质量照片」:人物选他 + 星级四星以上 → 直接生成一份人物精选,配合 共享相册 送家人。
「找一张写过字的截图」:OCR 字段输入记得的关键词 → 免去逐张翻截图。OCR 是 v3 时代逐步铺开的能力(移动端查看时文字会以浮层显示,方便直接复制)。
v3 的搜索升级
v3.2.0 重做了搜索界面并上线了 Search API v2:新 API 支持相册内搜索和 AND/OR 条件组合,网页端搜索面板也换上了更清爽的设计。这意味着第三方工具能做出更花哨的搜索体验——功能会持续增强,以官方发布说明为准。
和语义搜索的分工
一个粗但好用的分工原则:带画面感的查询用语义搜索,带属性感的查询用筛选器。「雨夜的霓虹灯」是前者;「2025 年 3 月他在日本拍的视频」是后者。两边可以在同一查询里混用——上下文字段本质上就是语义搜索,叠加人物、地点后威力翻倍。