小米 Home Assistant 集成浴霸模式控制升级后消失：快速修复与四步恢复完整指南
【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home
小米 Home Assistant 集成（ha_xiaomi_home）升级到 0.2.1 后，奥普、易来等浴霸的模式控制（换气、暖风等选项）不见了，只剩灯光开关。别慌，该问题已修复，奥普 S10M、易来 V5 用户照下面四步操作即可恢复。
如何判断自家浴霸型号是否受影响
先看型号。受影响的型号有三个：
- 奥普浴霸
aupu.bhf_light.s10m - 奥普浴霸
aupu.bhf_light.s11m - 易来浴霸
yeelink.bhf_light.v5
再看现象，两条同时满足基本就中招了：
- 浴霸卡片上只剩一个灯光开关，原本的模式选项（换气、暖风、干燥）整个消失；
- 集成版本正是 0.2.1 前后的升级产物。
型号 + 版本 + 现象三样对上，就可以按下面的步骤操作了。
四步恢复浴霸模式控制
- 更新集成：把小米集成升级到包含 PR#899 修复的最新版本。
- 重启服务：重启 Home Assistant（大白话：把 HA 主程序停掉再拉起来，让新代码生效）。
- 勾选两个选项：进入小米集成的配置页面，勾选"更新实体转换规则"和"更新设备列表"后继续。实体转换规则可以理解为"设备数据 ↔ HA 控件"之间的对照表，这一步就是让对照表重刷一遍。
- 移除再添加：把受影响的浴霸设备移除，然后重新添加。
✅ 预期效果：重新加载完成后，浴霸卡片会重新出现模式控制选项，切换换气、暖风等功能恢复正常。这一步组合拳已在奥普 S10M 和易来 V5 上得到用户验证。
背后发生了什么
这次升级改动了浴霸这类"气候类实体"（HA 里承载温度/模式等控制的面板）的转换规则：集成在初始化开关和模式功能时，没有准确说明该去读哪个服务、哪个属性，导致模式属性没被正确映射到实体上，设备就被"降级"成了纯灯具。PR#899 的修复就是在初始化时明确指定服务名和属性名，重新加载映射后，模式指令就能正常发回设备了。相关映射规则的源码可以在 miot/specs/ 目录下找到。
控制指令在设备与集成之间的传递链路（以本地控制为例）大致如下：
避坑清单
- 升级前备份 HA 的配置文件，留好回退退路
- 升级后先看一遍更新日志，留意"实体转换规则有变更"这类提示
- 发现异常先记录设备型号（品牌.品类.型号 格式）并给实体卡片截图，再反馈
- 更新后养成习惯：进配置页勾选"更新实体转换规则"再重载
- 自动化里引用过该实体的，恢复后顺手检查一遍
常见问题
Q：重新添加设备后，之前写好的自动化还有效吗？A：设备重新添加后实体 ID 可能变化，引用旧实体的自动化需要改成新实体。建议恢复完成后在自动化里搜一下浴霸相关条目，逐个核对。
Q：一定要移除再添加吗，只勾"更新实体转换规则"行不行？A：多数情况下只勾选重载就能恢复；但如果重载后模式选项仍然没回来，就按第 4 步移除并重新添加，让集成完整重读设备属性，这是最稳妥的办法。
【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
