
如何通过 HACS 一键安装 Xiaomi Home 集成并重启 Home Assistant【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home如果你已经在运行 Home Assistant希望把米家Xiaomi IoT设备接进来最省事的安装路径是通过 HACSHome Assistant 社区商店一键安装 Xiaomi Home 集成然后在重启 Home Assistant 后完成首次配置。官方文档对这套流程给出了明确前提Home Assistant Core 版本需 ≥ 2024.4.4Operating System 版本需 ≥ 13.0。本文只覆盖HACS 安装 → 重启 → 验证集成生效这一条路径不展开设备本地化控制等后续话题。安装前的版本核对开始之前先确认两个数字Home Assistant Core 版本 ≥ 2024.4.4以 Home Assistant Operating System 方式部署时系统版本 ≥ 13.0。这个要求与仓库的 hacs.json 一致该文件声明homeassistant: 2024.4.4、hacs: 1.34.0即安装仓库本身面向 HACS 1.34.0 及以上环境。版本不满足时先升级 Home Assistant再执行下面的步骤。前提还要求 HACS 商店在当前实例中已经可用本文档不再重复 HACS 自身的安装过程。在 HACS 中一键安装按 README中文版见 doc/README_zh.md给出的路径操作打开 HACS 界面在搜索框中输入Xiaomi Home在搜索结果中点击Xiaomi Home进入集成详情页点击DOWNLOAD等待下载与安装完成。README 中还提供了 HACS 官方跳转徽章One-click installation from HACS可直接在你的 Home Assistant 实例中打开该仓库的安装页。相比 README 中另外两种安装方式——git clone仓库后执行./install.sh /config或通过 Samba/FTPS 手动复制custom_components/xiaomi_home目录——HACS 方式不需要 shell 访问适合首次安装。重启 Home Assistant安装完成后必须重启 Home Assistant新集成才会被加载。项目自带的安装脚本 install.sh 在复制集成文件完成后的最后一步就是输出提示Xiaomi Home installation is completed. Please restart Home Assistant.HACS 安装路径与此一致下载完成后不要立即去配置页面找集成先完成一次 Home Assistant 重启。仓库文档没有给出统一的图形界面重启按钮位置请按你的部署方式执行重启例如通过部署环境提供的重启入口重启后集成才会出现在可添加列表中。验证集成是否生效重启完成后按 README 的配置入口验证打开Settings Devices services ADD INTEGRATION设置 设备与服务 添加集成搜索Xiaomi Home点击NEXT下一步进入登录页点击登录并使用小米账号完成 OAuth 2.0 授权登录成功后会弹出 Select Home and Devices选择家庭与设备会话框选择要导入的米家家庭该家庭内的所有设备将导入 Home Assistant。如果第 2 步能搜到Xiaomi Home且登录与选房流程能走通说明集成已正确安装并随重启加载成功。配置完成后可在Settings Devices services Configured Xiaomi Home设置 设备与服务 已配置 Xiaomi Home看到已配置的集成入口。注意由于不同地区小米云的用户数据相互隔离导入设备时需要选择用户所在地区官方文档说明可用地区为中国大陆、欧洲、印度、俄罗斯、新加坡和美国。限制与已知边界集成目前支持大部分米家设备品类但蓝牙设备、红外设备和虚拟设备不支持README 常见问题部分。登录成功后小米用户信息设备信息、证书、token 等会明文保存在 Home Assistant 配置文件中。OAuth 2.0 流程本身不会在 Home Assistant 中保存账号密码但配置文件仍需妥善保管怀疑令牌泄露时可在米家 APP 中进入小米账号管理页取消 Xiaomi Home (Home Assistant Integration) 的应用授权。下一步完成首个账号的设备导入后同一页面支持继续添加其他小米账号Settings Devices services Configured Xiaomi Home ADD HUB添加中枢走同样的登录流程即可。也可以在 CONFIGURE配置对话框中修改用户昵称、更新导入设备列表或开启 Action 调试模式。这些属于配置调整不影响本节的安装验证结果。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考