企业官网建设流程全解析

小米Home Assistant集成0.2.1更新后浴霸模式丢失？从自查到恢复的完整指南

【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home

小米 Home Assistant 集成（XiaoMi/ha_xiaomi_home）0.2.1 版本更新之后，奥普 S10M/S11M、易来 V5 等浴霸型号的模式控制实体悄悄消失了，设备页面只剩下一个灯光开关。如果你正被这个问题卡住，本文给出完整路径：症状自查、根因解读、五步恢复操作与恢复后的验证方法，每一步都标注了目的和易踩的坑。

一、先花三十秒自查：你的浴霸是否中招

受影响的是走小米生态接入、本次版本窗口内被修改过转换规则的"PTC 浴霸"类设备，机型对照如下：

再用"正常状态 vs 当前状态"对照一次：

• 正常状态：设备实体里除灯光外还有一个气候类实体，带模式选项（换气、暖风、干燥等），切换即时生效；
• 当前状态：设备在线、灯光照常开关，但模式选项整体查不到，引用旧模式实体的自动化报"实体不存在"。

两点都符合，基本可以判定是实体转换映射丢失，而不是设备故障，可按下面流程处理。

二、根因一句话：设备的"模式"属性没对上集成的转换规则

集成把小米云或中枢网关报来的设备属性翻译成 Home Assistant 里的实体，这一步靠一张"实体转换规则"表——用大白话说，就是决定"哪个属性显示成哪一类实体"的对应关系。这次更新中，浴霸对应的 ptc-bath-heater 服务规则被改动，而气候实体初始化开关功能时没有明确指定服务名与属性名，导致部分型号初始化时根本找不到"模式"属性：结果就是只生成灯光实体，模式实体直接消失。该问题已由 PR#899 修复（修正气候实体初始化的取值逻辑），规则定义可见 specv2entity.py。这也解释了症状的怪特征：设备本体没坏，坏的是"模式"到实体那一层的映射。

三、五步恢复：把模式实体重新加回来

⚠️ 动手前先备份 automation 与 lovelace 文件。重新添加设备后实体 ID 会变，旧引用需要重选。

1. 更新集成到包含 PR#899 的最新代码—— HACS 安装的就拉取最新版本，确保修复后的初始化逻辑落到本地；
2. 重启 Home Assistant—— 目的是让集成以新规则重新加载；跳过此步，后面勾选项不生效；
3. 在集成配置页同时勾选"更新实体转换规则"和"更新设备列表"—— 然后点"下一步"重新载入集成。前者把新规则应用到存量设备，后者刷新设备清单，两个都要勾；
4. 移除受影响的浴霸设备—— 只删奥普/易来这几台浴霸，其他设备不动，把影响面压到最小；
5. 重新添加该设备—— 配置流程里重新选择家庭与设备完成添加。此时集成会用修复后的规则重建这台设备的实体集合，模式实体随之生成。

四、恢复后的验证与残留风险

验证三件事：实体列表里浴霸除灯光外出现气候类实体；手动在暖风/换气/干燥间切换，状态与设备实际动作同步；把自动化里引用的旧模式实体替换为新实体并试触发一次。

残留风险主要是"静默失效"：自动化或场景里若还挂着未替换的旧引用，不会报错，只是永远不触发。建议对受影响家庭的自动化、场景整体过一遍；同批规则变更也波及空调与新风机，可顺手检查其他气候类设备有无类似缺实体现象。

五、让下一次升级更省心的三件事

• 先看发布说明再升级：版本说明里若出现"修改实体转换规则"这类字样（如 v0.2.2 对浴霸、空调、新风机规则的改动），先在备用实例上试；
• 升级前备份配置：成本几分钟，实体重建时能省下几小时；
• 反馈问题带上三件套：设备型号（如 aupu.bhf_light.s10m）、集成版本号、实体状态截图或日志——信息越全，修复合并得越快。

浴霸这类多合一设备，"一个功能对应一个实体"才是完整形态。下次更新后若发现某类实体少了，先查转换规则与配置页的更新选项，按上面的流程通常都能找回。

【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home