Roborock Vacuum Control

# Roborock Vacuum Control

通过 `roborock` 命令行界面控制 Roborock 扫地机器人。

## 首次设置

### 1. 安装 CLI ```bash pipx install python-roborock ```

### 2. 登录 Roborock 账户 ```bash roborock login ``` 输入您的 Roborock/小米家庭应用邮箱和密码。

### 3. 查找设备 ID ```bash roborock list-devices ``` 记下您的设备 ID（看起来像 `AbCdEf123456789XyZ`）。

### 4. 存储设备 ID（可选） 将其添加到您的 TOOLS.md 中以便参考： ```markdown ## Roborock Vacuum - **Device ID:** your-device-id-here - **Model:** Roborock S7 Max Ultra (or your model) ```

## 快捷命令

所有命令都需要 `--device_id "YOUR_DEVICE_ID"` —— 请替换为您的实际设备 ID。

### 检查状态 ```bash roborock status --device_id "YOUR_DEVICE_ID" ```

### 开始清扫 ```bash roborock command --device_id "YOUR_DEVICE_ID" start ```

### 停止/暂停 ```bash roborock command --device_id "YOUR_DEVICE_ID" stop roborock command --device_id "YOUR_DEVICE_ID" pause ```

### 返回充电座 ```bash roborock command --device_id "YOUR_DEVICE_ID" home ```

### 清扫特定房间 首先获取房间 ID： ```bash roborock rooms --device_id "YOUR_DEVICE_ID" ``` 然后清扫特定房间： ```bash roborock command --device_id "YOUR_DEVICE_ID" segment_clean --rooms 16,17 ```

## 维护命令

### 检查耗材 ```bash roborock consumables --device_id "YOUR_DEVICE_ID" ``` 显示滤网、刷子、传感器寿命。

### 重置耗材 ```bash roborock reset-consumable filter --device_id "YOUR_DEVICE_ID" roborock reset-consumable main_brush --device_id "YOUR_DEVICE_ID" roborock reset-consumable side_brush --device_id "YOUR_DEVICE_ID" ```

### 上次清扫记录 ```bash roborock clean-record --device_id "YOUR_DEVICE_ID" ```

### 清扫汇总（总计） ```bash roborock clean-summary --device_id "YOUR_DEVICE_ID" ```

## 地图与房间

### 获取地图 ```bash roborock maps --device_id "YOUR_DEVICE_ID" ```

### 缓存家庭布局 ```bash roborock home ```

### 保存地图图像 ```bash roborock map-image --device_id "YOUR_DEVICE_ID" --output /tmp/vacuum-map.png ```

### 房间功能 ```bash roborock features --device_id "YOUR_DEVICE_ID" ```

## 设置

### 音量 ```bash roborock volume --device_id "YOUR_DEVICE_ID" roborock set-volume 50 --device_id "YOUR_DEVICE_ID" ```

### 勿扰模式 ```bash roborock dnd --device_id "YOUR_DEVICE_ID" ```

### LED 状态 ```bash roborock led-status --device_id "YOUR_DEVICE_ID" ```

### 童锁 ```bash roborock child-lock --device_id "YOUR_DEVICE_ID" ```

## 交互式会话 用于执行多个命令而无需重复输入设备 ID： ```bash roborock session --device_id "YOUR_DEVICE_ID" ```

## 故障排除

**命令静默失败：** 1. 检查登录：`roborock login` 2. 使用调试模式：`roborock -d status --device_id "YOUR_DEVICE_ID"` 3. 确保吸尘器在线并已连接 WiFi

**“未找到设备”：** - 运行 `roborock list-devices` 以验证设备 ID - 确保您已登录正确的 Roborock 账户

**“身份验证失败”：** - 重新运行 `roborock login` - 检查您使用的账户是否与小米家庭 / Roborock 应用中的账户一致

## 常见任务

**“清扫全屋”：** ```bash roborock command --device_id "YOUR_DEVICE_ID" start ```

**“清扫厨房”：** ```bash roborock rooms --device_id "YOUR_DEVICE_ID" # find kitchen room ID roborock command --device_id "YOUR_DEVICE_ID" segment_clean --rooms <kitchen_id> ```

**“吸尘器完成了吗？”：** ```bash roborock status --device_id "YOUR_DEVICE_ID" ```

**“让吸尘器回家”：** ```bash roborock command --device_id "YOUR_DEVICE_ID" home ```

**“上次清扫是什么时候？”：** ```bash roborock clean-record --device_id "YOUR_DEVICE_ID" ```

**“检查刷子/滤网寿命”：** ```bash roborock consumables --device_id "YOUR_DEVICE_ID" ```

## 支持的型号

适用于大多数 Roborock 吸尘器，包括： - Roborock S 系列（S4、S5、S6、S7、S8） - Roborock Q 系列（Q5、Q7、Q8） - Roborock E 系列 - 小米米家扫地机器人（基于 Roborock）

## 致谢

使用 [python-roborock](https://github.com/humbertogontijo/python-roborock) 库。