小米 Home Assistant 集成浴霸模式控制丢失完整修复指南
【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home
小米 Home Assistant 集成 ha_xiaomi_home 让你在 Home Assistant 中管理小米智能设备。自 0.2.1 版本起，有用户反馈浴霸的模式控制丢失，实体里只剩灯光开关。该问题已在 PR#899 修复，本文讲清现象、根因和修复步骤。
🧯 现场还原：浴霸只剩灯光，模式选项不见了
升级后打开浴霸的设备实体，模式控制（换气、暖风、干燥等）全部消失，只留下灯光开关。
受影响的型号：
- 奥普浴霸：aupu.bhf_light.s10m
- 奥普浴霸：aupu.bhf_light.s11m
- 易来浴霸：yeelink.bhf_light.v5
🔍 自查方法：三个判断点确认是否中招
按顺序核对以下三点，几分钟就能确认：
- 版本：集成当前是否为 0.2.1
- 型号：浴霸型号是否在上面列表里（可在米家 App 的设备信息中查看）
- 实体对比：该设备的实体列表里是否只剩灯光类实体，找不到模式选择器
根因分析：转换规则变化让模式属性落空
结论：0.2.1 更新调整了实体转换规则（即设备属性如何变成 Home Assistant 里可控制的开关/选择器），浴霸的模式属性因此没匹配上规则，模式实体没有生成。
因果链很短：
0.2.1 发布 → 设备属性与实体类型的映射变化 → 浴霸模式属性未匹配 → 模式实体缺失，只剩灯光。
控制链路本身是通的，问题出在实体生成这一步：
🛠️ 修复步骤：五步找回模式控制
- 更新集成到包含 PR#899 的最新代码 → 确认集成版本号已变化
- 重启 Home Assistant 服务 → 确认集成正常加载、设备重新上线
- 进入小米集成配置页面，勾选「更新实体转换规则」和「更新设备列表」→ 确认两项更新执行完成
- 移除受影响的浴霸设备 → 确认设备已从集成中删除
- 重新添加该设备 → 确认实体列表中模式控制重新出现
用户侧验证结论：奥普 S10M 和易来 V5 浴霸的模式控制已确认恢复正常。
预防建议：更新前做好三件事
- 备份配置后再更新集成 → 出问题时可以快速回退
- 更新前看一眼更新日志（中文文档有说明）→ 提前知道这次改了什么
- 更新后抽查关键设备的实体列表 → 缺失的实体早发现早报修
- 发现异常立即反馈 → 信息越早越全，定位越快
报障信息：这三样别缺
反馈给开发团队时，附上最小信息集即可：
- 设备型号（如 yeelink.bhf_light.v5）
- 集成版本号（如 0.2.1）
- 具体现象：哪些实体消失、更新前后的对比描述
【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
