← 文章 / 未分类
immich 4小时前 · 2026-09-11 08:01:28 · 1 阅读

版本 3.2.0

v3.2.0 发布说明 – Search v2、在共享资产中查看自己的人物、全新工作流操作,以及更多!

发布

欢迎来到 Immich v3.2.0

本次更新带来了许多新功能,同时也照例包含一批 bug 修复和代码清理。亮点如下,请继续往下看。

亮点

  • Docker compose 构建器
  • 全新的搜索界面(网页端)
  • Search API v2(服务端)
  • 在共享资产中查看自己的人物,支持跨用户聚类
  • 工作流的标签触发器和操作
  • 独立的回忆页面
  • 标签重命名(网页端)
  • 在地图视口内查看资产(网页端)

Docker compose 构建器

我们最近上线了全新的 docker compose 构建器,让你可以更轻松地为 Immich 拼装一份自定义的 compose 文件。欢迎试用,并在 #31232 告诉我们你的想法!

Search API v2(服务端)

我们打造了一套全新的搜索 API,其中包括支持在相册内搜索,以及用 AND 和 OR 组合多个搜索条件。这些能力一部分将来会暴露到搜索界面上,另一部分则会为其他高级功能提供支撑,同时让第三方工具拥有更强的功能。如果你对这些具体改动以及新 API 的使用示例感兴趣,可以查看 PR #30179,以及我们在 https://api.immich.app/endpoints/search/searchAssets 的 API 文档。

全新的搜索界面(网页端)

我们新加入了一位设计师,在她的帮助下重构了搜索弹窗。之前这个界面相当复杂,现在不仅支持原有的全部功能,还加入了一些体验优化,整体观感也简洁美观了不少。后续我们还会借助新搜索 API 把更多功能引入进来。敬请期待,也欢迎对新设计提出反馈!

新搜索弹窗:筛选包含 Jason 的图片,限加拿大 BC 州近 30 天内拍摄,标签为 Long Beach,上下文搜索词为 Swimming
新搜索弹窗:筛选包含 Jason 的图片,限加拿大 BC 州近 30 天内拍摄,标签为 Long Beach,上下文搜索词为 Swimming
高级筛选器:支持按相机品牌、型号、镜头型号筛选,也可按收藏/归档状态和所属相册筛选
高级筛选器:支持按相机品牌、型号、镜头型号筛选,也可按收藏/归档状态和所属相册筛选

在共享资产中查看自己的人脸

很高兴带来共享体验的第一个重大升级。现在,可信用户之间的人脸识别可以互通,你也能在任意共享资产中看到自己已有人脸记录的对应人物。

