保姆级教程：用HACS给追觅扫地机装Home Assistant插件，实现苹果家庭App控制

保姆级教程用HACS给追觅扫地机装Home Assistant插件实现苹果家庭App控制智能家居生态的碎片化一直是用户体验的痛点。作为苹果用户你可能已经习惯了用家庭App统一管理各种设备但像追觅这样的国产扫地机器人往往无法直接接入HomeKit。本文将手把手教你通过Home Assistant这座桥梁让追觅扫地机完美融入苹果生态实现Siri语音控制、房间分区打扫等高级功能。1. 环境准备与HACS安装在开始前请确保你的Home Assistant以下简称HA运行在最新稳定版。打开HA的配置→系统→关于检查版本号是否在2023.12.x及以上。旧版本可能导致插件不兼容。HACSHome Assistant Community Store是第三方插件商店相当于HA的App Store。安装步骤在HA的文件编辑器中新建/config/custom_components文件夹访问 HACS官网 获取最新安装命令在HA的终端与SSH中执行wget -O - https://get.hacs.xyz | bash -重启HA后侧边栏会出现HACS图标提示如果使用群晖NAS可能需要通过Docker容器的Shell执行命令。遇到网络问题可尝试更换DNS为8.8.8.8。2. 安装Dreame Vacuum集成打开HACS后按以下步骤操作点击集成→右下角浏览并下载存储库搜索框输入Dreame Vacuum注意英文输入选择Tasshack开发的集成在版本选择界面推荐安装最新测试版通常功能更全点击下载后等待完成重启HA安装完成后检查/config/custom_components目录下是否出现dreame_vacuum文件夹。如果HACS安装失败可以手动下载下载方式链接提取码GitHub Releasehttps://github.com/Tasshack/dreame-vacuum/releases无阿里云盘https://www.alipan.com/s/ULo7Lvo2MLFz1g23. 账号绑定与设备连接进入HA的配置→设备与服务点击添加集成搜索Dreame Vacuum。这里会遇到三种认证方式Dreamehome Account推荐使用追觅官方App账号Xiaomi Home Account适用于绑定米家的设备Manual Connection无地图功能的基础连接以Dreamehome为例在追觅App中进入我的→查看追觅ID即账号同一页面设置密码新用户需先设置在HA中输入账号密码地区选择CN提交后保持默认选项完成添加常见问题排查如果长时间转圈检查HA主机能否正常访问api.dreame.xyz提示认证失败确认密码不含特殊字符或尝试重置密码设备未显示重启追觅机器人电源4. 分区打扫自动化设置要实现Siri打扫客厅这样的语音控制需要先获取房间ID在HA中打开Dreame Vacuum集成的设备页面点击扫地机控制卡片展开属性找到room字段记录各房间的name和id如未显示请先在追觅App中完成地图分区接下来创建辅助开关# 示例配置一个房间的辅助开关 type: toggle name: 清洁客厅 icon: mdi:sofa然后配置自动化规则触发条件辅助开关状态从关到开动作服务dreame_vacuum.clean_segment服务数据{ entity_id: vacuum.dreame_l10s_pro, segments: [123] # 替换为实际房间ID }5. 接入HomeKit完整流程在HA中添加HomeKit Bridge集成选择包含模式勾选扫地机实体排除以下非必要实体sensor.*_battery可能误报binary_sensor.*_errorHomeKit兼容性问题提交后在HA通知中心会生成二维码iPhone操作步骤打开家庭App点击添加配件扫描二维码设备类型选择扫地机器人按房间归类到相应区域高级设置技巧在家庭App中创建清洁场景组合多个房间利用Siri快捷指令实现更复杂的语音控制通过家庭App的地理围栏功能实现离家自动清扫6. 日常使用与维护建议设备状态监控主刷寿命sensor.dreame_main_brush_left边刷寿命sensor.dreame_side_brush_left滤网寿命sensor.dreame_filter_left清洁效率优化# 自动化示例根据污垢程度调整吸力 trigger: - platform: numeric_state entity_id: sensor.dreame_dirt_level above: 50 action: - service: vacuum.set_fan_speed data: entity_id: vacuum.dreame_l10s_pro fan_speed: Turbo地图不显示的解决方法检查追觅App是否开启地图保存功能重新登录Dreame Vacuum集成在集成配置中启用debug模式查看日志经过这样完整的配置你的追觅扫地机不仅能通过家庭App控制还能与HomePod、Apple TV等设备联动实现真正的智能家居体验。比如创建早安场景时可以设置咖啡机启动的同时开始厨房清洁。