我让 Claude Code 关闭我的米家吸顶灯，Claude Code 一番摸索找到了 mijia-api，成功执行了关灯。

感谢 mijia-api 作者🙏，我也让 Claude Code 记录成了简单的 SKILL.md ，分享给有需要的朋友。

---
name: mijia-control
description: 控制米家智能设备。当用户想要开关灯、调节亮度、控制扫地机器人、空气净化器、空调等智能家居设备时使用。
permissions:
  - Bash(uvx mijiaAPI:*)
---

# 米家智能设备控制指南

使用 `uvx mijiaAPI` 命令控制米家智能设备。

## 1. 安装与登录

首次使用扫码登录：

```bash
uvx mijiaAPI -l
```

认证信息保存在 `~/.config/mijia-api/auth.json`。

## 2. 查看家庭列表

```bash
uvx mijiaAPI --list_homes
```

## 3. 查看设备列表

```bash
uvx mijiaAPI -l
```

显示设备名称、did （设备 ID ）和 model （型号）。

## 4. 查看设备属性

```bash
uvx mijiaAPI --get_device_info <model>
```

## 5. 常用命令

### 控制设备属性

```bash
# 基本格式
uvx mijiaAPI set --did <设备 ID> --prop_name "<属性名>" --value <值>

# 示例：开关灯
uvx mijiaAPI set --did 123456789 --prop_name "on" --value True
uvx mijiaAPI set --did 123456789 --prop_name "on" --value False

# 示例：调节亮度 (1-100)
uvx mijiaAPI set --did 123456789 --prop_name "brightness" --value 50

# 示例：调节色温 (具体范围取决于设备)
uvx mijiaAPI set --did 123456789 --prop_name "color-temperature" --value 2700
```

### 获取设备状态

```bash
uvx mijiaAPI get --did <设备 ID> --prop_name "<属性名>"

# 示例
uvx mijiaAPI get --did 123456789 --prop_name "on"
uvx mijiaAPI get --did 123456789 --prop_name "brightness"
```

### 使用小爱音箱（可选）

有小爱音箱时，可用自然语言控制：

```bash
uvx mijiaAPI --run "<语音命令>" --wifispeaker_name "<音箱名称>"

# 示例
uvx mijiaAPI --run "关闭所有灯" --wifispeaker_name "小爱音箱 Pro"
uvx mijiaAPI --run "把台灯调到 50%亮度" --wifispeaker_name "小爱音箱 Pro"
```

适用场景：批量控制、房间控制、属性调节（亮度、色温等）。

## 6. 常见设备属性

灯光：`on`（开关）、`brightness`（亮度 1-100 ）、`color-temperature`（色温）

空气净化器：`on`（开关）、`mode`（模式）、`fan-level`（风速）

## 7. 批量操作

使用 `&&` 连接多个命令：

```bash
uvx mijiaAPI set --did 111 --prop_name "on" --value True && \
uvx mijiaAPI set --did 222 --prop_name "on" --value True
```

## 8. 参考资料

- GitHub 项目： https://github.com/Do1e/mijia-api
- 更多命令选项：`uvx mijiaAPI --help`

## 9. 设备笔记（重要）

优先查看 `~/.config/mijia-api/my-devices.yaml`（如存在）。

包含：家庭列表、设备信息、小爱音箱名称。

工作流程：
1. 查看笔记文件，获取小爱音箱名称
2. 直接执行：`uvx mijiaAPI --run "关闭所有灯" --wifispeaker_name "小爱音箱 Pro"`

笔记不存在：查询家庭和设备信息，自动创建笔记文件。

快捷调用失败：自动重新查询信息（`--list_homes` 和 `-l`），更新笔记文件，然后重新执行用户请求。

笔记示例：

```yaml
# 米家设备笔记

homes:
  我的家:
    id: 123456789
    wifispeaker: 小爱音箱 Pro
    devices:
      - 台灯 (did: 111111111, model: yeelink.light.lamp4)
      - 吸顶灯 (did: 222222222, model: xiaomi.light.ceil04)

  办公室:
    id: 987654321
    wifispeaker: 小爱音箱
```