Immich v3.0.0 发布

# 发布 v3.0.0 | Immich 博客 来源：https://immich.app/blog/v3.0.0-release - 博客 (https://immich.app/blog) - 发布 v3.0.0 2026 年 7 月 1 日 — Immich 团队 *v3.0.0 版本发布说明——新周边、发布候选版本、移动端编辑、工作流、最近添加内容，以及更多！* 发布 (https://immich.app/blog?type=release) --- 欢迎来到 Immich `v3.0.0`！ 经过团队和优秀贡献者们数月的努力，我们激动地宣布 Immich 的下一个主要版本：`v3.0.0`！🎉 ## 重大变更 此版本包含若干重大变更；请在此处阅读完整的迁移指南 (https://immich.app/blog/v3-migration)。*值得一提的是，许多重大变更是针对 API 端点的更新，仅影响与 Immich API 集成的第三方工具*。对于绝大多数用户来说，更新方式与以往完全相同。 --- 迁移指南 (https://immich.app/blog/v3-migration) --- ## 如何更新 首先，将 `.env` 文件中的 `IMMICH_VERSION` 更新为 `v3`： 然后运行常规的更新命令： ## 发布候选版本 如果你错过了，`v3.0.0` 是我们首次使用发布候选版本（也称为预发布版本）。发布候选版本是经过测试但尚未正式发布的 Immich 版本，它们让我们能够在最终版本发布前发现并修复任何遗留的漏洞。如果你想通过 Immich 直接收到发布候选版本的通知，可以在 `管理设置 > 版本检查` 选项中将发布频道从“稳定版”更改为“发布候选版本”（此处 (https://my.immich.app/admin/system-settings?isOpen=version-check)）。 版本检查设置中的新发布频道选项 版本检查设置中的新发布频道选项 ## 新周边 作为此版本的一部分，我们很高兴地宣布还有一些新周边供你选择！ - 儿童服装：适合那些很可能是你 Immich 库规模增大原因的人 - 彩色刺绣：我们现在有全彩色刺绣 Immich 标志的服装 立即在 https://immich.store/en-eur/collections/immich-3-0 查看！ ## 亮点 现在，让我们直接来看这个版本中的所有新功能： - 移动端非破坏性编辑 - 工作流（预览版） - 后台备份改进 - 最近添加页面 - 完整性检查 - 移动应用幻灯片放映 - HLS 和实时视频转码（预览版） - 全新网页端视频播放器 - 在 Android 上以 Immich 作为图库打开照片 - 移动应用 OCR - 在移动应用中直接将资产上传到相册 - 在移动应用中分享时选择图片尺寸 - 浏览单个月份大量资产时的时间线性能改进 ### 移动端非破坏性编辑 这是对 `v2.5.0` 中发布的网页端图片编辑功能的跟进。此功能允许你在 Immich 内部对照片进行非破坏性编辑。在此之前，移动端编辑器使用了一套完全不同的系统，会创建新资产而不是原地编辑照片。 通过此次更新，我们为移动设备带来了一个新的、更易使用的编辑器，其功能与网页版相同。你现在可以直接在移动应用中编辑照片，包括裁剪、旋转和调整图像，而无需触及原始文件。与网页版类似，编辑是非破坏性的，因此你可以随时重新编辑或撤销修改。甚至可以在移动端进行编辑，然后在网页端进一步调整！ 之前移动端编辑实现中的某些功能已被移除，包括： - 照片重新着色 - 编辑实况照片 - 编辑本地资产 我们计划在未来版本中恢复其中一些功能。 ### 工作流（预览版） 工作流的第一个预览版来了！工作流允许你通过将触发器、过滤器和操作组合在一起，使用拖放式构建器来自动化库中的操作。这是未来许多令人兴奋的自动化功能的基础，我们很希望在继续完善它的过程中得到你的反馈。 你可以在网页端的 `实用工具 > 工作流` (https://my.immich.app/workflows) 访问此功能。 实用工具页面上的工作流链接 实用工具页面上的工作流链接 在那里，你可以创建一个新的空白工作流，或者浏览预先制作的模板，以了解工作流的基本用法。 工作流模板示例 工作流模板示例 #### 工作流编辑器 包含示例工作流的工作流编辑器 包含示例工作流的工作流编辑器 在工作流编辑器中，你可以在可视化编辑器或 JSON 编辑器之间切换。可视化编辑器适合构建工作流；JSON 编辑器适合与他人分享和接收工作流内容。 在每个工作流中，都有一个**触发器**和一系列**步骤**。 - 触发器：这是每个工作流的入口点；当触发器触发时，步骤会被评估。 - 步骤：包括过滤器（条件）和操作（效果）；它们可以组合起来产生你想要实现的用例效果。 可用工作流步骤列表 可用工作流步骤列表 #### 分享工作流 你可以通过两种方式与他人分享你制作的工作流：文本和 JSON。文本适合在论坛上分享或用于展示内容。JSON 适合让其他人精确复制你的工作流配置。 你可以从屏幕右下角的工作流摘要面板中复制文本 文本形式的工作流摘要 文本形式的工作流摘要 你可以通过应用栏中的“复制工作流”按钮分享 JSON 内容，切换到 JSON 编辑器，或使用工作流列表上下文菜单中的“显示模式”按钮 JSON 编辑器 JSON 编辑器 显示工作流模式 显示工作流模式 ### 后台备份改进 Android 上的后台备份现在显著更加可靠。以前，Android 上的后台备份仅限于最新拍摄的照片。现在，应用使用了一个新的周期性任务调度器，允许你在后台上传整个库，并且能更好地兼容 Android 的后台执行限制，正确地清理任务，并在电池优化和通知设置可能干扰备份时发出警告。 在 iOS 上，后台刷新任务现在并行运行其同步和上传工作，因此上传实际上会在 iOS 允许的短暂时间窗口内开始。 移动端启用备份选项 移动端启用备份选项 ### 最近添加页面 网页端和移动端新增了一个“最近添加”页面，让你可以按照资产被添加到 Immich 的时间（而非拍摄时间）来浏览库。这使得在浏览新导入的一批文件时，更容易找到新内容。你可以在网页端的“探索”选项卡和移动端的“搜索”选项卡中找到这个新页面。 探索页面上的最近添加行 探索页面上的最近添加行 ### 完整性检查 维护页面新增了一项功能：完整性报告！Immich 将扫描其文件系统上的目录，并与数据库中存储的内容进行比较。如果有偏差，将以以下形式呈现： - 未跟踪：如果 Immich 目录中存在 Immich 不知道的文件 - 缺失：如果 Immich 在数据库中引用的文件在该位置已不存在 - 校验和不匹配：如果磁盘上文件的校验和与 Immich 为该文件存储的校验和不匹配。通常，这可能是由于文件损坏造成的，但也可能是错误重命名或手动更改的结果。 维护页面上的完整性报告，显示未跟踪和缺失文件的数量，以及校验和不匹配。 维护页面上的完整性报告，显示未跟踪和缺失文件的数量，以及校验和不匹配。 你可以配置任务每日运行的时间和时长。 ### 幻灯片放映（移动端） 幻灯片放映功能来到移动端！你现在可以放松下来，让照片和视频在屏幕上自动播放，就像在网页端一样。 移动端幻灯片放映视图 移动端幻灯片放映视图 ### HLS 和实时视频转码（预览版） Immich 现在可以即时转码视频，而无需生成离线转码。这是一个长期要求的功能，具有许多好处： - 质量切换（手动和自动） - 转码为客户端支持的最佳编解码器 - 在禁用离线转码时降低存储开销 - 为兼容客户端提供 HDR（尚未实现） - 在带宽允许时进行混流而非转码（尚未实现） 请注意，此功能仍处于实验阶段，其行为可能在版本之间发生变化。目前仅在网页应用中实现，移动应用正在开发中。 要启用实时转码，请前往视频转码设置 (https://my.immich.app/admin/system-settings?isOpen=video-transcoding+realtime-transcoding)（向下滚动）。启用它不会直接影响离线转码，因此如果你想禁用离线转码，还应调整转码策略。 ![Immich 管理设置截图，显示一个新的部分“实时转码 [实验性]”](https://static.immich.cloud/blog/f044daa9-6bea-47e9-a8c8-5e97e617530a/bfff1a985fc347dd2cbb019d17262203.webp) Immich 管理设置截图，显示一个新的部分“实时转码 [实验性]” 请记住，你的服务器需要足够强大以进行实时转码，才能使此功能良好运行。使用此功能时，建议但不强制使用硬件加速。 ### 全新网页端视频播放器 网页应用中的全新自定义视频播放器确保你所有设备共享相同的控件和布局，与 Immich 的设计相匹配。一些基本功能，如更改播放速度，现已可用。这也应该解决 iOS 上的许多问题，此前操作系统的控件被隐藏在 Immich 导航栏后面。 ### 在 Android 上以 Immich 作为图库打开照片 Immich 现在可以在 Android 上充当图库/图片查看器应用。在另一个应用中点击照片或视频，选择 Immich，它会直接在资产查看器中打开，并提供分享文件或上传到库的选项。 这是该功能的首次迭代，关于 Immich 如何识别已在库中的文件的改进即将到来。 Android 上的“打开方式”对话框，显示 Immich 应用作为新选项 Android 上的“打开方式”对话框，显示 Immich 应用作为新选项 使用“打开方式”对话框后，移动应用资产查看器显示图像 使用“打开方式”对话框后，移动应用资产查看器显示图像 ### 移动应用 OCR 资产查看器现在有一个切换开关，可以高亮显示照片中识别出的文字，你可以直接从图像中选择和复制这些文字。 移动应用截图，显示图像中选中的文字 移动应用截图，显示图像中选中的文字 ### 在移动应用中直接将资产上传到相册 你现在可以直接将本地照片上传到移动应用中的相册，包括从资产底部面板进行上传，而无需先上传再整理。这一小改动大大减少了备份和整理流程中的摩擦。 ### 在移动端分享时选择图片尺寸 在移动应用中分享照片时，你现在可以在发送前选择图片尺寸；这对于保持分享文件较小以便在消息应用中使用非常方便，同时保留了在需要时以全质量分享的选项。 你可以在 `应用设置 > 偏好` 中更改默认行为 分享文件尺寸设置 分享文件尺寸设置 你也可以通过在分享时长按 `分享` 按钮来即时选择 即时选择器 即时选择器 ### 时间线性能改进 浏览包含大量资产的月份现在明显更加流畅，并防止了当实例遇到这种情况时浏览器标签页锁死。 ## 支持 Immich 如果你觉得这个项目有帮助，你可以购买产品密钥来支持 Immich：https://buy.immich.app/ 或我们的周边商品：https://immich.store/ ## 变更内容 ### 🚨 重大变更 - refactor!: 将 class-validator 迁移至 zod by @timonrieger in https://github.com/immich-app/immich/pull/26597 - refactor!: 移除 replace asset by @jrasm91 in https://github.com/immich-app/immich/pull/27022 - refactor!: 移除 my shared link dto by @jrasm91 in https://github.com/immich-app/immich/pull/27023 - chore!: 移除已弃用的环境变量 by @jrasm91 in https://github.com/immich-app/immich/pull/27802 - chore!: 移除 getRandom API 端点 by @bwees in https://github.com/immich-app/immich/pull/27780 - chore!: 移除未使用的 token response 参数 by @jrasm91 in https://github.com/immich-app/immich/pull/27805 - refactor: 清除旧时间线 by @shenlong-tanwen in https://github.com/immich-app/immich/pull/27666 - chore!: 移除旧时间线同步端点 by @jrasm91 in https://github.com/immich-app/immich/pull/27804 - chore!: 移除 deviceId 和 deviceAssetId by @danieldietzler in https://github.com/immich-app/immich/pull/27818 - chore!: 重命名 API key 模式 by @jrasm91 in https://github.com/immich-app/immich/pull/27828 - chore!: 移除 without assets by @jrasm91 in https://github.com/immich-app/immich/pull/27835 - fix: oauth issuerUrl 验证 by @bo0tzz in https://github.com/immich-app/immich/pull/27848 - fix!: 默认不允许不安全的 oauth 请求 by @bo0tzz in https://github.com/immich-app/immich/pull/27844 - fix!: 当 duration 不存在时设置为 null by @meesfrensel in https://github.com/immich-app/immich/pull/26982 - chore!: 移除 /api/server/theme 端点 by @jrasm91 in https://github.com/immich-app/immich/pull/27880 - chore!: 将 album owner 迁移至 album_user by @danieldietzler in https://github.com/immich-app/immich/pull/27467 - refactor!: 将 number 类型改为 integer 类型 by @timonrieger in https://github.com/immich-app/immich/pull/27912 - refactor(server)!: 将 correlationId 移至 X-Correlation-ID 响应头 by @timonrieger in https://github.com/immich-app/immich/pull/28139 - refactor(server)!: 移除错误响应中冗余的 error 和 statusCode 字段 by @timonrieger in https://github.com/immich-app/immich/pull/28140 - chore(server)!: 移除 pgvecto.rs (http://pgvecto.rs/) 支持 by @mertalev in https://github.com/immich-app/immich/pull/28159 - chore!: duration 改为毫秒单位 by @mertalev in https://github.com/immich-app/immich/pull/28003 - refactor(server)!: 清理错误消息以避免泄露资源详情 by @timonrieger in https://github.com/immich-app/immich/pull/28154 - refactor(server)!: 结构化验证错误响应 by @timonrieger in https://github.com/immich-app/immich/pull/28204 - feat(server)!: 为 albums API 添加 isOwned 过滤器 by @timonrieger in https://github.com/immich-app/immich/pull/28213 - chore(ml)!: 需要 numpy 2.4 by @mertalev in https://github.com/immich-app/immich/pull/28158 - fix(deps): 更新依赖 nestjs-otel 至 v8 by @renovate[bot] in https://github.com/immich-app/immich/pull/27863 - chore(ml)!: 移除已弃用的环境变量 by @mertalev in https://github.com/immich-app/immich/pull/28326 - chore(server)!: 移除 libopus 枚举 by @mertalev in https://github.com/immich-app/immich/pull/28325 - refactor!: 从 AssetResponseDto 中移除 asset faces by @bwees in https://github.com/immich-app/immich/pull/27779 - refactor(server)!: 移除空字符串到 null 的转换 by @timonrieger in https://github.com/immich-app/immich/pull/28808 - refactor(server)!: 移除 changeExpiryTime by @timonrieger in https://github.com/immich-app/immich/pull/28816 - refactor!: 禁止星级评分小于 1 by @meesfrensel in https://github.com/immich-app/immich/pull/27896 - fix!: 搜索端点 visibility 可被省略 by @danieldietzler in https://github.com/immich-app/immich/pull/29385 ### 🫥 已弃用的变更 - refactor(server): dep