保姆级教程：用HACS给追觅扫地机装上Home Assistant大脑，告别App切换

智能家居一体化：用HACS将追觅扫地机深度整合进Home Assistant生态

在智能家居设备井喷式增长的今天，每个品牌各自为政的App生态让用户陷入了"手机满屏应用却无法统一管理"的困境。特别是对于追觅扫地机器人这类高频使用的设备，单独操作App不仅效率低下，更无法与其他智能设备形成联动效应。本文将彻底改变这一局面——通过HACS商店的无缝集成，我们将把追觅扫地机深度融入Home Assistant智能中枢，实现以下突破性体验：

• 一站式控制：告别Dreamehome与米家App的反复切换
• 语音控制升级：通过HomeKit桥接实现Siri语音分区清洁
• 自动化革命：与家中其他设备形成智能场景联动
• 可视化操作：将晦涩的房间ID转化为直观的开关控制

1. 环境准备与HACS集成安装

1.1 系统基础检查

在开始集成前，需要确保您的基础环境满足以下要求：

若您尚未安装HACS，可通过以下命令快速部署：

wget -O - https://get.hacs.xyz | bash -

安装完成后需重启Home Assistant，并在"配置 → 设备与服务"中添加HACS集成。

1.2 Dreame Vacuum集成获取

HACS提供了两种安装方式，我们推荐优先使用商店直装：

1. 打开HACS → 集成
2. 点击右下角"浏览并下载存储库"
3. 搜索"dreame vacuum"（注意英文输入）
4. 选择测试版本（目前推荐v2.0.0b6+）
5. 点击下载并等待完成

提示：若下载速度不理想，可尝试在凌晨网络空闲时段操作，或使用海外服务器中转

安装完成后，建议执行以下检查清单：

• [ ] 查看日志中无报错（配置 → 日志）
• [ ] 集成页面显示"已安装"
• [ ] 重启后仍能正常显示

2. 设备连接与账号配置

2.1 平台选择策略

追觅设备通常支持两种连接方式，各有优劣：

Dreamehome Account模式

• 优点：支持完整地图功能
• 缺点：需要单独注册追觅账号

Xiaomi Home Account模式

• 优点：可直接使用米家账号
• 缺点：部分新型号可能功能受限

推荐按照以下流程决策：

graph TD A[设备型号] -->|X10系列| B(Dreamehome) A -->|早期型号| C(米家) B --> D[获取追觅ID] C --> E[使用米家账号]

2.2 认证信息获取实战

对于选择Dreamehome连接的用户，需要准备以下信息：

1. 打开Dreamehome App
2. 进入"我的"页面
3. 查看昵称下方的"追觅ID"（即登录账号）
4. 若未设置密码：
   • 进入"账号设置"
   • 选择"密码管理"
   • 设置符合要求的密码（需包含大小写字母和数字）

在Home Assistant中添加集成时，关键配置参数如下：

dreame_vacuum: account: "您的追觅ID" password: "您设置的密码" country: "CN" # 中国区账号固定填写CN devices: - device1 - device2

3. 房间映射与自动化构建

3.1 房间ID提取技术

成功连接设备后，获取房间信息的专业方法：

1. 进入集成设备控制面板
2. 找到"扫地机"实体
3. 展开属性中的"room"字段
4. 记录各房间的name-ID对应关系

典型房间数据结构示例：

{ "rooms": [ {"id": 16, "name": "主卧"}, {"id": 17, "name": "次卧"}, {"id": 18, "name": "客厅"} ] }

3.2 辅助元素创建指南

将技术参数转化为用户友好控制的关键步骤：

1. 创建辅助开关：

   • 配置 → 设备与服务 → 辅助元素
   • 点击"创建辅助元素"
   • 类型选择"开关"
   • 命名规则建议："清洁_房间名"（如"清洁_主卧"）

2. 配置自动化触发：

automation: - alias: "主卧清洁触发" trigger: - platform: state entity_id: input_boolean.clean_master_bedroom from: "off" to: "on" action: - service: dreame_vacuum.clean_segment data: segments: [16] # 对应房间ID

4. HomeKit整合与语音控制

4.1 桥接配置技巧

实现Siri控制的关键配置参数：

高级用户可添加以下自定义配置：

homekit: - filter: include_entities: - switch.clean_* entity_config: switch.clean_master_bedroom: name: "主卧清洁" switch.clean_living_room: name: "客厅清洁"

4.2 语音指令优化方案

让Siri响应更自然的技巧：

• 基础指令："嘿Siri，打扫主卧"
• 场景扩展：
  • "嘿Siri，开始全屋清洁"（联动多个开关）
  • "嘿Siri，厨房深度清洁"（设置清洁强度参数）
  • "嘿Siri，停止所有清洁"（紧急停止场景）

可通过Home App中的"快捷指令"功能，为复杂操作创建语音别名：

1. 打开家庭App
2. 选择"自动化" → "创建个人自动化"
3. 选择"当我说..."
4. 输入自定义短语并关联对应开关

5. 高级应用与故障排查

5.1 场景联动案例

与其他设备联动的典型场景配置：

下班回家自动清洁

automation: - alias: "工作日下班清洁" trigger: - platform: state entity_id: person.your_name to: "home" condition: - condition: time after: "17:00:00" before: "20:00:00" - condition: not conditions: - condition: state entity_id: vacuum.dreame state: "cleaning" action: - service: dreame_vacuum.clean_segment data: segments: [18] # 客厅ID

5.2 常见问题解决方案

地图不显示的可能原因：

1. 设备未完成首次全屋建图
2. 集成版本过旧（需≥v2.0.0b6）
3. 网络延迟导致数据同步失败

连接失败的排查步骤：

1. 检查账号密码是否正确
2. 确认设备在线状态（通过原厂App）
3. 尝试切换连接模式（Dreamehome/米家）
4. 查看Home Assistant日志获取详细错误

性能优化建议：

• 为Home Assistant主机分配固定IP
• 在路由器设置QoS保障智能设备带宽
• 定期清理旧日志（配置 → 系统 → 日志提供程序）

通过这套深度整合方案，您的追觅扫地机将不再是信息孤岛，而成为智能家居生态中会思考的清洁专家。当其他用户还在多个App间疲于切换时，您已经可以用一句语音指令或者一个自动化场景，让清洁工作智能地融入日常生活节奏。