Zigbee2MQTT 2.2.1版本发布：关键修复与新设备支持

项目简介

Zigbee2MQTT是一个开源的Zigbee网关解决方案，它允许用户通过MQTT协议将Zigbee设备连接到家庭自动化系统。该项目通过桥接Zigbee网络和MQTT协议，为用户提供了灵活的设备管理和控制能力，支持多种Zigbee设备并与主流智能家居平台兼容。

2.2.1版本更新亮点

本次2.2.1版本是一个热修复版本，主要针对2.2.0版本中引入的几个关键问题进行了修复，并新增了对3款设备的支持。

重要修复内容

1. 迁移问题修复
   解决了从1.x.x版本迁移到2.2.x版本时部分设置可能丢失的问题，确保用户升级过程中的数据完整性。

2. 环境变量引用问题
   修复了当环境变量设置为引用时可能导致设置被意外覆盖的问题，提高了配置的稳定性。

3. 设备兼容性修复

   • 修复了Livolo TI0001开关的配对问题
   • 解决了Tuya ZY-M100-S_2设备的亮度和存在检测功能
   • 优化了Sunricher系列设备的报告配置
   • 修复了LiXee设备可能导致MQTT连接中断的问题

4. 前端界面改进

   • 修正了设备离线状态显示问题
   • 优化了类型系统和图标显示

新设备支持

本次更新新增了对以下设备的支持：

1. Tuya Smart knob (ZG-101Z/D) - 一款智能旋钮控制器
2. Shelly 1PM Mini Gen 4 (S4SW-001P8EU) - 迷你型智能开关
3. Shelly 1PM Gen 4 (S4SW-001P16EU) - 标准型智能开关

设备识别改进

1. 正确识别_TZ3000_bmhwnl7s为Lonsonho TS130F_dual双路开关
2. 正确识别_TZE284_chbyv06x为DYGSM DY-RQ500A设备

升级建议

对于裸机安装(非Docker或HA插件)的用户，建议将NodeJS版本升级至22，以避免可能出现的兼容性问题。本次更新主要针对2.2.0版本的问题进行修复，建议所有使用2.2.0版本的用户尽快升级。

技术细节

在底层实现上，本次更新优化了配置管理系统的稳定性，特别是处理环境变量引用时的逻辑。在设备支持方面，不仅增加了新设备，还改进了现有设备的识别准确性和功能完整性。前端界面的改进使得用户体验更加直观和友好。

对于开发者而言，本次更新中的类型系统改进为后续开发提供了更好的基础，而设备支持的持续扩展则展示了项目的活跃度和社区参与度。