小度智能设备接入 Home Assistant，支持小爱同学语音控制

GitHub 仓库地址：https://github.com/jukanntenn/ha-xiaodu

这是一个把小度智能设备接入 Home Assistant 的自定义集成，内置巴法云（Bemfa）同步，接入后即可让小爱同学控制小度设备，再配合 Home Assistant 米家集成，即可实现小度设备与米家生态的联动。

动机

我家买的精装房，开发商预装的智能家居只支持小度：灯具、空调等设备全部接在小度体系内，只能通过小度 App 和小度音箱控制；而自购设备当然优先选择米家生态。于是两套系统互不相通，家里智能设备处于脑裂状态：

1. 无法联动：小度设备进不了米家的自动化，米家的传感器也触发不了小度设备
2. 无法语音控制：家里的语音入口是小爱同学，它控制不了小度设备

后来小米开源了 Home Assistant 米家集成，于是我将米家设备全部接入了 Home Assistant，然后又在 GitHub 找了一款将小度设备接入 Home Assistant 的社区集成 hass_xiaodu，可惜这个项目已停止维护，在新版 Home Assistant 上无法使用。

于是我决定自己开发一个。考虑到 AI 编程已经越来越成熟，我把这个项目作为一次 AI 辅助开发的实践，从分析小度云端 API 开始，逐步完成了整个集成，也就是本文要介绍的 ha-xiaodu。

项目特性

• 多品类设备支持：灯、插座、墙壁开关、空调、窗帘、智能门锁、晾衣架等多类设备
• 零门槛接入：只需填入百度 Cookie（BDUSS），全程 Config Flow 图形化配置
• 房间自动映射：按名称相似度将小度房间自动匹配到 Home Assistant 区域，映射可逐个调整
• 巴法云同步：内置巴法云同步，按集成引导完成接入后，在米家 App 中绑定巴法云账号并同步设备，即可用小爱同学语音控制所有已接入的设备

实际效果

支持的设备与实测情况

测试状态分两级：

• 自动化测试 ✓：基于真实抓取的设备数据在模拟环境中运行
• 真机实测 ✅：已在实际设备上验证

下表除开窗器外均已有自动化测试覆盖：

受手头真机数量所限，很多品类的验证目前停留在自动化测试层面。如果你手上有这些设备，欢迎试用并反馈真机实测报告。

快速上手

以下是快速上手流程，更详细的安装和配置可参考 README。

1. HACS → 集成 → 右上角菜单 → 自定义仓库，填入 https://github.com/jukanntenn/ha-xiaodu，类别选「集成」，然后搜索 Xiaodu 安装，重启 Home Assistant
2. 设置 → 设备与服务 → 添加集成，搜索 Xiaodu，填入百度 BDUSS Cookie（获取方法见 README 的 FAQ）
3. 依次选择要同步的家庭、勾选设备、确认房间映射，完成接入
4. 可选：在配置流程中开启巴法云同步，再到米家 App 绑定巴法云账号，即可用小爱同学语音控制这些设备

欢迎试用、反馈与贡献

• 使用、配置、巴法云同步的问题 → Discussions 问答区；可复现的 bug 和具体功能请求 → Issues
• 任何变更（包括错字修正）都请先开 issue，PR 用 Fixes #NN 关联；新手可以从 good first issue 入手

这个项目从第一行代码起就是 AI 辅助开发的产物，仓库也欢迎 AI 辅助贡献。我会降低 AI 参与贡献的门槛、明确贡献规则，力争把项目打造成一个 AI 友好的开源项目。

后续计划

接下来将修复 bug、稳定配置格式与行为，随着真机实测报告的积累扩大验证覆盖，并逐步支持更多设备品类。欢迎有条件的用户试用并反馈。

License 与免责声明

项目基于 MIT License 开源。

本项目开发初衷仅为学习及技术交流，切勿将其用于任何非法用途，否则一切后果自负，与项目的作者无关。

-- EOF --

-- EOF --