保姆级教程：用HACS给追觅扫地机装Home Assistant插件，实现iPhone家庭App远程分区清扫

零门槛实现追觅扫地机HomeKit分区控制HACS插件全流程指南在智能家居生态中苹果HomeKit以其出色的隐私保护和流畅的跨设备联动体验成为许多iPhone用户的首选。但对于使用追觅X10/X20等型号扫地机的用户来说官方App并未提供与HomeKit的直接兼容。本文将手把手教你通过Home Assistant的HACS商店安装插件实现扫地机在iPhone家庭App中的可视化控制特别是对分区清扫这一实用功能的深度整合。1. 环境准备与基础配置1.1 硬件与软件需求清单在开始前请确保已准备好以下条件兼容设备追觅X10/X20系列扫地机器人已连接Dreamehome或米家App运行环境已部署Home Assistant的设备树莓派/NAS/虚拟机等网络要求Home Assistant主机能够稳定访问GitHub资源软件版本Home Assistant Core ≥ 2023.12iOS设备 ≥ 15.0支持HomeKit最新功能提示可通过Home Assistant「配置」→「系统」→「关于」查看当前版本若版本过低建议先完成系统升级。1.2 HACS商店安装验证HACSHome Assistant Community Store是第三方插件市场我们需要先确认其正确安装# 在Home Assistant终端检查hacs目录 ls -l /config/custom_components | grep hacs若未安装可通过以下步骤快速部署访问HACS官网获取最新安装命令在Home Assistant「配置」→「加载项」中打开SSH终端粘贴官网提供的安装脚本执行安装完成后在侧边栏应出现橙色HACS图标。建议首次使用时刷新浏览器缓存CtrlF5。2. 追觅插件安装与账号绑定2.1 通过HACS获取dreame-vacuum集成不同于传统的手动下载安装方式HACS提供了更便捷的插件管理体验进入HACS →「集成」→ 点击右下角「浏览并下载存储库」搜索框输入dreame vacuum注意英文输入法选择Tasshack/dreame-vacuum项目在版本选择界面点击「下载」下载完成后会自动跳转到安装界面点击「重启Home Assistant」完成安装。整个过程约需3-5分钟取决于网络速度。2.2 账号配置关键细节在「配置」→「设备与服务」中添加集成时会遇到三种认证方式选择认证类型适用场景地图支持稳定性Dreamehome Account使用追觅官方App绑定设备✔★★★★★Xiaomi Home Account通过米家App绑定设备✔★★★☆☆Manual Connection无App绑定的基础控制✖★★☆☆☆推荐使用Dreamehome Account方式获取账号时需注意追觅ID在App「我的」→ 昵称下方显示新注册用户需在「账号设置」中单独设置密码地区选择必须与实际账号区域一致国内用户选CN若遇到持续转圈无法连接的情况可尝试以下排查步骤检查路由器是否屏蔽了海外API请求确认追觅App内设备在线状态正常重启Home Assistant服务后重试3. 房间分区与自动化创建3.1 提取房间ID映射表成功添加集成后在设备控制页面展开「扫地机」属性找到room字段。这里会显示所有已分区房间的详细信息例如room: [ {id: 16, name: 主卧}, {id: 17, name: 次卧}, {id: 18, name: 客厅} ]建议将各房间的id与name对应关系记录成表格备用。若此处显示为空需先在追觅App中完成地图分区设置。3.2 创建辅助开关与自动化通过辅助元素Helper将房间ID转化为可操作的实体进入「配置」→「设备与服务」→「辅助元素」创建类型选择「开关」命名规则建议采用清扫_房间名如清扫_主卧为每个需要独立控制的房间创建对应开关接着建立自动化规则核心参数配置如下alias: 主卧清扫触发 trigger: - platform: state entity_id: input_boolean.清扫_主卧 from: off to: on action: - service: dreame_vacuum.clean_segment data: segments: 16 # 对应房间ID注意服务名称必须完全匹配dreame_vacuum.clean_segment大小写敏感。4. HomeKit桥接与使用优化4.1 生成HomeKit控制入口在「配置」→「设备与服务」中添加HomeKit集成时建议按以下参数配置filter: include_entities: - input_boolean.清扫_主卧 - input_boolean.清扫_次卧 - vacuum.dreame_vacuum # 扫地机本体 mode: bridge提交后通知中心会出现8位配对码。在iPhone「家庭」App中添加配件时保持Home Assistant主机与iOS设备在同一局域网若扫描二维码失败可手动输入配对码添加成功后建议修改设备图标为「扫地机器人」4.2 Siri语音控制技巧通过创建场景Scenes可实现更自然的语音控制在HomeKit中创建名为「清洁主卧」的场景关联对应的房间开关设置触发短语如嘿Siri开始打扫主卧进阶技巧在Home Assistant中创建脚本将多个房间的清扫组合成场景命令例如morning_clean: sequence: - service: input_boolean.turn_on target: entity_id: input_boolean.清扫_厨房 - delay: 00:10:00 # 10分钟后 - service: input_boolean.turn_on target: entity_id: input_boolean.清扫_餐厅5. 常见问题解决方案5.1 地图无法显示的可能原因当Home Assistant中看不到清扫地图时可按此流程排查基础检查确认使用Dreamehome/Xiaomi Account认证方式检查追觅App中地图是否已保存重新启动扫地机本体电源网络诊断# 测试到追觅API服务器的连通性 ping api.dreame.com # 检查DNS解析是否正常 nslookup api.dreame.com日志分析 在Home Assistant「配置」→「日志」中过滤dreame关键词常见错误包括Invalid auth账号密码错误Timeout网络连接超时Map data empty设备未上传地图数据5.2 自动化执行异常处理若房间开关触发后无反应建议检查自动化配置中的segmentsID是否与当前地图匹配扫地机是否处于待机状态充电座接触不良会导致离线Home Assistant的时区设置是否与手机一致对于固件升级后的兼容性问题可尝试在HACS中重新安装dreame-vacuum集成删除并重新添加HomeKit桥接重置扫地机的Wi-Fi连接6. 进阶应用场景拓展6.1 与其他设备联动示例通过Home Assistant的自动化引擎可以实现更智能的清扫策略# 离家模式触发全屋清扫 - id: away_mode_clean trigger: - platform: state entity_id: person.家庭成员 to: not_home action: - service: input_boolean.turn_on target: entity_id: - input_boolean.清扫_客厅 - input_boolean.清扫_卧室 # 空气净化器与扫地机协同工作 - id: air_quality_clean trigger: - platform: numeric_state entity_id: sensor.客厅pm25 above: 35 action: - service: input_boolean.turn_on target: entity_id: input_boolean.清扫_客厅 - service: fan.turn_on target: entity_id: fan.空气净化器6.2 耗材寿命监控方案追觅插件提供的传感器数据可以用于创建提醒通知在「开发者工具」→「模板」中测试传感器值{{ states(sensor.dreame_vacuum_main_brush_life) }}%创建自动化在耗材即将到期时发送通知trigger: - platform: numeric_state entity_id: sensor.dreame_vacuum_main_brush_life below: 15 action: - service: notify.mobile_app_iphone data: message: 主刷寿命仅剩{{ states(sensor.dreame_vacuum_main_brush_life) }}%建议更换通过将这些数据暴露给HomeKit还能在家庭App中创建耗材看板。实际使用中发现追觅X20的边刷寿命通常在6-8个月左右而HEPA滤网根据使用频率约3-4个月需要更换。