3步完成小米设备图标自定义：HA图标修改完整指南

3步完成小米设备图标自定义HA图标修改完整指南【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home植物监测器的土壤湿度显示为通用传感器图标和温度传感器混在一起根本分不清。跟着下面 3 步即可完成小米设备图标自定义改一个 yaml 文件、点一次规则刷新新图标立即生效全程不用重启。图标由集成在本地解析设备规格文件MIoT-Spec-V2时确定不管你走云端还是中枢网关控制链路改图标的入口都是同一个配置文件。最快上手路径3步改出小米设备图标改配置文件打开配置目录/custom_components/xiaomi_home/miot/specs/spec_modify.yaml按设备型号搜到目标 URN在对应属性prop下加一行icon: mdi:xxx。刷新转换规则进入 设置 设备与服务 Xiaomi Home 选项勾选更新实体转换规则确认并点击下一步。验证效果✅刷新仪表盘图标立即生效无需重启 Home Assistant。注意刷新规则会重建本地缓存属于全局配置会影响所有集成实例稍等片刻执行完成即可。图标是怎么来的一张表看懂配置对应关系集成把设备规格转换成实体时图标来源有 3 个优先级先判断你的实体属于哪一层再动手改图标层级默认行为自定义方式对应文件device_class 标准图标由 device_class 决定如温度 →mdi:thermometer无法用 spec_modify 覆盖需调整映射去掉 device_classmiot/specs/specv2entity.py自定义属性图标默认无在 spec_modify.yaml 对应 prop 下加icon:字段spec_modify.yaml单位映射图标属性带单位时按icon_convert自动映射同一属性下加 icon自定义值优先miot/miot_device.py分场景实操单个实体改一个传感器图标的步骤以植物监测器的土壤湿度为例在设备信息卡确认型号再到规格文件中按型号搜出完整 URN。在对应 prop 下补上 icon 字段示例为集成内已有写法# 配置目录/custom_components/xiaomi_home/miot/specs/spec_modify.yaml urn:miot-spec-v2:device:plant-monitor:0000A030:hhcc-v1:1: prop.2.1: # 土壤湿度属性 name: soil-moisture icon: mdi:watering-can # 自定义为浇水壶图标保存后到选项页执行更新实体转换规则。刷新仪表盘该传感器显示新图标。批量场景一次配齐全屋新设备图标整屋新增设备时别逐个改先把配置写完再一次性刷新按型号逐个定位目标 URN把icon:行写进各属性格式照抄文件里已有条目。全部写完后执行一次更新实体转换规则完成后所有实体批量更新。# 以路由器下载/上传速度为例一次给两个属性补图标 urn:miot-spec-v2:device:router:0000A036:xiaomi-rd08:1: prop.2.1: icon: mdi:download # 下载速度 prop.2.2: icon: mdi:upload # 上传速度若某属性改完后仍没有实体生成检查spec_filter.yaml里是否把它过滤掉了。最常踩的2个坑坑1改完图标后一直显示旧图标现象yaml 已改图标没变化。原因图标来自本地规格缓存跳过更新实体转换规则时新配置不会被重新解析。解决回到选项页确认该操作真正执行且完成耗时稍长仍无效再重启 Home Assistant。坑2写了 icon 却不生效现象icon 已配置、规则也刷新了图标依旧。原因优先级为device_class 标准图标 spec_modify.icon 单位映射图标实体命中标准映射时自定义值被覆盖。解决确认实体是否带标准 device_class若有调整specv2entity.py中对应映射去掉 device_class 后自定义图标才会生效。一句话总结图标本质是spec_modify.yaml里的属性级配置URN、prop、刷新三步做对就不会错。如果图标已正确、实体名还是英文下一步建议阅读 CLAUDE.md 中对multi_lang.json本地翻译机制的说明把名称也改成中文。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考