用户共享设置(https://my.immich.app/user-settings?isOpen=sharing)中新增了一个功能:聚类组。

用户共享设置中的聚类组,包含 Jane Doe 和 Mich
用户共享设置中的聚类组,包含 Jane Doe 和 Mich

你可以邀请实例中信任的用户加入自己的组,也可以加入别人邀请你的组。聚类组使得同一组内的用户能够识别彼此共享资产中的人脸;同时,由于聚类面对更大规模的人脸池,识别准确度也会有所提升。不过,人名和生日仍然是按用户单独设置的,暂时不会与同组用户共享。

目前,为了让变更回溯生效到所有资源,需要重置群组内所有用户的人脸识别数据。这意味着姓名和生日信息会丢失,识别结果与之前也可能存在细微差异。只有经机器学习识别的面孔会受到影响。未来我们或许能实现无损合并,但现阶段这是充分利用该功能的必要步骤。因此我们在共享设置中为群组内每位用户(包括非管理员)都提供了重置该群组人脸识别的按钮。

Workflow 标签触发器与操作

Workflow 新增了触发器。现在当资源被添加标签时即可触发自动化流程。

可用的 Workflow 触发器,包含新增的 "Asset Tagged" 触发器
可用的 Workflow 触发器,包含新增的 "Asset Tagged" 触发器

要使用这一新触发器,还新增了标签过滤器,可以按指定标签进行匹配,支持对列表中的标签按 allanynone 匹配。

"Filter by tags" 过滤器配置界面,包含标签选择框和 "Matching" 匹配模式下拉框
"Filter by tags" 过滤器配置界面,包含标签选择框和 "Matching" 匹配模式下拉框

此外还新增了 "Add Tags" Workflow 操作,可以为当前资源一次性添加一组标签。

"Add Tags" 操作配置界面,包含标签选择框
"Add Tags" 操作配置界面,包含标签选择框

专属回忆页面

全新的回忆页面让你回顾过往的回忆。你可以收藏喜欢的回忆,收藏后会固定显示在此、不会被删除。我们希望这里成为一个随时可以回来重温旧时光的地方。

全新的回忆页面,展示过去几年间的各种回忆
全新的回忆页面,展示过去几年间的各种回忆
移动端 App 的回忆页面
移动端 App 的回忆页面

标签重命名(网页端)

最后,现在还可以对已有标签进行重命名了。这只是网页端标签编辑弹窗中的一个小改动,但背后的实现比想象中要复杂。

标签编辑弹窗,显示现在也可以编辑名称了
标签编辑弹窗,显示现在也可以编辑名称了

查看地图视口内的资产(网页端)

与点击地图上的聚合点后展示该簇所有资产的时间线类似,现在也可以为当前视口内的资产打开时间线。地图控件中新增了一个按钮,用于显示该区域内的资产,打开的时间线会随着地图的平移而实时更新。

地图页面,右侧显示当前视口内资产的时间线
地图页面,右侧显示当前视口内资产的时间线

老规矩,欢迎大家支持本项目。

🎉 干杯!🎉


一如既往,本次发布还修复了若干 bug,并带来了许多其他改进。

变更列表

🚀 新功能

  • feat: 工作流日志(by @benbeckford,#29878
  • feat(web): 全新搜索界面(by @benbeckford,#30279
  • feat: 新的配置端点(by @jrasm91,#30881
  • feat: 聚合分组(by @jrasm91,#30739
  • feat:资产文件 API,由 @jrasm91 贡献 #25900
  • feat:回忆视图,由 @benbeckford 贡献 #28675
  • feat(mobile):资产详情页显示资产所有者,由 @Lauritz-Tieste 贡献 #29302
  • feat(server):新增搜索 API,由 @timonrieger 贡献 #30179

🌟 功能增强

  • feat:专辑描述字段存储 null 而非空字符串,由 @gPinato 贡献 #30123
  • feat:迁移缺失时记录降级提示日志,由 @bo0tzz 贡献 #30493
  • feat(web):添加到专辑弹窗中支持搜索专辑描述,由 @djadji-gueye 贡献 #30462
  • feat:专辑选择弹窗标题显示已选条目数量,由 @statox 贡献 #30485
  • feat(widget):新增图标主题匹配开关,由 @bwees 贡献 #30428
  • feat:工作流资产标签触发器/过滤器/操作,由 @benbeckford 贡献 #29043
  • feat:iOS 动态背景 ID,由 @mikes1991gh 贡献 #30574
  • feat:操作撤销处理,由 @shenlong-tanwen 贡献 #30481
  • feat:API 密钥轮换,由 @bwees 贡献 #30801
  • fix(cli):启动时强制校验 Node 引擎版本,由 @bo0tzz 贡献 #30437
  • chore(server):迁移库 e2e 测试,由 @etnoy 贡献 #27277
  • feat:新增 OAuth 账户管理 URL,由 @sacha-c 贡献 #30873
  • feat(web):标签重命名 v2,由 @jorbrock 贡献 #27909
  • chore:搜索筛选动画优化及响应式搜索提示示例,由 @alextran1502 提交于 #30866
  • perf(web):上传文件哈希计算改用 hash-wasm SHA-1,并保留纯 JS 回退方案,由 @mosh-dev 提交于

评论 (0)