局域网高效米家设备管家 - 小米家居 (Xiaomi Home)

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

基本信息

• 技能名称?小米家居 (Xiaomi Home)
• 中文名称?局域网高效米家设备管家
• 作者?pegasus02
• 分类?专业技能
• 版本?1.2.1
• 标签?automation, smart-home, iot, productivity

使用方法

使用说明
综合评价
Xiaomi Home Control 是一款专为米家智能家居生态设计的本地化控制技能，它通过成熟的 python-miio 库和命令行工具 miiocli ，实现了在局域网内对智能插座、加湿器、电饭煲等多种设备的直接控制。该技能的核心价值在于摆脱了对云端 API 的完全依赖，响应速度极快，执行开关、模式调节等指令几乎无延迟。
核心用法
该技能的核心用法围绕设备令牌获取与本地指令下发。首先，用户需通过内建的 token_extractor.py 脚本，从小米云安全地提取设备的 IP 地址和 32 位 Token 密钥，并将其存储在本地配置文件中。随后，用户即可通过自然语言指令（如“打开热水器”）或精确的 miiocli 命令，对设备进行开关控制、属性设置或状态查询。
显著优点

1. 极速响应 ：所有通信仅在局域网内完成，避免了云端服务器的网络延迟，操作几乎是实时的。
2. 隐私保护 ：设备的核心控制令牌和指令数据不会传输给第三方平台，完全保留在用户的本地网络中，降低了数据泄露风险。
3. 工具链完备 ：内置了功能强大的令牌提取器和自动化环境修复脚本，解决了 Python 库依赖冲突等常见痛点，大幅降低了上手难度。
4. 代码质量高 ：经安全认证报告分析，代码结构清晰，无后门、恶意行为或向未知第三方传输数据的情况。所有对外通信均指向小米官方 api，用于合法的令牌提取。
   潜在缺点与局限性
5. 网络依赖性 ：必须要求 Agent 运行环境和米家设备处于同一局域网网段内，无法实现远程控制。
6. 初始配置门槛 ：获取 Token 的过程需要用户输入小米账号的用户名和密码，对注重隐私的用户来说可能是一个心理障碍，尽管凭证仅用于与小米官方服务器通信。
7. 设备兼容性 ：虽然支持主流 MIOT 协议设备，但并非所有米家产品都能完美控制，具体兼容性取决于 python-miio 库的支持范围。
8. 安全性警告 ：安全认证发现分发包曾意外包含开发者个人设备的真实令牌，这是发布流程上的重大缺陷。虽然对最终用户无直接影响，但反映了个人维护项目的供应链风险。
   适合的目标群体
   智能家居技术爱好者 ：热衷于本地化、自动化控制的极客用户。
   米家生态深度用户 ：拥有大量米家智能设备，希望整合到统一本地控制台的人群。
   Agent 开发者 ：需要将智能家居物理世界与 AI Agent 任务流打通，实现自动化场景的程序员。
   使用风险提示
   本技能评级为 A 级，来源可信度为 T3（个人开发者）。主要风险包括：
   供应链风险 ：项目由个人开发者维护，缺乏组织背书和开源许可证声明，代码更新和问题修复的可持续性存在不确定性。
   本地网络暴露 ：令牌提取脚本会短暂启动一个绑定 0.0.0.0 的本地 HTTP 服务用于展示验证码，虽然泄露风险极低，但在极端的本地网络环境下仍是一个微小的安全攻击面。
   凭证传输 ：用户必须将小米账号密码（MD5 哈希后）传输至小米服务器来完成首次 Token 提取，用户需确认信任该流程。