管理和控制小米/米家智能家居设备的SIKIL,兼容claude code或openclaw等agent,支持设备发现、开关控制、亮度调节、颜色设置等功能。
SaferSkills independently audited mijia-device-manager (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
此技能用于管理和控制小米/米家智能家居设备,直接调用 mijiaAPI CLI 通过小米云端 API 控制设备。
pip install mijiaAPIpython -m mijiaAPI --list_homespython -m mijiaAPI --list_homes运行后会显示二维码,使用米家 APP 扫描即可完成登录。
python -m mijiaAPI -l输出中每条设备信息包含 did,后续控制命令使用该值。
# 开灯
python -m mijiaAPI set --did "123456789" --prop_name "on" --value True
# 设置亮度
python -m mijiaAPI set --did "123456789" --prop_name "brightness" --value 50
# 获取状态
python -m mijiaAPI get --did "123456789" --prop_name "brightness"python -m mijiaAPI --help
python -m mijiaAPI get --help
python -m mijiaAPI set --help常用命令示例:
# 列出所有设备
python -m mijiaAPI -l
# 从列表中找到 did
python -m mijiaAPI -l | grep did
# 列出所有家庭
python -m mijiaAPI --list_homes
# 获取设备属性
python -m mijiaAPI get --did "123456789" --prop_name "brightness"
# 设置设备属性
python -m mijiaAPI set --did "123456789" --prop_name "on" --value True
python -m mijiaAPI set --did "123456789" --prop_name "brightness" --value 50
# 执行场景
python -m mijiaAPI --run_scene "回家"常见设备属性名称:
| 属性名 | 说明 | 类型 | 示例值 |
|---|---|---|---|
on | 开关状态 | bool | True/False |
brightness | 亮度 | int | 0-100 |
color-temperature | 色温 | int | 2700-6500 |
color | 颜色 | int | RGB值 |
注意: 不同设备支持的属性不同,操作前先使用 --get_device_info DEVICE_MODEL 获取设备属性信息,确认可操作的属性后再执行控制命令。DEVICE_MODEL 可通过 --list_devices 获取。
操作步骤:
python -m mijiaAPI -l 列出设备,确认 did 与 DEVICE_MODEL。python -m mijiaAPI --get_device_info DEVICE_MODEL 获取可用属性与范围。get 或 set 命令完成查询或控制。问题:无法登录或提示认证失败
rm ~/.config/mijia-api/auth.json
python -m mijiaAPI --list_homes问题:找不到设备
-l 命令查看准确的设备名称问题:不知道 did
python -m mijiaAPI -l 列出设备,在输出中找到设备的 did 字段问题:属性设置失败
--get_device_info DEVICE_MODEL 获取属性信息)问题:想知道某个设备都有哪些属性
--list_devices 获取 DEVICE_MODEL,再用 --get_device_info DEVICE_MODEL 获取属性信息,例如: python -m mijiaAPI --get_device_info yeelink.light.lamp27~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.