xiaomi

核心用法

该 Skill 基于 python-miio 开源库，通过 miiocli 命令行工具实现对小米生态链设备的局域网控制。用户首先需要通过文档指引获取设备 IP 地址和 32 位 Token（文档中提及的自动化提取脚本实际需用户自行准备），并将设备信息注册到 references/devices.md 配置文件中。配置完成后，用户可通过自然语言指令（如"打开热水器"、"查看加湿器状态"）触发相应的 MIOT 协议命令，直接对智能插座、加湿器、电饭煲等设备进行电源控制、模式调节和状态查询。所有通信均在本地局域网内完成，无需经过小米云端服务器中转。

显著优点

零延迟本地响应：相比依赖云端 API 的控制方案，局域网直连模式大幅降低了响应延迟，即使在互联网断开的情况下仍能正常操作设备。隐私保护强化：设备控制指令和数据不会上传至第三方服务器，Token 等敏感信息完全由用户本地保管，降低了数据泄露风险。开箱即用体验：Skill 预设了常见设备（如智能插座、加湿器、电饭煲）的控制模板，用户无需记忆复杂的 MIOT 协议参数，通过自然语言即可完成操作。环境自动修复：安装流程中自动处理 Python 依赖冲突（如 click 版本问题），通过 pipx 创建隔离环境，避免对系统 Python 环境造成污染。

潜在缺点与局限性

来源可信度限制：作为 T3 级个人开发者项目（GitHub: yiqiezhenxi），缺乏官方背书和长期维护保障，代码更新和安全性补丁的持续性存在不确定性。配置门槛较高：虽然 Skill 提及自动化 Token 提取脚本，但实际并未包含该文件，用户需要具备一定的技术背景，手动从小米账号中提取设备 Token 并配置。功能边界受限：仅支持局域网内控制，无法实现跨网络远程操作；且仅兼容支持 MIOT 协议的小米设备，老旧设备可能无法识别。生态封闭性：深度绑定小米生态链，对于多品牌智能家居混合环境支持有限。

适合的目标群体

本 Skill 特别适合智能家居极客和隐私敏感型用户——前者追求极致的本地控制体验和定制化自动化流程，后者则重视数据主权，不愿将家庭设备控制权交由云端。同时适合网络环境不稳定地区的用户，本地控制确保在网络波动时仍能正常操作热水器、加湿器等关键设备。对于已拥有小米生态（特别是智能插座、电饭煲、加湿器）且具备基础命令行操作能力的用户，该工具能显著提升生活效率。

使用风险与注意事项

Token 安全风险：设备 Token 相当于设备密码，一旦泄露可能导致未授权访问。建议将 references/my_private_devices.md 等配置文件加入 .gitignore，避免意外提交到公共仓库。网络安全边界：虽然通信限制在局域网，但若家庭网络被入侵，攻击者可直接控制物理设备（如热水器）。建议配合防火墙规则限制 IoT 设备网段访问。依赖维护风险：python-miio 作为第三方开源项目，若小米修改通信协议可能导致功能失效。建议关注上游更新，并谨慎升级 Skill 依赖。物理设备安全：自动化脚本错误可能导致设备异常开关（如热水器干烧），建议在生产环境部署前充分测试指令逻辑，并保留手动物理开关作为应急手段。