介绍 Deebot 扫地机器人与 Home Assistant 的集成方法。涵盖 HACS 及手动安装步骤，Ecovacs 账号配置，以及基础控制、地图监控、自动化场景等核心功能。包含常见问题排查、网络优化建议及兼容性说明，帮助用户实现智能家居自动化清洁管理。
在开始配置前，请确保：
方法一：通过 HACS 安装（推荐）
方法二：手动安装
cd /config/custom_components
git clone <repository_url> deebot
通过 Home Assistant 服务调用，您可以实现更精细的控制：
# 刷新特定类别信息
service: deebot.refresh
target:
entity_id: vacuum.deebot_xxx
data:
category: "status"
# 可选值：battery, clean_logs, error, fan_speed, life_spans, rooms, stats, status, water
在配置流程中，您需要提供以下关键信息：
必填参数：
username：Ecovacs 账号用户名password：Ecovacs 账号密码country：所在国家代码continent：所在大洲代码可选参数：
client_device_id：客户端设备 ID（用于多设备管理）verify_ssl：SSL 证书验证（默认开启）实现精准的区域清洁控制：
# 在自动化中调用区域清洁
service: vacuum.send_command
target:
entity_id: vacuum.deebot_xxx
data:
command: clean_area
params:
rooms: ["卧室", "客厅"]
cleanings: 2
工作日自动清洁：
alias: "工作日自动清洁"
description: "工作日上班后自动启动清洁"
trigger:
- platform: time
at: "09:00:00"
condition:
- condition: time
weekday:
- mon
- tue
- wed
- thu
- fri
action:
- service: vacuum.start
target:
entity_id: vacuum.deebot_xxx
电池低电量提醒：
alias: "低电量提醒"
description: "电池电量低于 20% 时发送通知"
trigger:
- platform: numeric_state
entity_id: sensor.deebot_battery
below: 20
action:
- service: notify.mobile_app_phone
data:
message: "Deebot 电池电量低，请及时充电"
症状：设备显示"不可用"状态
解决方案：
症状：实时地图无法加载或显示空白
解决方案：
症状：设备频繁离线
解决方案：
本集成支持大多数 Ecovacs Deebot 系列设备，包括但不限于：
通过本指南，您已经掌握了 Deebot 与 Home Assistant 集成的完整流程。从基础安装到高级自动化，您现在可以充分利用智能扫地机的全部功能，打造更加智能、便捷的家居清洁体验。记住，良好的配置是智能家居成功的关键，定期检查和优化您的设置将确保最佳性能。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online