小米 Home Assistant 集成更新后浴霸模式控制消失5 步找回【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home小米 Home Assistant 集成更新到0.2.1版本后部分用户发现浴霸实体只剩下灯光开关原本可用的换气、暖风、干燥等模式控制全部不见了。本文梳理该问题的触发条件、背后原因与一条已验证的修复路径。现象与触发条件症状设备实体中仅显示“灯”模式选择实体缺失。触发场景集成升级到0.2.1后重新添加设备或修改过实体转换规则后实体被重建。自查方法给浴霸通电后查看实体列表若模式项消失、灯光仍在基本可以确认命中此问题。波及面奥普浴霸aupu.bhf_light.s10m奥普浴霸aupu.bhf_light.s11m易来浴霸yeelink.bhf_light.v5仅“模式控制”一项受影响灯光开关与基础状态显示均正常。空调、风扇、扫地机等其他品牌与品类不在波及范围内不必恐慌。背后发生了什么集成的工作方式是先从 MIoT 规范拉取设备的原始属性清单再经过一层“实体转换规则”把每个属性映射成 Home Assistant 的对应实体——开关、选择器、气候等。0.2.1版本中bhf_light品类的模式属性没有对上设备规范里的实际字段于是模式属性在转换环节被当作“不认识”直接跳过而灯光属性匹配正常所以只剩下灯实体。也就是说设备本身没有问题问题出在中间的映射这一步指令链路断在了“属性 → 实体”这一环模式指令根本派发生成不到实体上。修复路线图该问题已在 PR#899 中修复。建议按顺序完成以下操作更新到包含 PR#899 的最新版本安装与更新方法可参考 doc/README_zh.md。重启 Home Assistant 服务让新规则生效。打开 Xiaomi Home 集成的配置选项页面勾选“更新实体转换规则”与“更新设备列表”。移除受影响的浴霸设备然后重新添加该设备。验证点设备实体下重新出现模式实体且切换换气、暖风、干燥均实时生效。五步全部完成后修复才算闭环。若只做了第 1 步旧的实体缓存仍会沿用症状不会消失。排查思路延伸对开发者而言这类问题有一条通用排查路径核对原始数据打印设备的 MIoT 原始规范确认模式属性真实存在且字段名正确。验证转换规则检查 custom_components/xiaomi_home/miot/specs/ 下的映射表确认该属性未被过滤或漏配。追踪指令链路发送一条模式指令确认它是否正确派发到 MQTT Broker 或网关侧的 HTTP 通道。原始数据正常而规则缺失改规则规则存在而指令不达查链路。定位问题基本都能在这三步之内收敛。少踩坑指南升级集成版本前备份配置目录出问题时可快速回滚到旧版本。定期查看 CHANGELOG.md确认新版本修复了哪些设备与属性。反馈问题时提供三要素设备型号、集成版本号、具体现象信息越全定位越快。修复完成后保持“实体转换规则”与“设备列表”同步更新避免新旧规则混用造成二次漂移。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考