ha_xiaomi_home 安装与使用快速接入小米设备【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_homeha_xiaomi_home 是小米官方支持的 Home Assistant 集成组件把米家 App 里的设备批量搬进 Home Assistant让你能在 HA 界面里直接控制小米设备、编写自动化。如果你正被小米设备对 HA 不可见的问题卡住它就是最短的解决路径。如何安装 ha_xiaomi_home先对照一下前置条件Home Assistant Core ≥ 2024.4.4官方硬性要求老版本装不上一个已添加好设备的米家账号走 git 方式的话机器上要能用 bash 和 git最短路径是命令行两步cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /config最后一行的参数是你的 HA 配置目录常见为 /config树莓派版多为 /configDocker 部署则映射到 /config。脚本会把组件复制进 custom_components 目录装完重启 HA 即可。不想碰命令行的话也可以用 HACS 一键安装或者手动把 custom_components/xiaomi_home 整个文件夹拷进配置目录效果一样。装好之后用起来是什么感受进入路径设置 → 设备与服务 → 添加集成 → 搜索 Xiaomi Home。登录页是小米官方的 OAuth 流程不保存你的密码授权后选择要导入的家庭该家庭下所有设备一次性进 HA。之后体验就普通了灯变灯实体温湿度计变传感器实体扫帚机器人变成可对话的真空机器人。面板上直接开关、调风速都能作为自动化的触发条件。比如写一条规则——湿度传感器超过 70% 就开除湿机——设备状态推送是实时的动作跟手。它的云通道走的是订阅制设备状态一变就推送到小米云的消息队列集成端订阅接收不用轮询所以状态刷新很跟手也不会给云端造成压力。上面这张图就是默认的云控制链路设备状态经 MQTT 消息总线推到集成端控制指令反过来走 HTTP 下发。家里有两个米家账号登录完成后在集成页面点 ADD HUB 就能加第二个账号不同账号的设备还能放进同一个房间分区。三个值得用的进阶技巧本地直连。如果你手上有小米中央网关或自带中央网关的设备本地模式会自己生效控制命令改走网关内嵌的 MQTT 总线不再绕云端响应明显更快。注意两点中央网关只在国内发售固件需 3.3.0_0023 及以上如果你没有网关别去开LAN 控制官方 README 明确建议不要使用它只覆盖 IP 直连设备且可能引起异常。自定义设备名称。实体名默认来自厂商在云端的定义想改就在配置目录的 custom_components/xiaomi_home/miot/specs/ 里改multi_lang.json它的优先级高于云端翻译还能顺手给漏翻译的字段补词。调试动作模式。在集成的 CONFIGURE 页打开 Debug mode for action带参数的动作指令会多出一个 Text 实体你可以照着页面上标注的参数格式比如[你好, true]直接发命令排查某台设备到底支持什么操作时非常好用。常见坑怎么处理部分设备没出现→ 蓝牙独占设备、红外设备、虚拟设备这三类目前不支持不是配置问题换别的集成或放弃。状态不刷新、控制变慢→ 云链路断了。先看网络有网关的再看网关是否在线能走本地就别依赖云。改了 specs 目录下的文件没生效→ 不用重启去 CONFIGURE 页点 Update entity conversion rules 刷新转换规则即可。看不到本地模式选项→ 中央网关仅限中国大陆地区海外账号只有云模式可选。登录或设备列表异常→ 导入时选的地区要和米家账号注册地一致不同地区的云数据是隔离的。如何保持更新这个集成更新很勤改动记录都写在 CHANGELOG.md 里。git 安装的话进仓库目录 pull 最新代码、重跑一次 install.sh 就算升级想退回某个版本checkout 对应 tag 再跑脚本即可。保持这个习惯新支持的设备型号和实体类型就会自动跟着进来。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考