九月回顾
2026 年 9 月回顾，包括即将推出的功能、版本发布、开发者动态等更新。
回顾
大家好！
又到了每月回顾的时间。这次有个令人兴奋的消息：人物与面孔共享功能已经上线，你可以在最新的 候选版本 中体验，预计下周随 v3.3.0 正式发布。另外，我们发布了 Docker Compose Builder，相册功能也将迎来改进，同时还在庆祝 进入稳定版一周年！更多详情请往下阅读。
人物共享
在改造 Immich 共享功能的路上，我们终于正式支持了人物共享。在 v3.2.0 中我们引入了 cluster groups（分组），让你自己的人物能出现在共享内容中——这一点在上个月的回顾里提过。不过那只是个基础，限制不少，也造成了一些困惑。通过这批新改进，我们希望整个功能更易理解、更易用，也更强大。
立即体验
v3.3 计划下周发布，但候选版本现在就可以试用。欢迎积极反馈——在正式发布前改动起来更方便，快把你的想法告诉我们吧！
共享全部人物
现在你可以把所有人物的访问权限共享给分组内的其他用户。开启共享后，你们会看到合并后的人物列表，查看和管理人物都更方便。
共享人物管理
共享他人访问权限的一个常见场景，就是允许多个用户协作添加姓名和生日。当然，也可能是一个人替所有人操作😂。我们正在开发访问管理功能，它支持双向控制，意味着你可以精确设定谁对哪些“人”拥有只读或读写权限。
Docker Compose 构建器
我们之前就开始着手开发基于 Web 的 docker compose 构建器，但一直没顾得上做完。这个月我们终于重新拾起这个项目（感谢 bo0tzz！），并成功将其推向发布阶段。
Docker Compose 构建器是一款简化工具，它能根据你的需求和环境生成可用的 docker-compose.yml 文件。过去我们使用 .env 文件进行部分定制，但这往往让用户对环境变量模板机制感到困惑。现在所有配置都集中在 docker-compose.yml 文件中，这不仅简化了部署流程，还提供了一种获取定制化配置的便捷方式。
如果你想知道更多细节，我们撰写了一篇博客详细介绍这款新工具：https://immich.app/blog/docker-compose-builder
相册功能改进
(jrasm91) 上周有个好笑的故事——我父母来城里探亲，想让我帮忙在 Immich 里处理些任务。其实他们只是想确认最近一次旅行的照片是否都已添加到共享相册里。我妈问我怎么改相册名（想和去年的那个保持一致）。我告诉她，如果她被加为编辑，应该就能改。结果发现，网页版和移动端 APP 都只允许相册所有者修改标题或描述，尽管 Immich 服务端的相册 API 明确允许编辑者执行这些操作。总之：现在相册编辑者也可以编辑相册标题和描述了。🎉
ESM 万岁！（也许）
在 Node.js 中，存在两种不同类型的模块：CommonJS (CJS) 模块和 ECMAScript 模块 (ESM)。CJS 长期以来一直是默认选项。尽管 ESM 作为现代继任者带来了许多改进，但由于兼容性问题，迁移过程缓慢且痛苦。
随着 NestJS 12 的发布，它终于引入了 ESM 支持。我们迫切希望完成迁移，因为我们基于 CJS 的服务器积累了越来越多的麻烦（比如，从 ESM 导入 CJS 再回到 CJS 似乎已经损坏了，如果你好奇的话）。越来越多项目实际上已迁移到仅 ESM 发布。因此，在仍以 CJS 运行的同时，我们开始需要导入越来越多的 ESM 包，遇到了一些边缘情况。
除了由于 @nestjs/cli 中的上游 bug 导致 tsconfig paths 解析初期遇到一些障碍，以及 tsc-alias 的一些问题外，迁移过程非常顺利，在一天内就完成了。
如果你感兴趣，这里是 PR：https://github.com/immich-app/immich/pull/31237. 结果发现这些变更相当简单明了。
路线图更新
和上个月一样，我们的重点依然是完善分享功能，争取早日把路线图上的这项划掉。不过现在还不是时候 ;)
版本发布
本月发布了 v3.2.0，以及四个后续补丁版本。另外还发布了两个 v3.3.0 的候选版本，计划下周正式发布 v3.3.0。
开发者动态——来自迷宫深处
团队成员对当前工作里好的、坏的、糟心的那些事，最真实的想法。
@alextran1502
人物分享功能逐渐成型，早期用户的反馈也很好，看着真让人高兴。我回头研究了一下“那个不能提名字的应用”和“高墙果园应用”是怎么处理人脸分享的，结果意外发现这些应用根本没这个功能。我之前一直以为用户是因为在别处用过才来提需求的。无论如何，Immich 是第一个全面实现这一功能的主流照片管理应用，我很自豪。了解过这项工作的复杂度之后，也就明白为什么其他应用没做——这确实不是个简单的功能。给团队点个大大的赞。
快到生日季了，我想在临近某人生日时展示“回忆”会很不错，让你意识到认识这个人已经过去了多久，更珍惜当下的时光。希望大家会喜欢这个版本里的生日回忆功能。接下来几个版本里，我还打算增加更多类型的回忆。
@jrasm91
和 Daniel 一样，人物分享/管理相关的改动占据了我这个月的大部分时间。这周我在想这件事时突然意识到，市面上没有任何照片管理系统的面部识别功能支持跨用户分享和管理。我自己就很期待能浏览到孩子们的标签人脸——毕竟那些照片大多是我妻子拍的。对特定人物把共享和自有的资产放在一起展示，很可能是 Immich 相比其他竞品的一大杀手锏。除此之外，我还帮了点 Docker Compose Builder 项目的忙，做了些小的清理和重构工作。
@danieldietzler
这个月对我来说特别忙碌。除了处理像 Immich 服务器 ESM 迁移这样的小型副线任务外，我把大部分时间投入到了人物共享和管理的相关改动上。随着集群分组的引入，我们解决了最大的技术难题。不过，本月在人物共享方面面临的 UX 挑战同样不轻松 😅。正如往常，让一项功能强大却又显得简单易用，绝不是一件容易的事。
由于这篇帖子写得实在很赶（我已经说过很忙了吗？），这就是我本月的更新内容 :D
下月计划
以上就是本月的情况。下个月我们计划对人物共享功能进行调优和增强，并可能会着手研究 PostgreSQL 18/19 的迁移。
一如既往，如果你觉得这个项目对你有帮助，欢迎通过 https://buy.immich.app/. 支持我们。
致敬，
Immich 团队