小米家居 (Xiaomi Home)

⚠️ 局域网高效米家设备管家

基于本地 miiocli 的米家智能家居控制技能,无需依赖云端,快速响应开关控制和状态查询。

收藏
11.8k
安装
4.2k
版本
1.2.1
CLS 安全性认证2026-05-13
点击查看完整报告 >

使用说明

综合评价

Xiaomi Home Control 是一款专为米家智能家居生态设计的本地化控制技能,它通过成熟的 python-miio 库和命令行工具 miiocli,实现了在局域网内对智能插座、加湿器、电饭煲等多种设备的直接控制。该技能的核心价值在于摆脱了对云端 API 的完全依赖,响应速度极快,执行开关、模式调节等指令几乎无延迟。

核心用法

该技能的核心用法围绕设备令牌获取与本地指令下发。首先,用户需通过内建的 token_extractor.py 脚本,从小米云安全地提取设备的 IP 地址和 32 位 Token 密钥,并将其存储在本地配置文件中。随后,用户即可通过自然语言指令(如“打开热水器”)或精确的 miiocli 命令,对设备进行开关控制、属性设置或状态查询。

显著优点

1. 极速响应:所有通信仅在局域网内完成,避免了云端服务器的网络延迟,操作几乎是实时的。
2. 隐私保护:设备的核心控制令牌和指令数据不会传输给第三方平台,完全保留在用户的本地网络中,降低了数据泄露风险。

3. 工具链完备:内置了功能强大的令牌提取器和自动化环境修复脚本,解决了 Python 库依赖冲突等常见痛点,大幅降低了上手难度。

4. 代码质量高:经安全认证报告分析,代码结构清晰,无后门、恶意行为或向未知第三方传输数据的情况。所有对外通信均指向小米官方 api,用于合法的令牌提取。

潜在缺点与局限性

1. 网络依赖性:必须要求 Agent 运行环境和米家设备处于同一局域网网段内,无法实现远程控制。
2. 初始配置门槛:获取 Token 的过程需要用户输入小米账号的用户名和密码,对注重隐私的用户来说可能是一个心理障碍,尽管凭证仅用于与小米官方服务器通信。

3. 设备兼容性:虽然支持主流 MIOT 协议设备,但并非所有米家产品都能完美控制,具体兼容性取决于 python-miio 库的支持范围。

4. 安全性警告:安全认证发现分发包曾意外包含开发者个人设备的真实令牌,这是发布流程上的重大缺陷。虽然对最终用户无直接影响,但反映了个人维护项目的供应链风险。

适合的目标群体

  • 智能家居技术爱好者:热衷于本地化、自动化控制的极客用户。
  • 米家生态深度用户:拥有大量米家智能设备,希望整合到统一本地控制台的人群。
  • Agent 开发者:需要将智能家居物理世界与 AI Agent 任务流打通,实现自动化场景的程序员。

使用风险提示

本技能评级为 A 级,来源可信度为 T3(个人开发者)。主要风险包括:

  • 供应链风险:项目由个人开发者维护,缺乏组织背书和开源许可证声明,代码更新和问题修复的可持续性存在不确定性。
  • 本地网络暴露:令牌提取脚本会短暂启动一个绑定 0.0.0.0 的本地 HTTP 服务用于展示验证码,虽然泄露风险极低,但在极端的本地网络环境下仍是一个微小的安全攻击面。
  • 凭证传输:用户必须将小米账号密码(MD5 哈希后)传输至小米服务器来完成首次 Token 提取,用户需确认信任该流程。

安全解读

核心用法

该 Skill 基于 python-miio 库的 miiocli 命令行工具,实现小米智能家居设备的本地局域网控制。用户需先通过内置的 token_extractor.py 脚本从小米云服务获取设备 IP 地址和 32 位 Token 密钥,随后即可在本地网络环境中直接操控设备。

主要功能模块包括:

  • 设备状态查询:读取智能插座、加湿器、电饭煲等设备的运行状态
  • 电源控制:通过 MIOT 协议发送 set_properties 指令实现开关操作
  • 属性调优:调节加湿器档位、查询烹饪进度等设备特定功能
  • Token 管理:自动化提取脚本支持多设备批量获取认证信息

显著优点

1. 本地化低延迟:直接通过局域网通信,不经过小米云端 API,响应速度显著优于云控方案
2. 开箱即用设计:内置依赖修复机制(自动处理 click 版本冲突),提供预配置工作流模板

3. 广泛的设备兼容:支持 MIOT 协议的智能插座、加湿器、电饭煲等主流米家设备

4. 透明的安全审计:代码结构清晰,无危险函数调用,通过多维度安全扫描

潜在局限

  • 网络依赖限制:Token 提取阶段仍需连接小米云服务,且设备必须与运行环境处于同一局域网
  • 凭证管理门槛:用户需妥善保管提取的 Token 信息,泄露可能导致设备被未授权控制
  • 协议版本兼容:部分新设备可能采用更新的 MIOT 协议版本,需手动确认 SIID/PIID 参数
  • 个人维护风险:由个人开发者维护(GitHub T3 级别),长期更新可持续性存在不确定性

适合人群

  • 米家智能家居用户,希望获得比官方 App 更快捷的本地控制体验
  • 需要将家电控制集成到自动化工作流的技术爱好者
  • 注重隐私、希望减少云端数据交互的敏感型用户
  • 具备基础 Python 环境配置能力的进阶用户

常规风险

  • 凭证泄露风险:Token 相当于设备永久访问密钥,需避免提交至公开代码仓库
  • 本地服务暴露:Token 提取脚本启动的临时 HTTP 服务(127.0.0.1:31415)虽仅限本地回环,但仍建议在可信环境中运行
  • 供应链安全:依赖 pycryptodomePIL 等第三方库,需关注后续安全更新
  • 设备误操作:MIOT 协议指令直接生效,错误参数可能导致设备异常运行(如电饭煲强制中断烹饪)

小米家居 (Xiaomi Home) 内容

references文件夹
scripts文件夹
手动下载zip · 12.3 kB
devices.mdtext/markdown
请选择文件