mijia

💡 智能语音控制米家生态设备

🥥77总安装量 16评分人数 16
100% 的用户推荐

基于小米米家官方 API 的智能家居控制技能,支持自然语言操控台灯亮度色温,让智能设备交互更简单直观。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 代码无 eval()、exec() 等危险函数,无命令注入或动态代码执行风险
  • ✅ 敏感配置(设备 ID)通过环境变量获取,无硬编码导致的泄露风险
  • ✅ 输入验证完善,使用 argparse choices 严格约束参数范围(亮度 1-100、模式白名单)
  • ⚠️ 依赖外部 mijiaapi 库(PyPI),需网络连接小米云服务,存在第三方库供应链风险
  • ⚠️ 首次使用需小米账号 QR 码登录,来源为社区个人开发者(T3),建议自行评估信任度后使用

使用说明

Mijia Smart Home Control 是一款专为 Claude Code 设计的智能家居控制技能,旨在通过自然语言指令无缝对接小米米家生态系统。该技能基于 mijiaAPI 封装,支持对米家台灯、智能插座等设备的精细化控制,包括开关状态切换、亮度调节(1-100%)、色温调整(2700-6500K)以及多种预设模式(阅读、电脑、夜间、防蓝光等)的快速切换。

核心用法方面,用户需先配置 MIJIA_LAMP_DID 环境变量指定设备 ID,通过 uv sync 安装依赖后,即可使用 lamp_cli.py 脚本执行具体控制命令。技能支持直接 CLI 调用(如 uv run python scripts/lamp_cli.py brightness 50),更重要的是具备自然语言理解能力,可将"把灯调亮一点"、"切换到阅读模式"等口语化指令自动映射为对应的 API 调用,实现真正意义上的语音控制。

显著优点包括操作便捷性极高,用户无需记忆复杂的设备指令集,通过日常用语即可完成精细调节;参数控制精确,亮度百分比和色温值均可精确设定,满足不同场景下的照明需求;代码结构清晰规范,采用 argparse 进行严格的输入验证,有效防止非法参数导致设备异常。

潜在缺点与局限性主要体现在硬件依赖性上,仅支持小米米家生态设备,且需预先获取设备 DID;来源可信度为 T3 级(社区个人开发者),虽经安全审计但仍需谨慎评估;首次配置流程相对繁琐,需安装 Python 环境、配置 uv 工具、设置环境变量并完成小米账号 QR 码登录,对非技术用户存在一定门槛。

适合的目标群体主要为已拥有米家智能设备的科技爱好者、开发者以及追求效率的智能家居用户。特别适合需要在编程工作流中快速调节环境光线的开发者,或希望通过自然语言简化设备操控的极客用户。

使用风险主要包括:依赖第三方 mijiaapi 库的网络稳定性,需确保能正常连接小米云服务;涉及小米账号登录凭证,虽采用 QR 码交互式认证但仍需注意账号安全;作为 T3 来源项目,建议在生产环境使用前进行充分的代码审计和隔离测试。

mijia 内容

文件夹图标scripts文件夹
手动下载zip · 4.9 kB
lamp_cli.pytext/plain
请选择文件