Immich-Kiosk v0.21.4版本发布：增强错误处理与设备识别能力

Immich-Kiosk是一个专为数字相框和展示场景设计的开源项目，它能够从Immich照片管理系统中获取媒体内容并以优雅的方式展示。该项目特别适合需要长期稳定运行的公共场所展示设备，如博物馆、商场或企业大厅的数字标牌系统。

最新发布的v0.21.4版本带来了多项实用改进，主要集中在错误处理机制优化和设备识别能力增强方面，这些改进使得系统在异常情况下更加健壮，同时也提升了用户体验的一致性。

错误自动恢复机制

在数字标牌应用中，网络不稳定或服务暂时不可用是常见问题。v0.21.4版本引入了一个智能的错误重试机制：当发生错误且刷新间隔(refresh)超过5秒时，系统不会无限等待，而是在5秒后自动切换到下一个媒体资源。这种设计既保证了在短暂网络波动时有足够的重试时间，又避免了因长时间卡顿而影响展示效果。

设备唯一标识改进

为了确保前端刷新后能保持一致的体验，v0.21.4改进了设备ID的生成方式。新版本结合了设备IP地址、浏览器用户代理(UA)和访问URL三个要素来生成唯一标识符。这种多维度的识别方式比单一依赖更可靠，特别是在以下场景中表现突出：

1. 设备因网络问题自动刷新后，仍能识别为同一设备
2. 多标签页访问时，每个标签页能获得独立的识别
3. 同一局域网下的不同设备能被正确区分

代理环境支持

针对企业级部署中常见的反向代理场景，新增了behind_proxy配置选项。启用该选项后，系统会优先读取X-Forwarded-For头信息来获取真实客户端IP，这对于以下架构特别重要：

• 使用Nginx/Apache作为前端代理
• 部署在负载均衡器后方
• 通过CDN加速访问

交互事件追踪

新增的user.interaction.clickwebhook事件为系统管理员提供了更丰富的用户行为数据。当访客与展示界面交互时，如点击屏幕或按钮，系统会触发相应事件，可用于：

• 分析用户兴趣热点
• 统计设备使用频率
• 构建用户行为漏斗

相册筛选增强

相册筛选功能新增了"owned"关键词，完善了现有的筛选体系。现在管理员可以通过以下关键词精确控制展示内容：

• all：显示所有相册
• owned：仅显示当前用户拥有的相册
• shared：显示共享给当前用户的相册
• favorites/favourites：显示收藏的相册内容

技术实现亮点

从技术实现角度看，这个版本体现了几个值得关注的工程实践：

1. 渐进式错误处理：不是简单的失败重试，而是结合时间阈值做出智能判断
2. 设备指纹技术：采用多因素识别而非依赖易变的Cookie或LocalStorage
3. 配置驱动设计：通过简单的配置开关适配不同部署环境
4. 可观测性增强：新增的webhook事件扩展了系统监控维度

这些改进使得Immich-Kiosk在稳定性、适应性和可管理性方面都有了显著提升，特别适合需要7×24小时稳定运行的商业展示场景。对于系统集成商而言，新版本提供了更灵活的部署选项和更完善的状态监控能力。