编程

米家风扇控制

试用

Xiaomi 米家风扇控制 Skill。支持开/关/调速/摆风,兼容所有 AI 工具调用。触发词:风扇、开风扇、关风扇、风扇开关。

它能做什么

Xiaomi 米家风扇控制 Skill。支持开/关/调速/摆风,兼容所有 AI 工具调用。触发词:风扇、开风扇、关风扇、风扇开关。

技能文档

mijia-fan — Xiaomi 米家风扇控制 Skill

通用风扇控制接口,支持开/关/调速/摆风,可被任何 AI 工具通过标准化方式调用。

安装

# 方式 A:本地 zip 安装(推荐)
unzip mijia-fan.zip -d ~/.qclaw/skills/
cd ~/.qclaw/skills/mijia-fan
bash install.sh                    # 自动创建虚拟环境并安装依赖

# 方式 B:手动安装
cd ~/.qclaw/skills/mijia-fan
python3 -m venv .venv
source .venv/bin/activate
pip install mijiaAPI

快速开始

cd ~/.qclaw/skills/mijia-fan
source .venv/bin/activate
export MIJIA_FAN_DID="812221072"  # 你的风扇 DID

python scripts/fan_cli.py on       # 开
python scripts/fan_cli.py off      # 关
python scripts/fan_cli.py toggle   # 切换
python scripts/fan_cli.py status  # 状态
python scripts/fan_cli.py speed 50  # 风速 50
python scripts/fan_cli.py swing on  # 摆风开
python scripts/fan_cli.py list     # 列出所有设备

命令速查

命令说明
fan_cli.py on开风扇
fan_cli.py off关风扇
fan_cli.py toggle切换开关
fan_cli.py status查看当前状态
fan_cli.py speed 1-100设置风速(0=关)
fan_cli.py swing on/off摆风开关
fan_cli.py list列出所有米家设备

环境变量

变量默认值说明
MIJIA_FAN_DID必填风扇设备 DID(运行 list 查看)
MIJIA_FAN_SIID2属性服务 ID,一般不需改
MIJIA_FAN_POWER_PIID1电源属性 ID
MIJIA_FAN_SPEED_PIID2风速属性 ID
MIJIA_FAN_SWING_PIID5摆风属性 ID

自然语言 → 命令映射

当用户说以下内容时,执行对应命令:

用户说法执行命令
打开风扇/开风扇fan_cli.py on
关闭风扇/关风扇fan_cli.py off
风扇开关/切换风扇fan_cli.py toggle
风扇状态/风扇开着吗fan_cli.py status
风扇调速/风速设为XXfan_cli.py speed XX
打开摆风/关闭摆风fan_cli.py swing on/off
列出风扇/查看风扇设备fan_cli.py list

执行流程(AI 工具通用)

  1. 切换目录:cd ~/.qclaw/skills/mijia-fan
  2. 激活虚拟环境:source .venv/bin/activate
  3. 执行命令:python scripts/fan_cli.py
  4. 检查返回码,报告结果

常见问题

Q: 怎么找风扇的 DID?

python scripts/fan_cli.py list

在输出中找到风扇设备,复制其 DID 设置到环境变量。

Q: 权限/登录过期? 米家 API 通过小米账号授权,首次运行会弹出二维码扫码登录。Token 有效期约 30 天,过期后重新扫码即可。

Q: 命令无输出或报 code != 0? 检查设备 ID 是否正确,设备是否在线,或重试登录授权。

相关技能

技能太多不知道该用哪个,每次都要翻半天?本技能根据用户需求智能匹配最合适的已安装技能。关键词+语义双重匹配,输出Top3推荐+理由+适用场景,不再试错浪费时间。 触发词:选技能、用哪个技能、技能推荐、技能匹配、技能选择、该用什么、帮我选技能 排除:技能创建(用skill_builder)、技能搜索安装(用skil...

4 次安装

🎮 AI Agent 智能空调控制核心库 — 零 GUI 依赖,import 即用。支持 17 大品牌空调(格力/美的/海尔/大金等),直连 Broadlink RM 红外遥控器,同时接入所有支持 MIoT 协议的米家红外遥控器。MIoT spec 自动匹配 siid/piid,百度+和风双天气源,中央气象台+...

3 次安装

Yingmi MCP (qieman.com). Use this skill for ANY Yingmi MCP request — searching and reading data. Whenever a task involves Yingmi MCP, use this skill instead of calling the API directly.

🎮 AI Agent 智能空调控制核心库 — 零 GUI 依赖,import 即用。支持 17 大品牌空调(格力/美的/海尔/大金等),直连 Broadlink RM 红外遥控器。百度+和风双天气源,中央气象台+NHC 双风暴源,多日期组定时模板,Markdown 日志,故障诊断。适配树莓派/NAS/OpenW...

11 次安装1 星标

Use when users want help with smart home planning, device selection, automation design, platform comparison, or configuration for Home Assistant, 米家/小米, or Apple HomeKit. Triggers on smart home, 智能家居, home automation, device recommendation, 自动化场景, and home assistant setup.

搜索和安装社区小程序 AI Skill。当用户想在现有小程序项目中添加 AI 能力,但不确定有什么可用的社区 Skill,或不想从头开发时触发。可以从 TencentCloudBase/awesome-miniprogram-skills 等仓库搜索、查看详情并安装。

4 次安装