通过 CLI 控制 Roborock 扫地机器人，支持状态查询、启停清洁、房间分区、耗材管理及地图操作。
说明：
## 核心用法
`roborock` CLI 提供完整的扫地机器人控制能力，需通过 `pipx install python-roborock` 安装。首次使用需执行 `roborock login` 登录账号并获取设备 ID。所有命令需指定 `–device_id` 参数。
### 主要功能模块
**基础控制**：`start`/`stop`/`pause`/`home` 控制启停与回充；`status` 实时查看状态。
**智能清洁**：支持房间分区清洁（`segment_clean –rooms`），需先通过 `roborock rooms` 获取房间 ID；可保存地图图片（`map-image`）。
**维护管理**：`consumables` 查看滤网、主刷、边刷寿命；`reset-consumable` 重置耗材计数器；`clean-record`/`clean-summary` 查看清洁历史。
**设置调节**：音量控制、勿扰模式、LED 状态、童锁等功能。
**交互模式**：`roborock session` 支持多命令会话，避免重复输入设备 ID。
## 显著优点
– **功能全面**：覆盖日常控制、维护、地图管理的完整需求
– **开源生态**：基于活跃的 [python-roborock](https://github.com/humbertogontijo/python-roborock) 库，社区维护
– **跨平台**：Python CLI，支持 macOS/Linux/Windows
– **设备兼容广**：支持 S/Q/E 系列及小米代工机型
– **自动化友好**：CLI 接口便于脚本集成与 Home Assistant 等场景联动
## 潜在缺点与局限性
– **依赖云端**：需登录 Roborock 账号，非纯本地控制
– **无官方背书**：非 Roborock 官方工具，API 可能随厂商更新而变动
– **首次配置繁琐**：需手动获取设备 ID，无自动发现机制
– **命令冗长**：需重复输入 `–device_id`，虽可用 session 缓解
– **调试困难**：部分错误静默失败，需 `-d` 调试模式排查
## 适合人群
– 技术用户、Home Assistant 玩家、智能家居自动化爱好者
– 需要批量管理多台设备的用户
– 希望脱离手机 App 进行快捷控制的用户
## 常规风险
– **账号安全**：凭证存储于本地，需确保 `.config` 目录权限
– **网络依赖**：设备与 CLI 均需联网，断网无法使用
– **操作误触**：`home` 等命令会立即执行，确认当前清洁状态再操作
– **API 稳定性**：第三方逆向实现，存在因官方协议变更导致功能失效的风险
会员专属
