戴森设备本地控制

技能简介

dyson-cli 是一个命令行工具，用于在本地 WiFi 网络内通过 MQTT 协议直接控制戴森空气净化器、风扇及冷暖风机。无需云端连接，所有指令均在局域网内完成。

业务背景

解决智能家居用户对设备响应速度与隐私安全的双重需求。通过局域网直连，指令无需绕行云端，延迟更低且断网可控；同时避免个人环境数据上传，满足对敏感信息本地化处理的要求。适用于追求稳定操控体验与数据主权的家庭及小型办公场景。

落地案例：某用户晚间就寝前，在卧室直接通过命令行关闭客厅戴森风扇并设定摆头角度为90°，全程无需打开官方App或连接互联网。若次日出差在外，因工具仅限局域网使用，无法远程操作，需提前设置定时或改用其他方案。安装时运行dyson setup录入设备凭证，日常用-d参数指定房间即可快速切换多台设备。

能做什么

• 开关设备电源
• 调节风速（1-10档或自动模式）
• 控制摆头角度（45°/90°/180°/350°）及开关
• 设置制热目标温度（仅限冷暖机型）
• 开启夜间静音模式
• 查询实时室温、湿度及运行状态
• 管理多台设备，按名称指定操作对象

使用说明

安装准备

1. 克隆仓库至 ~/dyson-cli 并创建 Python 虚拟环境
2. 执行 pip install -e . 完成安装
3. 运行 dyson setup 配置设备凭证

基础操作

# 验证设备连通性
cd ~/dyson-cli && source .venv/bin/activate && dyson list --check

# 开机并设为自动风速
dyson on && dyson fan speed auto

# 制热至23度
dyson heat on && dyson heat target 23

# 查询温湿度（JSON解析）
dyson status --json | python3 -c "import sys,json; d=json.load(sys.stdin); print(f'Temp: {d[\"temperature\"]-273:.1f}°C, Humidity: {d[\"humidity\"]}%')"

多设备场景

使用 -d "设备名" 参数指定目标，如 dyson on -d "Bedroom"

输入与输出

见下方输入与输出表格。

风险提示

• 必须与被控设备处于同一 WiFi 网络，远程网络无法连接
• 设备离线或凭证过期时需重新运行 dyson setup
• 制热功能仅适用于 Hot+Cool 系列机型，普通机型执行将报错
• MQTT 通信无加密传输，建议在可信家庭网络中使用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/tmustier/dyson-cli/SKILL.md
来源类型：GitHub 开源项目