Home Assistant 小米图标自定义：10 分钟搞定

Home Assistant 小米图标自定义10 分钟搞定【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home几十台小米设备图标几乎长一个样这篇 Home Assistant 小米图标自定义教程给你两条改法。照着 Home Assistant 小米图标自定义的步骤走10 分钟就能让每盏灯、每台空调都有自己的标识不用再靠名字硬认。动手前先确认三件事Home Assistant Core 版本 ≥ 2024.4.4系统核心版本设置 → 系统 → 关于可查xiaomi_home小米 Home 集成为最新版HACS → 集成 → xiaomi_home页面顶部即显示当前版本号目标小米设备已通过该集成接入设备面板里能看到对应实体快速验证一条就够打开 HACS → 集成 → xiaomi_home若版本号与最新版本一致说明前置条件全部满足可以直接开工。两条改图标的路径先选对再动手同一个集成里有两套控制链路改图标的方式完全不同选错路径会白忙一场对比项云端控制本地控制适用前提所有已接入设备必须配有小米中枢网关修改文件spec_modify.yaml规格补丁文件light.py 等设备类 Python 文件是否需重启需更新实体转换规则或重启不需要生效速度刷新规则后生效保存后立即生效判断方法很简单你的设备走的是经云端中转还是局域网直连面板设备信息里显示本地控制、且家里有小米中枢网关的走下文的本地路径其余一律走云端路径。云端路径改 spec_modify.yaml 让图标换脸为什么改这个文件云端模式下实体图标由 MIoT-Spec-V2小米 IoT 设备属性描述协议规格生成而 spec_modify.yaml 是集成读取规格后叠加的补丁层——在这里给某个属性补一个icon字段就能覆盖默认值无需改动规格本体。按定位 → 编辑 → 刷新三步走定位在设备详情页找到该设备的 URNurn:miot-spec-v2:device:...形式的规格唯一标识。编辑在你本地的集成目录中找到 spec_modify.yaml按 URN 追加条目只写要覆盖的字段urn:miot-spec-v2:device:plant-monitor:0000A030:hhcc-v1:1: prop.2.1: name: soil-moisture icon: mdi:watering-can # 换成你想要的图标刷新回到 Home Assistant进入 xiaomi_home 集成配置页 → 配置 → 更新实体转换规则或者直接重启 HA。⚠️ 注意改完文件不刷新规则图标不会变这是云端路径最常见的假失败。本地路径改一行代码保存即生效本地控制场景下实体由集成里的设备类直接渲染图标写死在代码里所以改法更直接。以灯光为例打开 light.py找到Light.__init__中设置图标的位置——xiaomi_home 图标修改在本地路径下通常就是这一行的事# Light.__init__ 内 if miot_device.did.startswith(group.): self._attr_icon mdi:lightbulb-group # 改成你的 mdi 图标把值换成目标图标如mdi:ceiling-light保存即可无需重启。其他平台同理去 switch.py、climate.py 等对应文件里找_attr_icon即可。再玩深一点按开关状态自动换图标固定图标只是起点。如果希望图标随设备状态变化可以在设备类里重写iconproperty而不是依赖写死的_attr_iconproperty def icon(self) - str: if self.is_on: return mdi:lightbulb-on return mdi:lightbulb-off开灯显示亮灯、关灯显示暗灯面板一眼就能分辨状态。逻辑可以换成任意属性比如空调的运行模式。多语言环境下的图标映射家里多人、多语言面板并存时multi_lang.json 支持按设备 URN 分语言覆盖显示内容键值格式为服务:属性路径{ urn:miot-spec-v2:device:plant-monitor:0000A030:hhcc-v1:1: { zh-Hans: { service:002:property:001:icon: mdi:watering-can } } }也就是说同一设备在不同语言界面下可以映射不同图标适合给家庭成员各自定制观感。图标没变按这张表排查现象大概率原因处理动作改了 spec_modify.yaml 图标没变没执行更新实体转换规则集成配置页手动刷新规则或重启 HA小米设备图标不显示变成问号或空白图标名拼写错误对照 Material Design Icons 官方图标库逐一核对图标名本地改完仍显示旧图标改错文件、缩进错误导致代码未执行确认改在对应设备类的_attr_icon处并查看日志有无语法报错通用排查思路一句话先确认改的文件真的被读取了再确认值本身合法——路径和刷新是云端路径的重灾区拼写和缩进是本地路径的重灾区。接下来可以试把同类设备收进同一个 URN 段落用 spec_modify.yaml 一次给一整类设备统一换图标批量配置比逐台改省事得多。更进一步把状态相关的图标逻辑接进自动化——比如设备离线时自动切换图标面板信息量会再上一个台阶。你的设备里哪一盏灯最值得先换上专属图标【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考