在 Home Assistant (HA) 中接入小米设备，目前最主流、最好用的方案是通过 HACS 安装 Xiaomi Miot Auto 集成。
Xiaomi Miot 和 Xiaomi Cloud（通常指官方集成或通过云端获取信息的集成），这两者有本质的区别。
以下是详细的对比和教程。
第一部分：两者的区别
1. Xiaomi Miot Auto (推荐)
这是由国人大神（al-one）开发的第三方插件，目前是接入小米设备最强大、最通用的方案。
- 原理：基于小米最新的 MIoT 协议（小米物联网协议）。
- 优点：
- 支持设备极多：几乎支持所有接入米家 APP 的设备（包括蓝牙 Mesh 网关下的设备）。
- 本地控制：只要设备在同一局域网，它会优先尝试本地局域网控制（反应快、断网可用），无法本地时才走云端。
- 功能全：能读取设备的各种属性（如电量、温湿度、详细状态）。
缺点：需要安装 HACS（Home Assistant 社区商店）。
2. Xiaomi Miio (官方集成) / Xiaomi Cloud
HA 官方自带有一个 Xiaomi Miio 集成，有时也被用户笼统称为 Xiaomi Cloud 集成。
- 原理：基于较旧的 Miio 协议。
- 优点：系统自带，无需安装 HACS，稳定性高。
- 缺点：
- 支持设备少：主要支持扫地机、空气净化器、老款网关。对新款的插座、开关、传感器支持很差。
- 配置麻烦：往往需要手动提取设备的 Token 才能接入。
结论：请无脑选择 。它是目前的终极解决方案。
第二部分：详细安装教程 (Xiaomi Miot Auto)前置条件
- 你的 Home Assistant 已经安装并运行。
- 必须安装 HACS。如果你还没有安装 HACS，请先搜索“Home Assistant 安装 HACS”完成这一步（这是玩 HA 的必经之路）。
- 你需要有小米账号，并且设备已经添加到了手机上的“米家”APP 中。
步骤一：在 HACS 中下载集成
- 打开 Home Assistant 左侧菜单栏的 HACS。
- 点击 Integrations (集成)。
- 点击右下角的 Explore & Download Repositories (浏览并下载存储库)。
- 在搜索框输入：Xiaomi Miot Auto。
- 点击搜索结果中的 Xiaomi Miot Auto。
- 点击右下角的 Download (下载)。
- 下载完成后，必须重启 Home Assistant (配置 -> 系统 ->右上角电源按钮 -> 重新启动 Home Assistant)。
步骤二：添加集成并登录
- 重启完成后，点击左侧菜单栏的 配置 (Settings)。
- 点击 设备与服务 (Devices & Services)。
- 点击右下角的 + 添加集成 (+ ADD INTEGRATION)。
- 在搜索框输入 Xiaomi Miot，点击出现的 Xiaomi Miot Auto 图标。
- 配置方式选择：
- 你会看到几个选项，选择第一个 账号集成 (Add devices using Mi Account)。这是最简单的方式，它会自动从云端拉取你的设备列表。
输入账号信息：
- Username: 小米账号（手机号或ID）。
- Password: 小米账号密码。
- Server: 选择 CN (中国大陆) —— 除非你的米家APP区域选的是其他国家。
- 点击 提交 (Submit)。
步骤三：筛选设备 (可选)
登录成功后，集成会列出你米家账号下的所有设备。
- Exclude devices (排除设备)：如果你有些设备不想接入 HA，可以在这里勾选。
- Filter devices (筛选设备)：通常保持默认（Include all devices）即可。
- Connection mode (连接模式)：
- 建议选择 Automatic (自动)。
- 解释：它会自动检测设备是否在局域网内。如果在，就走本地控制（秒响应）；如果不在（比如蓝牙设备或不在同一WiFi），就走云端控制。
点击 提交 (Submit)。
步骤四：完成与使用
- 点击完成后，你会在“设备与服务”列表中看到 Xiaomi Miot Auto。
- 点击它，你会看到“XX 个设备”。点击进入即可看到你的台灯、插座、传感器等。
- 建议：
- 点击某个设备，查看其 实体 (Entities)。
- 你可以将这些实体添加到你的 HA 仪表盘 (Lovelace) 中进行控制。
第三部分：常见问题与进阶技巧
1. 关于本地控制 (Local) vs 云端控制 (Cloud)
如何判断？ 在 HA 的设备页面，点击该设备，查看属性。如果你看到 sub_type 或连接模式显示为 local，说明是本地控制。
为什么重要？ 本地控制不依赖互联网，反应速度极快，且保护隐私。
注意
：要实现本地控制，你的 HA 主机和小米设备必须在同一个局域网（同一个网段）。如果你有复杂的 VLAN 设置，可能需要开启跨网段的 mDNS 广播。
2. 蓝牙设备 (温湿度计、门锁)
蓝牙设备本身不连 WiFi，它们通过“蓝牙网关”连接到米家云端。
Xiaomi Miot Auto 接入这些设备通常是走云端 (Cloud) 的（因为 HA 无法直接通过 WiFi 连蓝牙设备）。
进阶玩法
：如果你想本地接入蓝牙设备，需要购买一个支持刷 ESPHome 的蓝牙接收器，或者利用 HA 主机自带的蓝牙功能配合 Passive BLE Monitor 集成（那是另一个话题了）。但对于新手，用 Xiaomi Miot Auto 走云端读取温湿度已经足够。
3. 设备实体名称乱码/过长
- 接入后，实体 ID 可能会很长（例如 switch.xiaomi_plug_v3_xxxx）。
- 建议在“设备”页面点击具体的实体，点击右上角齿轮图标，修改 Entity ID 和 名称，方便后续在自动化中调用。
总结
不要纠结于区别，直接使用 HACS 安装 Xiaomi Miot Auto，选择账号登录模式，这是目前接入小米全家桶最稳妥、最简单的“保姆级”方案。发帖者介绍-莱特智能成立于2010年，专注智能家居整体解决方案，Now ALL IN HA，欢迎淘宝搜索！
