核心用法
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 库，社区维护
- 跨平台：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 稳定性：第三方逆向实现，存在因官方协议变更导致功能失效的风险