9月16日，知乎上冒出一个让很多HA玩家心头一紧的提问，标题写得直白：为什么homeassistant有两个xiaomihome集成？底下最高赞的回答只有一句话，带着怨气：必须买米家的中枢网关才能本地控制，你让我怎么看？知乎知乎
这条问题之所以在9月中旬被顶起来，是因为眼下在HA里接小米设备，你面前真实存在的门不止两扇：核心自带的 `xiaomi_miio`、小米官方2024年底放出的 `xiaomi_home`（添加集成和HACS里都叫"Xiaomi Home"），以及第三方长期维护的 `Xiaomi Miot Auto`。装错不是不能用，而是"你以为的本地"和"你以为的官配"可能对不上账。截至9月27日，我把三个仓库、官方README和社区反馈交叉核了一遍，这篇就干一件事：帮家里有一堆米家设备的HA玩家，把"装哪个、本地怎么真本地、账号怎么给"三笔账算清。
三扇门先认清身份
第一扇是HA核心内置的 `xiaomi_miio`，版本随HA每月更新，不需要HACS，但它对新款米家设备的适配一直是出了名的挑剔，主要覆盖老WiFi款，配置时得自己填token。
第二扇是小米官方开的 `Xiaomi Home` 集成（仓库 ha_xiaomi_home）。9月27日查GitHub：22.1k star、fork 1176，创建时间是2024年9月、年底正式发布。但注意一个容易忽略的事实：它最近一次打版本tag还是1月7日的 v0.4.7，main分支最后一次提交是9月24日，open issues挂着139条——代码在动，"正式版"节奏明显慢了下来。GitHub
第三扇是第三方作者al-one维护的 `Xiaomi Miot Auto`（hass-xiaomi-miot）。同一天的数据：6.1k star，v1.1.5发版于9月7日，仓库今天还有提交。一个22k star的官方项目快9个月没发版，一个6k star的第三方项目还在按周节奏动——这是选集成之前，社区帖子里很少明说、但实际影响"坏了找谁"的一条信息。GitHub
官方集成真正的门槛：不是装，是"本地"这两个字
很多人冲着"官方"二字装xiaomi_home，装完发现延迟、掉线一个不少。官方README里其实把路径写得很清楚，只是藏在FAQ里：
真正的全本地控制（local mode），需要一台中枢网关（固件3.3.0_0023及以上），或者"内置中枢网关功能"的设备（软件版本0.8.9及以上），且中枢网关只在中国大陆发售；没有中枢网关，所有控制指令走小米云。GitHub
README里还提供了一个"小米局域网控制"开关，但原文态度罕见地直白：只能控制同网段的IP设备（WiFi/网线），不支持BLE Mesh、ZigBee类设备，“可能导致异常，官方不建议使用”；并且只要家里局域网里存在中枢网关，这个开关即使开了也不生效。
也就是说，米家设备的"本地"是分层的：WiFi灯泡和蓝牙mesh灯带，走的根本不是同一条路。官方wiki（中枢网关设备清单页）还写得更狠：本地模式下，设备必须能把属性变化上报给本地broker，2021年之前发布的WiFi老设备大概率只会往云端上报——这些老伙计即使配了中枢网关，也照样回云端。你家里如果是"一堆WiFi插座+少量mesh传感器"的混搭党，本地覆盖率永远是个折扣数。而那句"你让我怎么看"的抱怨，本质就在这——官方把本地控制做成了一个硬件前置条件。GitHub
2026年8月底之后，这笔账有了新变化：小米首款NAS"智能存储"8月28日开售，4TB版2699起，集成了米家中枢网关；官方wiki的中枢网关设备清单里，路由器类（xiaomi.router.rp01/rp02/rp04等）也已经能内置中枢网关功能。对本来就想买NAS或换路由器的米家深度用户，"进本地"的成本被折叠进一台你反正要买的设备里——这是中枢网关单买时代没有的选择。需要留意的是，NAS评测里"本地响应比云端快3倍"目前是厂商口径，还没有独立实测数据。知乎
两个官方账号问题：多账号、明文token，以及一键撤销的路
给HA交小米账号之前，README安全段落有两句话值得所有人读完：
官方走的是OAuth 2.0登录，HA里不存你的小米密码，这点比早年手动填账号密码的方式干净。GitHub
但因为HA平台机制，登录成功后设备信息、证书、token会以明文形式存在HA配置文件里，配置文件泄露=别人可以拿你的身份登录。官方也给了反悔路径：米家App→我的→点用户名进小米账号管理→应用授权→找到"Xiaomi Home (Home Assistant Integration)"→移除。怀疑token泄露，撤销授权就在这里点，不用改密码。
另外多账号是官方集成的加分项：一个HA实例可以叠加登录多个小米账号，不同账号的设备还能挂进同一个房间——两口子各用各的米家账号的家庭，这在第三方时代是折腾半天才能凑出来的事。GitHub
装哪个：按设备构成对号入座
把三扇门拉平成一张决策表：
你的情况 | 建议 | 理由 |
|---|---|---|
新装HA，米家设备以WiFi款为主，先能用再说 | 官方xiaomi_home（云控制起步） | OAuth扫码级简单，多账号，实体映射规整 |
已有中枢网关/刚入小米NAS/内置中枢路由器 | 官方xiaomi_home + 本地模式 | 唯一官方认可的完整本地路径，固件先升到3.3.0_0023+ |
有蓝牙/红外/虚拟类设备或老款WiFi设备，官方清单不覆盖 | 第三方Xiaomi Miot Auto（host/token本地） | 官方明确不支持蓝牙、红外和虚拟设备三类；第三方可host+token纯本地控制 |
只有一两台老款扫地机/净化器，不想装HACS | 核心自带xiaomi_miio | 内置免安装，但要自己提取token |
两个第三方vs官方的隐藏差异也值得记：一是维护模式，第三方单人仓库出问题当天有提交，官方仓库快9个月没打tag，出问题得等；二是本地含义不同，第三方host/token是"你的HA直接对设备说话"，官方本地是"你的HA对中枢网关说话、网关再对设备说话"——都断网可用，但第三方的token是设备级凭证，泄露面比OAuth大，这也是它一直劝优先走云账号的原因。GitHub
三条通用的避坑：同一个设备不要同时被两个集成接管，实体翻倍、自动化各打各的；动任何迁移之前先备份HA configuration（明文token就存在里面）；从第三方迁官方（或反向）等于重做实体ID，9月HA更新里提醒过的自动化兼容性检查，这次同样适用。
值得继续盯的三个信号
官方xiaomi_home的下一个release tag（v0.4.7之后已经拖到9月）；中枢网关固件对HA本地模式的后续更新；以及第三方v1.1.5里刚合入的"本地设备要求"文档变更（#2803）——这三个动向任何一个落地，上面这张表的适用条件都要重算。GitHub
你家米家设备进HA走的是哪扇门？官方本地、第三方token还是纯云？评论区报一下设备构成（多少WiFi、多少mesh），下次可以把"真实本地覆盖率"的实测账补上。
