核心功能
该技能基于 python-miio 库的 miiocli 命令行工具,实现对小米(米家)智能家居设备的局域网直接控制。核心能力包括:
- 本地网络控制:绕过小米云端 API,直接通过局域网与设备通信,延迟低、响应快
- 设备状态查询:实时获取智能插座、加湿器、电饭煲等设备的运行状态
- 电源控制:对智能插座等支持 MIOT 协议的设备进行开关操作
- 属性调优:通过 MIOT 协议直接设置设备属性(如加湿器档位调节)
- Token 自动提取:内置脚本
token_extractor.py可从小米云端批量获取设备 IP 和 32 位 Token
显著优点
1. 隐私与独立性:纯本地通信,设备指令不经过小米云端,减少数据上传
2. 响应速度:局域网直连,相比云端 API 延迟显著降低
3. 开箱即用:自动处理 click 版本依赖冲突,提供预配置工作流模板
4. 扩展性强:基于成熟的 python-miio 开源生态,支持 300+ 小米设备型号
潜在局限与风险
- Token 获取门槛:需登录小米账号提取 Token,对非技术用户有一定门槛
- 设备兼容性:仅支持小米 MIOT/MiIO 协议设备,非小米品牌设备无法使用
- 网络依赖:要求设备与运行环境处于同一局域网,跨网络无法操控
- 安全凭证管理:Token 相当于设备永久密钥,需妥善保管,避免泄露
适合人群
- 小米智能家居重度用户,希望实现自动化脚本控制
- 注重隐私、希望减少云端依赖的技术爱好者
- 需要将米家设备集成到现有智能家居中枢(如 Home Assistant)的用户
常规风险提醒
- Token 泄露可导致设备被未授权控制,建议存储于加密环境
- 频繁调用设备 API 可能导致部分旧型号设备响应异常
- 小米协议可能随固件更新变更,存在未来兼容性风险