将小米智能家居设备接入 Home Assistant 平台的完整方案。内容包括集成前的准备工作，HACS、Git 克隆及手动安装的三种方式，以及云端和本地两种控制模式的架构解析。详细说明了小米账号登录、设备发现导入及多账号管理流程，列举了支持的各类设备类型。此外，还提供了设备发现优化、多语言配置、自动化场景创建等实用技巧，以及常见连接故障排查、响应延迟优化和安全隐私保护建议。
想要将家中的小米智能设备无缝集成到 Home Assistant 智能家居平台吗？本文为您提供一套完整的小米设备集成解决方案，从基础安装到高级配置，手把手指导您实现跨品牌设备的统一管理。通过云端控制与本地控制双模式，您可以获得更稳定、更快速的设备控制体验。
在开始集成前，请确保您已准备好以下条件：
通过 Home Assistant 社区商店进行安装是最便捷的方式：
如果您需要更灵活地管理版本，推荐使用此方法：
cd /config
git clone <repository_url>
cd ha_xiaomi_home
./install.sh /config
通过 Samba 或 FTPS 服务，将 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" > 点击"小米账号登录"
登录成功后，系统会自动弹出"选择家庭与设备"对话框，您可以选择要导入到 Home Assistant 中的设备。
完成第一个小米账号配置后，您可以在已配置的小米 Home 集成页面继续添加其他小米账号，实现多账户设备统一管理。
该项目支持丰富的小米智能设备类型，涵盖：
使用配置流程自动发现局域网内的小米设备，在 configuration.yaml 中添加：
xiaomi_home:
配置流程核心代码：custom_components/xiaomi_home/config_flow.py
项目提供完整的 13 种语言支持，包括简体中文、繁体中文、英文、西班牙语、俄语、法语、德语、日语、意大利语、荷兰语、葡萄牙语、巴西葡萄牙语和土耳其语。
多语言配置文件位于：custom_components/xiaomi_home/translations/
利用 Home Assistant 的自动化功能，您可以创建以下智能场景：
通过修改设备规格文件，您可以扩展支持更多设备类型：
设备规格文件：custom_components/xiaomi_home/miot/specs/spec_add.json
支持不同区域的小米设备统一管理，配置文件：custom_components/xiaomi_home/miot/miot_spec.py
小米 Home 集成采用官方 OAuth 2.0 登录流程，不会在 Home Assistant 应用中保存您的账号密码。但由于 Home Assistant 平台限制，成功登录后您的小米账号信息将以明文形式保存在配置文件中，请妥善保管您的配置文件。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online