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

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

基本信息

• 技能名称?Midea Air Conditioners
• 中文名称?本地智控美的空调·零云端·纯隐私
• 作者?iamanorange
• 分类?专业技能
• 版本?0.0.3
• 标签?iot, climate-control, midea, ac, local-network, msmart

使用方法

使用说明
核心用法
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 度，防止无效指令
   潜在缺点与局限性
6. 需手动配置 ：目前需手动编辑 AC_IPS 字典配置设备 IP，无自动发现功能
7. 异常处理简单 ：设备离线或网络超时可能抛出未捕获异常
8. 品牌单一 ：仅支持美的空调，无法扩展至其他品牌
9. 无开源许可证 ：当前未声明许可证，存在潜在使用风险
10. 个人维护 ：T3 级别个人开发者项目，长期维护不确定性
    适合人群
    拥有美的智能空调且希望脱离 App 云控的用户
    注重隐私、偏好本地智能家居方案的技术爱好者
    已将空调接入局域网（WiFi 款）的智能家居玩家
    愿意自行审查和配置代码的进阶用户
    常规风险
    设备兼容性 ：依赖 msmart-ng 库支持的机型，部分新型号或旧型号可能不兼容
    网络稳定性 ：局域网通信质量直接影响控制可靠性
    IP 变动风险 ：路由器 DHCP 可能导致空调 IP 变化，需固定 IP 或定期更新配置
    更新滞后 ：个人项目可能无法及时跟进美的协议变更
    iot climate-control midea ac local-network msmart