保姆级教程：用HACS插件将追觅扫地机器人接入Home Assistant，实现苹果家庭App控制
保姆级教程：用HACS插件将追觅扫地机器人接入Home Assistant，实现苹果家庭App控制
智能家居的魅力在于让生活更便捷，而Home Assistant作为开源家庭自动化平台，能够将不同品牌的设备整合到一个系统中。对于追觅扫地机器人用户来说，通过HACS商店安装插件并接入Home Assistant，再桥接到苹果家庭App，就能用Siri语音控制分区打扫，实现真正的智能联动。本文将手把手带你完成整个配置流程，即使是Home Assistant新手也能轻松上手。
1. 环境准备与HACS安装
在开始之前，确保你的Home Assistant运行环境满足以下条件：
- 系统版本：Home Assistant Core 2023.7或更新版本
- 网络环境：能够稳定访问GitHub（建议测试
ping github.com） - 硬件设备：树莓派、NAS或其它运行Home Assistant的设备
HACS安装步骤：
- 登录Home Assistant后台，进入「开发者工具」→「模板」
- 在「模板编辑器」中输入以下命令并执行：
- url: https://github.com/hacs/integration/releases/latest/download/hacs.zip dest: /config/custom_components/hacs - 重启Home Assistant服务
- 重新登录后，在侧边栏会出现HACS图标
提示：如果遇到安装失败，可以尝试更换网络环境或使用手机热点。
2. 安装Dreame Vacuum集成
通过HACS安装追觅插件是最简单的方式：
- 打开HACS → 集成 → 点击右下角「浏览并下载存储库」
- 搜索框输入
Dreame Vacuum（注意英文输入） - 选择Tasshack/dreame-vacuum仓库
- 点击「下载」按钮，选择最新测试版本
- 下载完成后重启Home Assistant
版本选择建议：
| 版本类型 | 稳定性 | 功能完整性 | 推荐用户 |
|---|---|---|---|
| 稳定版 | ★★★★★ | ★★★☆☆ | 普通用户 |
| 测试版 | ★★★☆☆ | ★★★★★ | 高级用户 |
3. 设备连接与配置
完成插件安装后，需要进行设备绑定：
- 进入「配置」→「设备与服务」→「添加集成」
- 搜索并选择「Dreame Vacuum」
- 选择账号类型：
- Dreamehome Account：使用追觅官方App绑定的设备
- Xiaomi Home Account：使用米家App绑定的设备
- 输入追觅账号密码（账号可在App「我的」页面找到）
- 地区选择「CN」（中国区账号）
连接成功后，你会在设备列表中看到扫地机器人实体。点击进入可以查看详细状态和控制选项。
4. 创建分区打扫自动化
实现Siri控制分区打扫需要以下步骤：
第一步：记录房间ID
- 在设备控制页面找到「扫地机」实体
- 展开属性，找到「room」字段
- 记录每个房间的name和id对应关系
第二步：创建辅助开关
# 示例配置（每个房间创建一个） type: toggle name: "打扫客厅" icon: mdi:robot-vacuum第三步：设置自动化规则
alias: "客厅打扫自动化" trigger: platform: state entity_id: input_boolean.clean_living_room from: 'off' to: 'on' action: service: dreame_vacuum.clean_segment target: entity_id: vacuum.dreame_vacuum data: segments: 16 # 替换为实际房间ID第四步：HomeKit桥接配置
- 添加「HomeKit Bridge」集成
- 选择要暴露的实体：
- 扫地机器人主实体
- 所有分区打扫开关
- 生成二维码后用家庭App扫描添加
5. 常见问题排查
问题一：HACS安装失败
- 检查网络连接
- 尝试更换安装源：
wget https://mirror.ghproxy.com/https://github.com/hacs/integration/releases/latest/download/hacs.zip
问题二：设备无法连接
- 确认账号密码正确
- 检查地区设置（CN/Global）
- 尝试重新启动Home Assistant
问题三：地图不显示
- 确保在追觅App中已完成地图构建和分区
- 检查集成日志是否有报错
问题四：HomeKit无法添加
- 确认家庭中枢设备（HomePod/Apple TV）在线
- 检查网络是否在同一子网
6. 高级技巧与优化建议
地图优化方案：
- 在追觅App中完成全屋建图
- 设置合理的虚拟墙和禁区
- 保存多张地图（适用于多层住宅）
语音控制优化：
"嘿Siri，开始打扫客厅" "嘿Siri，停止扫地机器人"自动化场景扩展：
- 离家时自动全屋打扫
- 检测到空气质量差时启动扫地+拖地
- 与其它智能设备联动（如扫地时关闭窗帘）
实际使用中发现，定期清理机器人传感器和重置Wi-Fi连接能显著提高稳定性。对于200平米以上的大户型，建议设置分时段分区打扫以避免单次任务时间过长。