ZHA 深度配置与网络管理
进入 ZHA 设置
Settings → Devices & services → Zigbee Home Automation → 点集成卡片进入详情页。集成详情页分几个区域：
- Devices：已接入设备列表
- Groups：设备组
- Scenes：场景
- Settings：网络级配置（频道、适配器类型、OTA）
- Diagnostics：网络拓扑、健康状态、事件日志
Zigbee 频道选择
Zigbee 默认在 15 个频道中选一个。2.4GHz 的 Wi-Fi 和蓝牙会干扰 Zigbee——如果经常丢设备或延迟高，试试换个频道：
- ZHA Settings → Channel
- 选一个干扰少的频道（通常频道 15、20、25 在 Wi-Fi 拥挤地区表现更好）
- 修改后需要重启 Home Assistant 或 ZHA 集成生效
注意：换频道后所有已配对设备不会自动跟着换——你需要重新配网每个设备。所以换频道之前先确认确实需要换。
网络拓扑可视化
Home Assistant OS 上可以装 Zigbee2MQTT Network Map 或直接看 ZHA 的 Diagnostics → Network topology。可视化图能帮你：
- 看到哪些设备是路由器、哪些是终端设备
- 识别哪些设备是"孤立节点"（离适配器远信号差）
- 确认 Mesh 网络的覆盖是否均匀
理想拓扑：
- 每个 Zigbee 网络有 至少 2~3 个路由节点（任何 Zigbee 设备只要是插电的就是路由节点）
- 电池设备是终端，必须被路由节点覆盖
设备固件 OTA
很多 Zigbee 设备支持无线固件升级（OTA）。ZHA Settings 里可以开启 OTA：
- ZHA Settings → OTA updates → 开启
- 等待 Home Assistant 发现设备的可用固件更新
- 有更新时会在设备详情页显示，点进去可以升级
OTA 升级通常需要 5~15 分钟，升级期间设备不工作。升级前确保设备电量充足（电池设备）或正在通电。
常见问题修复
设备显示"Unavailable"
实体状态变成 unavailable 通常意味着 ZHA 检测到设备离线：
排查步骤：
- 检查设备是否通电/电池是否还有电
- 看设备是不是太远——离适配器 < 3 米内手动测试能不能恢复
- 检查 USB 适配器是不是松了——拔了重插
- ZHA Diagnostics 里看设备的
last_seen和lqi（Link Quality Indicator，越低越好）
LQI 参考值：
- < 50：信号好
- 50~100：信号一般
- > 100：信号差，考虑加路由节点或换位置
设备按键/操作没反应
- 先手动触发设备（比如手动开一下灯）看 ZHA 有没有检测到状态变化
- 如果手动也没变化，可能是设备固件太旧——OTA 升级
- 如果手动有变化但自动化没响应，检查自动化触发器写对没有（实体 ID 有没有写错）
适配器换了怎么恢复网络
如果你换了一个新的 Zigbee USB 适配器，原来的网络信息会丢。恢复方法：
- 旧适配器插到另一台电脑/树莓派上
- 备份 ZHA Settings → Backup（生成一个 .zip 文件）
- 插新适配器，选择 Restore from backup → 上传刚才的 .zip
- ZHA 自动恢复网络配置
- 所有设备不需要重新配对——网络密钥是一样的，Zigbee 设备记住的就是网络密钥
想彻底重建 ZHA 网络
只有在适配器彻底坏了、或者网络严重损坏（大量设备掉线且无法恢复）时才需要：
- 在 ZHA 设置里删除所有设备
- Settings → Devices & services → 移除 ZHA 集成
- 重新添加 ZHA → 创建新网络
- 一个一个重新配对所有设备（这步是最痛苦的，几十上百个设备要反复插拔）
关于 USB 适配器替换的建议
不要频繁换 Zigbee 适配器。换一次意味着整个网络的密钥可能变，所有设备要重配。选适配器时一次性选好，长期用下去。
Home Assistant Connect ZBT-1 官方适配器的优势在于有官方固件支持，未来可以升级 Thread 支持。其他适配器虽然便宜，但固件维护可能跟不上。