尧图网页设计 
用 Home Assistant 掌控小米智能设备ha_xiaomi_home 手把手完整上手【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_homeha_xiaomi_home 是小米官方支持的米家集成组件它让你的 Home Assistant一个本地部署的智能家居中枢可理解为家里的总控台直接使用小米 IoT 设备。灯光、传感器、空调、扫地机等米家设备登录账号后就能以实体的形式出现在 HA 里参与自动化和语音控制。本文带你走完整流程准备 → 安装 → 登录导入 → 常用配置。动手前先确认这 3 样东西✅Home Assistant 版本达标Core ≥ 2024.4.4或 Operating System ≥ 13.0。打开设置 → 关于看一眼版本号不满足就先升级。✅一个小米账号登录用的是 OAuth 2.0 授权跳转小米官方页面点同意HA 不会存你的密码但账号里必须已经绑定了想导入的米家设备。✅能读写配置目录的权限配置目录是 Home Assistant 存放所有插件和数据的地方通常是/config。无论用哪种安装方式最终都是把组件文件放进去所以你需要能进这个目录。 如果你的米家设备在大陆以外的地区欧洲、印度、俄罗斯、新加坡、美国也无需担心配置时会让你选地区。三步装好 ha_xiaomi_home把组件放进配置目录方法一git clone推荐方便以后切版本在配置目录执行克隆并运行安装脚本脚本会自动把xiaomi_home组件复制到custom_components下cd /config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home.git cd ha_xiaomi_home ./install.sh /config如果你的配置目录不是/config把最后一行换成实际路径即可。看到installation is completed字样重启 Home Assistant组件就装好了。以后想升级或回退到指定版本切 tag 再跑一次脚本即可git fetch git checkout v1.0.0 ./install.sh /config方法二HACS 一键安装打开 HACS → 搜索框输入Xiaomi Home→ 进入详情页 → DOWNLOAD同样重启 HA 生效。方法三手动复制把custom_components/xiaomi_home文件夹整个拷进 HA 的config/custom_components目录可用 Samba、FTP 等适合不方便装 git 的环境。首次配置登录米家账号并导入设备安装完成后在 HA 界面完成登录打开设置 → 设备与服务 → 添加集成搜索Xiaomi Home点击下一步页面会提示你登录按提示用小米账号授权登录成功后弹出选择家庭与设备对话框——选择你要导入的米家家庭该家庭内的设备随即出现在 Home Assistant 里。 配置支持多账号已配置页点击添加中枢可以继续登录另一个小米账号不同账号的设备可以放进同一个区域。想深入了解界面背后发生了什么可以看这两个文件配置流程 config_flow.py登录、选设备、配置选项的界面逻辑都在这和 组件主文件init.py组件加载与实体创建的入口。它是怎么控制设备的云端或本地默认情况下控制走云端集成向小米云订阅设备消息设备状态一变立刻推送过来不用轮询控制指令经小米云 HTTP 接口下发。所以没有网关也能用只是响应依赖网络。如果你家里有小米中枢网关固件 3.3.0_0023 及以上或设备内置中枢网关软件 0.8.9 及以上该型号仅中国大陆可售就能走本地控制指令经网关内的 MQTT 消息总线直达设备断外网也能控制。⚠️ 还有一个局域网控制开关能实现部分本地化但它只管同局域网的 WiFi/网线设备管不到蓝牙 Mesh、Zigbee 设备且可能引起异常——官方建议不要开启除非你清楚自己在做什么。装完后常用的几个配置选项入口都在设置 → 设备与服务 → 已配置 → Xiaomi Home → 配置更新设备列表米家 APP 里新增了设备这里刷新一下就能同步进来还能顺便改用户昵称。Action 调试模式开启后带参数的设备方法会多出一个文本实体你可以手动输入参数发指令调试自动化前很好用。更新实体转换规则手动改了miot/specs下的规则文件过滤、改名、多语言等后必须点它才生效。语言配置界面支持中、英、日等 13 种语言。常见问题排查登录、设备、版本设备没出现先确认它是米家设备蓝牙、红外、虚拟设备暂不支持。再检查登录时选的家庭对不对、地区选对了没有不同地区数据隔离要选设备所在区域。登录失败或授权异常以项目实际界面为准重试若怀疑授权 token 泄露可去米家 APP → 我的 → 账号管理 → 应用授权移除 Xiaomi Home (Home Assistant Integration) 后重新登录。想回到旧版本用 git clone 方式安装的话git checkout到对应 tag 再跑一次 install.sh 即可这正是官方推荐 git 安装的原因。设备名显示是英文/乱码云端下发的多语言文件可被本地multi_lang.json覆盖补充改完后记得点更新实体转换规则。关键文件速查改代码前先看这里文件作用install.sh安装脚本把组件拷入配置目录config_flow.py登录与配置界面流程manifest.json组件版本与依赖声明doc/README_zh.md中文完整文档含实体映射规则小结装好 ha_xiaomi_home你只需要搜索 → 登录 → 选家庭三步米家设备就全进了 Home Assistant有中枢网关还能脱离外网本地控制。接下来可以围绕这些实体写自动化了。参考资源中文文档、更新日志 CHANGELOG.md、贡献指南 CONTRIBUTING.md。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 用 Home Assistant 掌控小米智能设备：ha_xiaomi_home 手把手完整上手
用 Home Assistant 掌控小米智能设备ha_xiaomi_home 手把手完整上手【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_homeha_xiaomi_home 是小米官方支持的米家集成组件它让你的 Home Assistant一个本地部署的智能家居中枢可理解为家里的总控台直接使用小米 IoT 设备。灯光、传感器、空调、扫地机等米家设备登录账号后就能以实体的形式出现在 HA 里参与自动化和语音控制。本文带你走完整流程准备 → 安装 → 登录导入 → 常用配置。动手前先确认这 3 样东西✅Home Assistant 版本达标Core ≥ 2024.4.4或 Operating System ≥ 13.0。打开设置 → 关于看一眼版本号不满足就先升级。✅一个小米账号登录用的是 OAuth 2.0 授权跳转小米官方页面点同意HA 不会存你的密码但账号里必须已经绑定了想导入的米家设备。✅能读写配置目录的权限配置目录是 Home Assistant 存放所有插件和数据的地方通常是/config。无论用哪种安装方式最终都是把组件文件放进去所以你需要能进这个目录。 如果你的米家设备在大陆以外的地区欧洲、印度、俄罗斯、新加坡、美国也无需担心配置时会让你选地区。三步装好 ha_xiaomi_home把组件放进配置目录方法一git clone推荐方便以后切版本在配置目录执行克隆并运行安装脚本脚本会自动把xiaomi_home组件复制到custom_components下cd /config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home.git cd ha_xiaomi_home ./install.sh /config如果你的配置目录不是/config把最后一行换成实际路径即可。看到installation is completed字样重启 Home Assistant组件就装好了。以后想升级或回退到指定版本切 tag 再跑一次脚本即可git fetch git checkout v1.0.0 ./install.sh /config方法二HACS 一键安装打开 HACS → 搜索框输入Xiaomi Home→ 进入详情页 → DOWNLOAD同样重启 HA 生效。方法三手动复制把custom_components/xiaomi_home文件夹整个拷进 HA 的config/custom_components目录可用 Samba、FTP 等适合不方便装 git 的环境。首次配置登录米家账号并导入设备安装完成后在 HA 界面完成登录打开设置 → 设备与服务 → 添加集成搜索Xiaomi Home点击下一步页面会提示你登录按提示用小米账号授权登录成功后弹出选择家庭与设备对话框——选择你要导入的米家家庭该家庭内的设备随即出现在 Home Assistant 里。 配置支持多账号已配置页点击添加中枢可以继续登录另一个小米账号不同账号的设备可以放进同一个区域。想深入了解界面背后发生了什么可以看这两个文件配置流程 config_flow.py登录、选设备、配置选项的界面逻辑都在这和 组件主文件init.py组件加载与实体创建的入口。它是怎么控制设备的云端或本地默认情况下控制走云端集成向小米云订阅设备消息设备状态一变立刻推送过来不用轮询控制指令经小米云 HTTP 接口下发。所以没有网关也能用只是响应依赖网络。如果你家里有小米中枢网关固件 3.3.0_0023 及以上或设备内置中枢网关软件 0.8.9 及以上该型号仅中国大陆可售就能走本地控制指令经网关内的 MQTT 消息总线直达设备断外网也能控制。⚠️ 还有一个局域网控制开关能实现部分本地化但它只管同局域网的 WiFi/网线设备管不到蓝牙 Mesh、Zigbee 设备且可能引起异常——官方建议不要开启除非你清楚自己在做什么。装完后常用的几个配置选项入口都在设置 → 设备与服务 → 已配置 → Xiaomi Home → 配置更新设备列表米家 APP 里新增了设备这里刷新一下就能同步进来还能顺便改用户昵称。Action 调试模式开启后带参数的设备方法会多出一个文本实体你可以手动输入参数发指令调试自动化前很好用。更新实体转换规则手动改了miot/specs下的规则文件过滤、改名、多语言等后必须点它才生效。语言配置界面支持中、英、日等 13 种语言。常见问题排查登录、设备、版本设备没出现先确认它是米家设备蓝牙、红外、虚拟设备暂不支持。再检查登录时选的家庭对不对、地区选对了没有不同地区数据隔离要选设备所在区域。登录失败或授权异常以项目实际界面为准重试若怀疑授权 token 泄露可去米家 APP → 我的 → 账号管理 → 应用授权移除 Xiaomi Home (Home Assistant Integration) 后重新登录。想回到旧版本用 git clone 方式安装的话git checkout到对应 tag 再跑一次 install.sh 即可这正是官方推荐 git 安装的原因。设备名显示是英文/乱码云端下发的多语言文件可被本地multi_lang.json覆盖补充改完后记得点更新实体转换规则。关键文件速查改代码前先看这里文件作用install.sh安装脚本把组件拷入配置目录config_flow.py登录与配置界面流程manifest.json组件版本与依赖声明doc/README_zh.md中文完整文档含实体映射规则小结装好 ha_xiaomi_home你只需要搜索 → 登录 → 选家庭三步米家设备就全进了 Home Assistant有中枢网关还能脱离外网本地控制。接下来可以围绕这些实体写自动化了。参考资源中文文档、更新日志 CHANGELOG.md、贡献指南 CONTRIBUTING.md。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考