核心用法
Midea AC Skill 是一款专门用于本地控制美的(Midea)品牌智能空调的命令行工具。它基于 msmart-ng 开源库实现,通过局域网直接与空调设备通信,无需经过美的云端服务器。
主要功能命令:
- 开关控制:
on/off/toggle - 模式切换:
--mode cool/heat/dry/auto/fan - 温度设定:
--temperature 16-30(自动限制范围) - 风速调节:
--fan_speed low/medium/high/auto/max - 辅热控制:
--aux_mode on/off - 状态查询:
status
智能语义理解: 支持自然语言指令,如"调高一点温度""最大风速制冷"等,系统会自动先查询当前状态再执行相应调整。
显著优点
1. 纯本地控制:仅通过 192.168.x.x 局域网通信,数据不出本地,无隐私泄露风险
2. 代码极简透明:仅 77 行可执行代码,无复杂逻辑,易于审计
3. 零外部依赖:除 PyPI 下载依赖包外,运行时无互联网连接需求
4. 功能完整:覆盖空调常用全部操作场景,支持批量参数设置
5. 输入安全:温度范围强制限制在 16-30 度,防止无效指令
潜在缺点与局限性
1. 需手动配置:目前需手动编辑 AC_IPS 字典配置设备 IP,无自动发现功能
2. 异常处理简单:设备离线或网络超时可能抛出未捕获异常
3. 品牌单一:仅支持美的空调,无法扩展至其他品牌
4. 无开源许可证:当前未声明许可证,存在潜在使用风险
5. 个人维护:T3 级别个人开发者项目,长期维护不确定性
适合人群
- 拥有美的智能空调且希望脱离 App 云控的用户
- 注重隐私、偏好本地智能家居方案的技术爱好者
- 已将空调接入局域网(WiFi 款)的智能家居玩家
- 愿意自行审查和配置代码的进阶用户
常规风险
- 设备兼容性:依赖
msmart-ng库支持的机型,部分新型号或旧型号可能不兼容 - 网络稳定性:局域网通信质量直接影响控制可靠性
- IP 变动风险:路由器 DHCP 可能导致空调 IP 变化,需固定 IP 或定期更新配置
- 更新滞后:个人项目可能无法及时跟进美的协议变更