Metadata-Version: 2.4
Name: vacuum-console-cli
Version: 1.0.0
Summary: 扫地机器人控制台（vacuum-console）连接器的 CLI 执行体：用命令行控制米家生态扫地/拖地机器人
License-Expression: LicenseRef-Proprietary
Keywords: xiaomi,miio,roborock,vacuum,robot-vacuum,扫地机器人,miot,smart-home,cleaning
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Home Automation
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: python-miio==0.6.0.dev0

# vacuum-console-cli

扫地机器人控制台（vacuum-console）连接器的 CLI 执行体。
用命令行控制米家生态扫地/拖地机器人（小米、石头老款、追觅等 200+ 型号）。

## 安装

```bash
python -m pip install vacuum-console-cli
```

内置 miIO 协议库（python-miio，GPL-3.0，作为 pip 依赖使用、不内嵌其源码），
无需编译器、无需访问 GitHub。

## 快速开始

```bash
# 起一个本地假扫地机（无真机走通全链路）
vacuum-console sim --start
vacuum-console --backend sim bind --auto
vacuum-console --backend sim start
vacuum-console --backend sim status

# 真机：绑定后直接用（省略 --backend）
vacuum-console bind --auto            # 或 bind --robot 客厅 --ip 192.168.x.x --token 32位token
vacuum-console status
vacuum-console start
vacuum-console fan --level turbo
vacuum-console home
```

## 命令一览

| 命令 | 说明 |
|---|---|
| `list` / `status` / `doctor` | 只读查询 |
| `start` / `pause` / `resume` / `stop` / `home` | 清扫控制（stop 无门槛） |
| `find` | 定位鸣声 |
| `fan --level silent/standard/turbo/max` | 吸力 |
| `volume --value 0-100` | 语音音量（部分机型） |
| `consumables` / `history` | 耗材余量 / 清扫历史 |
| `sim` / `verify` | 本地假设备 / 契约核对 |

## 安全

- `stop` 任何状态可用、无确认门槛
- 勿扰时段（22:00–08:00）远程 `start` 默认拦截，`--confirm` 显式放行
- 区域清扫默认关闭（`config --enable-zone` 开启）
- 不开放遥控摇杆、视觉/摄像头能力
- 全部控制指令写入 `~/.vacuum-console/audit.jsonl`
