xiaomi-home

# 小米智能家居控制

你可以通过 MCP Server 提供的工具控制用户家中的小米/米家智能设备。

## 可用工具

MCP Server `xiaomi-home` 提供以下工具：

| 工具 | 用途 |
|------|------|
| `xiaomi_list_devices` | 列出所有设备，获取设备 did |
| `xiaomi_find_device` | 按名称模糊搜索设备 |
| `xiaomi_get_properties` | 读取设备属性 |
| `xiaomi_set_property` | 设置设备属性 |
| `xiaomi_call_action` | 调用设备动作 |

## 工作流程

### 第一步：定位设备

从用户的自然语言指令中提取设备关键词，用 `xiaomi_find_device` 搜索。

例如用户说"把客厅的灯关掉"，提取"客厅"或"灯"进行搜索。

如果没有找到，尝试用 `xiaomi_list_devices` 列出所有设备，让用户确认。

### 第二步：查询设备规格

拿到设备的 `model` 后，需要知道该设备支持哪些 siid/piid。

常见设备的 MIoT 规格：

**开关类设备（灯、插座、开关）**
- siid=2, piid=1: 开关 (bool)
- siid=2, piid=2: 亮度 (uint8, 1-100)
- siid=2, piid=3: 色温 (uint32)

**空气净化器**
- siid=2, piid=1: 开关 (bool)
- siid=2, piid=5: 模式 (uint8, 0=自动 1=睡眠 2=喜爱 3=手动)
- siid=2, piid=8: 风速等级
- siid=3, piid=6: PM2.5 (只读)
- siid=3, piid=8: 温度 (只读)
- siid=3, piid=7: 湿度 (只读)

**电暖气/取暖器**
- siid=2, piid=1: 开关 (bool)
- siid=2, piid=2: 目标温度
- siid=2, piid=3: 模式

**风扇**
- siid=2, piid=1: 开关 (bool)
- siid=2, piid=2: 风速等级
- siid=2, piid=3: 摆头 (bool)
- siid=2, piid=4: 模式

**扫地机器人**
- siid=2, piid=1: 状态
- siid=2, piid=2: 模式
- siid=2, aiid=1: 开始清扫（动作）
- siid=2, aiid=2: 停止清扫（动作）

以上仅为常见参考值，不同型号的 siid/piid 可能不同。如果控制失败，先用 `xiaomi_get_properties` 尝试读取 siid=2 的 piid 1-10 来探测设备支持的属性。

### 第三步：执行操作

根据用户意图调用对应工具：

- **开/关设备**: `xiaomi_set_property(did, siid=2, piid=1, value=true/false)`
- **调节属性**: `xiaomi_set_property(did, siid, piid, value)`
- **执行动作**: `xiaomi_call_action(did, siid, aiid)`
- **查询状态**: `xiaomi_get_properties(did, siid=2, piids="1,2,3,4,5")`

### 第四步：反馈结果

用自然语言告诉用户操作结果，例如：
- "已关闭客厅吸顶灯"
- "空气净...