小米Home Assistant浴霸模式控制丢失完整修复指南：为什么0.2.1后只剩灯光，如何快速恢复-开发者社区

小米Home Assistant浴霸模式控制丢失完整修复指南：为什么0.2.1后只剩灯光，如何快速恢复

【免费下载链接】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 版本更新后，部分浴霸设备的"模式控制"功能出现了丢失，实体里只剩下灯光开关，换气、暖风、干燥这些模式选项不见了。本文带你快速定位是否中招，讲清根因，并给出三步恢复模式控制的完整修复路径。

发生了什么

先说真实体验：更新集成后，你打开家里那台浴霸，发现它变成了一个"只有灯"的设备——能开关灯，但再也选不到"换气""暖风""干燥"等模式，自动化里引用模式的动作也跟着失效。

对号入座，看看是不是你的情况：

受影响版本：0.2.1 更新后出现的现象（实体转换规则在该阶段发生了变化）
设备型号：奥普aupu.bhf_light.s10m、aupu.bhf_light.s11m，易来yeelink.bhf_light.v5（部分用户反馈同系列浴霸也有类似表现）
触发条件：集成版本更新后，浴霸的模式属性没有按新规则正确映射到 Home Assistant 实体，导致模式选项在实体中"消失"

自查：是不是中招了

逐条对照下面的可观察现象，命中越多，越大概率受此问题影响：

浴霸实体在 Home Assistant 里只剩一个灯光开关，看不到任何模式（preset mode / HVAC mode）选择项
设备详情页里原本可切换的"换气 / 暖风 / 干燥"等模式完全不见了
之前基于模式写的自动化或脚本报错，或提示属性/实体已不存在
更新集成版本后现象才出现，更新前一切正常
手动用米家 App 切换模式没问题，说明设备本身没坏，是集成侧没把模式映射出来

如果以上基本全中，你可以按后面的修复步骤操作。

为什么会这样

用一句大白话说：浴霸本身能发模式指令，但集成负责"翻译"设备属性——把小米设备的原始属性翻译成 Home Assistant 能识别的"实体"。这次版本更新改了翻译规则，浴霸的模式属性没被翻译到正确的实体类型上，于是模式在界面上"隐身"了。

打个比方：设备是一本外语书，集成是翻译。翻译没换就没事，这次翻译的字典改了，偏偏浴霸的"模式"那一章没对上词条，读者（Home Assistant）就只能看到"灯光"，看不到"模式"。

项目侧具体改动：0.2.1 阶段调整了 climate（温控/气候）类实体的转换规则，浴霸模式本应映射为 climate 实体的预置模式，但初始化时没有正确指定对应的 service 名和 property 名，导致模式控制链路没建起来。这个链路可以理解为：Home Assistant 发出set_properties/action控制消息 → 经小米云或中枢网关 → 下发到设备。链路任何一环没接上，模式就控不了：

开发团队已在PR #899中修复了该问题：在 climate 实体 on/off 功能初始化时正确指定 service 名与 property 名，让浴霸的模式控制指令能正确传递。

怎么修

按顺序操作，每步给出动作与预期结果：

更新到包含 PR #899 的最新版本—— 集成更新后，集成 > 小米的版本号应变为修复后的版本，日志无加载报错。
重启 Home Assistant—— 重启完成后，服务状态正常，集成重新加载。
进入小米集成配置页，勾选"更新实体转换规则"和"更新设备列表"（xiaomi_home > 配置 > 更新实体转换规则）—— 页面提示重新加载成功，设备重新导入。
移除受影响的浴霸设备—— 该设备实体暂时从 Home Assistant 中删除。
重新添加该浴霸设备—— 设备重新出现在实体列表里，且带出模式（preset mode）选项。

验证：打开浴霸实体，确认能看到并切换"换气 / 暖风 / 干燥"等模式；再触发一次模式切换，设备实际动作与界面状态一致，即修复生效。

提示：如果后续升级到会改变部分实体unique_id生成的版本，勾选"更新实体转换规则"可能影响已有自动化，建议先按项目说明评估是否需要对应补丁，避免自动化批量失效。

避免再踩坑

升级前先备份配置：导出当前自动化与集成配置，出问题时能快速回滚。
关注版本更新日志（CHANGELOG）：留意涉及 climate、浴霸、实体转换规则等字样的条目，更新前心里有数。
小范围试点更新：先在一两台设备上验证模式是否正常，再全量更新。
升级后做一轮实体核对：重点看浴霸、空调、新风机等 climate 类实体的模式是否还在。
发现问题按格式反馈，帮团队快速定位：
- 设备型号（如aupu.bhf_light.s10m）
- 集成版本号与 Home Assistant 版本
- 现象描述：缺了哪些模式、哪个实体、更新前后对比
- 关键日志点：集成加载报错、模式切换时的set_properties/action相关日志