小米智能家居接入 Home Assistant 实战指南
想要将家中的小米智能设备无缝集成到 Home Assistant 平台吗？本文提供一套完整的集成方案，从基础安装到高级配置，指导您实现跨品牌设备的统一管理。通过云端与本地双模式控制，您可以获得更稳定、更快速的体验。
集成前的准备工作
在开始之前，请确认环境满足以下条件：
- Home Assistant 设备（版本建议 ≥2024.4.4）
- 支持 Wi-Fi 或蓝牙的小米智能设备
- 有效的小米账号（用于云端认证）
- 局域网访问权限（用于本地发现）
三种主流安装方案
HACS 一键安装
这是最便捷的方式，适合大多数用户：
- 进入 HACS 界面
- 搜索 "Xiaomi Home" 集成
- 点击安装并重启 Home Assistant
- 在集成页面添加小米设备
Git 仓库克隆
如果您需要灵活管理版本，推荐此方法：
cd /config
git clone https://github.com/ha-xiaomi-home/xiaomi_home.git
cd xiaomi_home
./install.sh /config
手动文件复制
通过 Samba 或 FTP 服务，将 custom_components/xiaomi_home 文件夹复制到 Home Assistant 的 config/custom_components 目录下。
控制模式深度解析
云端控制架构
云端模式通过小米云服务管理设备，优势在于：
- 远程访问：随时随地控制家中设备
- 兼容性强：支持更多类型的小米设备
- 配置简单：适合初次使用的用户
核心配置文件位于：custom_components/xiaomi_home/miot/miot_cloud.py
本地控制架构
本地模式利用小米中枢网关在局域网内直接通信，特点如下：
- 极速响应：指令局域网传输，延迟更低
- 隐私安全：数据不经过云端
- 网络独立：断网也能控制设备
本地控制核心代码文件：custom_components/xiaomi_home/miot/miot_lan.py
配置流程逐步指导
账号登录与认证
在 Home Assistant 设置中，依次选择 "设备与服务" > "添加集成" > 搜索 "Xiaomi Home" > 点击 "小米账号登录"。
设备发现与导入
登录成功后，系统会自动弹出 "选择家庭与设备" 对话框，勾选要导入的设备即可。
多账号管理
完成首个账号配置后，可在已配置的集成页面继续添加其他小米账号，实现多账户统一管理。
支持设备类型
该项目支持丰富的小米智能设备，涵盖：
- 传感器：门窗、人体传感器等
- 照明：智能灯泡、台灯等
- ：智能插座、开关等
