mijia

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

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

收藏
6.2k
安装
1.3k
版本
v0.1.0
CLS 安全性认证2026-04-30
点击查看完整报告 >

使用说明

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 skill 是一个用于控制小米米家智能台灯设备的 Claude Desktop 插件。用户可通过自然语言指令(如"开灯"、"调亮一点"、"阅读模式")或 CLI 命令直接操控设备。

主要功能

  • 设备开关控制(on/off/toggle)
  • 亮度调节(1-100%)
  • 色温调节(2700K-6500K,暖光到冷光)
  • 六种预设模式:reading(阅读)、computer(电脑)、night(夜读)、antiblue(防蓝光)、work(工作)、candle(烛光)、twinkle(闪烁提醒)
  • 实时状态查询

使用方式
1. 配置环境变量 MIJIA_LAMP_DID 指定设备 ID

2. 首次使用需通过二维码登录小米账号

3. 通过 uv run python scripts/lamp_cli.py <command> 执行命令

显著优点

  • 功能聚焦单一:专注于台灯控制,无冗余功能,降低攻击面
  • 配置管理规范:设备 ID 通过环境变量读取,避免硬编码敏感信息
  • 依赖库成熟:使用 mijiaapi(GitHub 开源项目,维护活跃),无需自行实现小米 IoT 协议
  • 通信加密:与小米云服务使用 HTTPS/TLS 1.2+ 传输
  • 代码简洁可审计:仅 152 行代码,5 个文件,结构清晰无混淆

潜在缺点与局限性

  • T3 来源可信度:由个人开发者(hqman)维护,非企业级保障,需自行审查代码
  • 依赖第三方云服务:设备控制必须经由小米云服务中转,无法本地局域网直连,存在单点依赖
  • 隐私数据外传:设备状态、控制指令、认证 token 均传输至小米服务器,需接受小米隐私政策
  • 功能局限:仅支持台灯类设备,不支持米家生态其他产品(传感器、摄像头等)
  • 首次配置门槛:需手动获取 device ID、配置环境变量、完成小米账号 OAuth 登录

适合人群

  • 已拥有小米米家智能台灯(如米家台灯 1S/Pro)的用户
  • 希望通过 Claude 语音/自然语言控制智能家居的技术爱好者
  • 能接受个人开发者项目、具备基本 Python/环境配置能力的用户
  • 不介意设备数据上传至小米云服务的用户

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 第三方库供应链 | 低 | mijiaapi 为社区维护,需关注上游安全通告 |
| 云服务隐私 | 中 | 控制数据上传小米,建议阅读小米隐私政策 |
| 账号安全 | 低 | 使用 OAuth 二维码登录,token 存储于本地 |
| 环境变量泄露 | 低 | MIJIA_LAMP_DID 若泄露可能导致设备被控制 |
| 网络依赖 | 中 | 需互联网连接至小米云,局域网故障时不可用 |

总体评估:该 skill 代码干净、功能明确、安全风险可控,适合作为个人智能家居的 Claude 扩展,但建议定期检查依赖更新并保持对小米云服务条款的关注。

mijia 内容

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