← 返回资源

FREE SKILL

v0.1.3

米家 Mijia

输入“/米家 把客厅灯打开”,或者“/米家 创建一个书房模式”。也可以直接用自然语言。把几个设备动作保存下来,以后一句话就能调用,也可以让它按时间或条件自动执行。

下载 ZIP

先试着这样说

安装并接入后,照着输入“/米家 + 指令”,也可直接用自然语言。/米家 是本 Skill 的文本识别说法;客户端若拦截斜杠输入或未选中 Skill,改用 $mijia。房间、设备和模式都换成自己家的。

还没安装?看下面的安装方法 ↓

  1. 01先开一盏灯

    /米家 把客厅灯打开。

    接着说“关掉客厅灯”就能继续用。只说“开灯”而目标不明确时,会先问开哪盏。

  2. 02看看有没有忘关

    /米家 看看家里哪些灯和空调还开着,先不要操作。

    只查状态,不会顺手关设备。

  3. 03调空调、开窗帘

    /米家 把卧室空调打开,设为25℃;把客厅窗帘打开。

    按实际设备能力执行,并回读状态。

  4. 04创建一次,以后直接叫

    /米家 帮我创建一个“书房模式”:打开书房灯,打开书房空调并设为25℃,关闭客厅灯和电视。其他设备不动。先保存,不要执行。

    核对你家的设备后,保存为你自己的模式。这里只是用法示例,下载包不会预装任何人的家庭规则。

  5. 05下次一句话使用

    /米家 开启书房模式。

    调用已经保存的模式,不用每次重述全部动作。

  6. 06随时修改模式

    /米家 把书房模式里的空调温度改成24℃,其他动作不变。只修改,现在不要运行。

    下次开启时使用新温度,不因为修改规则就执行一次。

  7. 07到时间自己执行

    /米家 创建并启用一个自动化:每天晚上23点关闭客厅电视,其他设备不要动。

    由 HA 到时间执行;HA 需要持续运行。以后可以说“把时间改成23点30分”。

  8. 08用传感器联动

    /米家 如果我家有可用的走廊人体传感器,帮我设置:晚上19点到23点检测到有人就开走廊灯。先检查设备和条件,再创建。

    缺设备或条件时先说明。定时和传感器触发尚未完成实物验收;首次连接仍需本人完成小米与 HA 授权。

  9. 09不用斜杠,也能查状态

    帮我看看米家里客厅灯现在是开着还是关着,先别操作。

    根据米家查询意图选择 Skill,只读指定设备;未命中时可用 $mijia 明确调用。

  10. 10自然语言完成两个动作

    帮我把米家的卧室灯关掉,把卧室空调设为26℃;如果空调没开,就先打开。

    按实际设备能力执行并回读,目标不明确时先询问。

  11. 11自然语言保存新模式

    帮我在米家接入的 HA 里保存一个“看电影模式”:关闭客厅灯,打开客厅电视。先保存,现在不执行。

    先确认电视支持开机,缺能力时说明。规则保存在自己的 HA,不自动同步回米家 App。

  12. 12同一个对话,直接接着说

    开启刚才保存的看电影模式。

    沿用米家上下文,查到已保存的模式后调用。新对话可以说“用米家开启看电影模式”。

安装步骤

  1. 下载 ZIP,交给 Codex,说:“安装这个米家 Skill,检查环境,保留我的其他配置。”
  2. 按提示亲自完成小米和 Home Assistant 授权;先做只读查询,再选一个设备测试。
  3. 重新加载 Skills 或新建会话,输入“/米家 看看有哪些设备,先不要操作”,然后照上面的例子使用;没命中时改用 $mijia。
想了解更多?查看适用范围、环境要求和能力说明

适合谁

  • 已有米家设备,希望通过 Codex 查询状态、控制设备和创建联动的用户
  • 已有或准备安装 Home Assistant,希望保留个人配置、持续更新通用 Skill 的用户

能做什么

  • 环境检查:识别电脑系统、CPU 架构、已有 HA、虚拟机或容器、Codex 版本、Python、端口和 MCP 配置
  • 安装接入:优先复用环境,按系统引导安装官方依赖;安装软件、重启 HA 或变更网络前说明影响并取得对应授权
  • 官方路线:Codex → Home Assistant 官方 MCP Server → 小米官方 Xiaomi Home 集成 → 用户自己的米家设备
  • 查询控制:实时识别房间和设备能力,查询状态、开关灯、调温和控制窗帘,操作后回读结果
  • 理解创建意图:区分立即执行、保存可调用模式、定时或条件触发的自动化,在用户自己的 HA 中创建并核验规则
  • 异常处理:定位授权回调、工具发现、公开范围、白名单、离线设备及能力不匹配;不把提交成功当作实物生效
  • 公共包只有通用能力,不附带维护者的设备、家庭模式或授权;你创建的规则和连接信息保留在自己的环境

使用要求

  • Codex 需支持本地 Skill、命令执行、官方 MCP OAuth 与对应原生 app-server RPC;Python 3.9+,助手无需第三方 Python 包
  • 使用可访问的 Home Assistant 和官方 Xiaomi Home 集成;首次接入须本人完成小米账号与 HA 两次授权,不向 Agent 提供密码、验证码或 Token
  • macOS 已有实机接入和设备控制验证;Windows 有安装指南但尚未实机验收,不能保证所有设备和功能均受支持
  • 创建规则需 Codex 能操作已登录的 HA 浏览器页面;保存模式不会默认执行,定时或条件联动需要 HA 持续运行
  • 口令脚本创建与 MCP 发现已验证;定时/传感器触发尚未完成实物验收,米家 App 原有场景不自动导入或双向同步
  • Skill 免费;HA 主机、第三方软件和服务遵循各自许可与费用。电脑休眠或 HA 停止会影响连接
版本
0.1.3
大小
25.4 KiB
许可证
原创代码与文档 MIT;上游软件与服务适用各自条款
更新时间
2026-09-26
SHA-256
1956369a851e38faee7cb19d68134786c84b148f04d4bed61cf6f0b279469f0a

NEXT STEP

继续了解背后的方法

学习如何创建自己的 Skill