技能介绍

要解决什么问题

米家极客版的自动化规则本质是画布上的节点图 JSON：设备触发、条件门、延时与动作都靠 type、props、outputs 连线表达。手工在控制台拖拽容易漏平台隐性约束（变量比较符、枚举 include、延时卡 cfg 与 props 不一致等），导入后要么校验失败，要么编辑器白屏、运行时静默失效。

本技能把节点结构速查、25 类卡片语义、MIoT 寻址习惯和配套 Python 库 mijia_rule_kit 的编写流程写在一起，目标是让你用声明式脚本生成可校验、可打包 .bak 的规则，而不是凭记忆拼 JSON。

技能如何工作

结构约定：统一说明节点通用字段、连线只记在源节点 outputs、条件类双分支 output / output2，以及画布 cfg.pos 与程序排版间距建议。
节点与表达式：覆盖设备/触发/逻辑流程/变量类卡片；varSetString / varSetNumber 的 elements token 语法；规则域变量 scope:"R" 与全局变量 ID 格式约束。
平台行为实证：整理 latch 语义的 logicAnd / logicOr、查询节点不会自发触发、delay 去抖 vs statusLast 维持时长、TTS 须读变量、BLE 筒灯场景枚举等踩坑结论。
生成链路：RuleBuilder → validate → build_rule / pack_bak；改动既有规则需基于最新导出全集合并；可与 mijia-geek-backup、mijia-geek-console、mijia-geek-beginner 分工协作。

适用边界

did 必须来自用户真实备份，不能虚构；分区传感器、型号相关 piid 需对照 miot-spec.org 并与用户确认。文档标明仍缺虚拟事件、部分 eiid 设备事件等样本；导入为覆盖模式，调试与执行验证应交给控制台与日志技能。

截图预览

使用场景

已从网关导出备份并解包拿到真实 `did`，要用 `mijia_rule_kit` 声明式写出「触发→deviceGet 检查→关灯」并跑 `validate` 再打包导入。
人在传感器 Pro 多分区占用需用 `operator:"include"` 与 `v1` 数组表达有人/无人，并和用户确认 APP 分区标签与 siid 映射后生成规则。
规则稳定后要把所有 TTS `deviceOutput` 前加「调试模式」全局变量条件门，避免扰民且无需改每条链重导。
既有规则被控制台改过，需基于最新导出全集 `merge_import_set` 合并脚本改动，避免覆盖丢手动调整。

适合人员

家里极客版已接照度、占用、多灯联动，希望用 Python 维护规则版本并避开枚举 `include`、变量仅 `=` 等平台坑的进阶用户。
为客户做米家本地化自动化交付，需要可重复生成 JSON、校验通过且 `did`/piid 有据可查的集成工程师。
从画布手工拖拽迁到代码仓库，打算用 `RuleBuilder`、`auto_layout` 和 `text_note` 给复杂意图分泳道文档化的规则作者。
正在编写日出日落、时段与 `logicAnd` latch 合并多传感器条件，需要对照文档区分 `delay` 去抖与 `statusLast` 计时语义的家庭自动化设计者。