Midea Air Conditioners

❄️ 本地智控美的空调·零云端·纯隐私

基于 msmart 协议本地控制美的空调,支持开关、调温、模式切换等完整操作,无云端依赖,隐私安全。

收藏
11.3k
安装
2.5k
版本
0.0.3
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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 或定期更新配置
  • 更新滞后:个人项目可能无法及时跟进美的协议变更

Midea Air Conditioners 内容

scripts文件夹
手动下载zip · 2.7 kB
midea_ac.pytext/plain
请选择文件