# Mijia Automation > 米家自动化极客版规则创建指南。当用户想要创建智能场景、设备联动、定时任务、条件触发等自动化规则时使用此skill。 Use when this capability is needed. - Skill: `tomevault-io/mijia-automation` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/mijia-automation` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/mijia-automation/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/mijia-automation --- # 米家自动化规则创建 ## 规则结构 ```json { "id": "graph_时间戳", "nodes": [节点1, 节点2, ...], "cfg": { "id": "graph_时间戳", "enable": true, "uiType": "graph", "userData": { "name": "规则名称", "lastUpdateTime": 1710000000000, "transform": {"x": 0, "y": 0, "scale": 1, "rotate": 0} } } } ``` **节点位置自动布局**：create_graph 会根据节点连接关系自动计算位置，无需手动设置 `cfg.pos`。布局规则： - 从左到右表示流程方向 - 分支节点上下排列 - 节点尺寸：528×164 ## 关键校验规则 1. **节点 id**：只允许 `[0-9a-zA-Z]`，不能用下划线、连字符 2. **outputs 连接格式**：`"portName": ["nodeId.inputPort"]`（必须是点分隔，如 `"cond1.trigger"`） - ❌ 错误：`"output": ["range1"]`（缺少 `.inputPort`） - ✅ 正确：`"output": ["range1.trigger"]` 3. **outputs 值必须是数组**：`"output": []` ✓，`"output": null` ✗ 4. **所有节点必须声明 outputs 端口**：即使没有输出连接，也要声明端口（如 `"outputs": {"output": []}`） 5. **deviceGet**：必须有 `outputs.output` 和 `outputs.output2` 6. **inputs 命名**： - `deviceGet`, `varGet`, `statusLast`, **`delay`** 用 `input` - `deviceOutput`, `condition` 等用 `trigger` - `timeRange`, `alarmClock` 等**状态节点没有输入端口**（`inputs: {}`） 7. **dtype 映射**：`bool`→`boolean`，`uint8`/`int32`→`int`，`float`→`float` 8. **props 必须存在**：`"props": {}` 不能省略 9. **cfg.name**：值为节点类型名（如 `"deviceInput"`） 10. **cfg.unit/value**：delay 节点的 `cfg.unit` 和 `cfg.value` 是可选的（UI 显示用） ## inputs/outputs 工作机制 ### inputs 中的 null 是什么？ `"inputs": {"trigger": null}` 中的 `null` **不是"未连接"**，而是**声明端口存在**。信号实际由上游节点的 `outputs` 数组传来。 ``` 上游 outputs 数组 ──→ 决定 → 下游 inputs 端口 "output": ["cond1.trigger"] "inputs": {"trigger": null} ← 端口声明，null 是正确的 ``` ### outputs 数组决定连接关系 整个规则的**连接关系完全由每个节点的 outputs 数组决定**，inputs 只是端口声明。生成规则后必须逐个检查每个节点的 outputs 数组，确保： 1. 引用的目标节点 ID 存在 2. 引用的端口名是目标节点 inputs 中声明的端口名 3. 点分隔格式正确：`"目标节点ID.目标端口名"` ### state 节点 vs event 节点 | 类型 | 特征 | inputs | 代表节点 | |------|------|--------|----------| | **event 节点** | 可被触发 | 有 trigger/input 端口 | deviceOutput, condition, delay | | **state 节点** | 不能被触发 | `inputs: {}`（空） | timeRange, alarmClock, deviceInputSetVar | **⚠️ state 节点的 outputs 只能连到 event 节点的 condition 端口，不能作为触发链的一环。** ### ⚠️ 网关不检查连接完整性（已验证） 网关 `setGraph` **只校验节点级别结构**（字段类型、必填字段），**不校验连接级别的逻辑完整性**。以下错误都能通过网关校验但在运行时不工作： - condition 的 condition 端口未连接 → 通过校验，但条件永远满足 - deviceGet.output2 连到 state 节点 → 通过校验，但语义错误 **因此，生成规则后必须自行验证连接完整性**，不能依赖网关报错。 ## 工作流程（必须遵循） 当用户要求创建/修改自动化规则时，按以下步骤执行： 1. **理解需求**：分析用户的自动化逻辑，确定需要哪些节点 2. **生成节点列表**：按照节点模板和连接规则构建 nodes 数组 3. **调用 validate_graph 校验**：使用 `validate_graph` 工具传入完整的 graph JSON（nodes + cfg），检查连接完整性 4. **修复错误**：如果校验器报告 error 级别的问题，修复节点连接后重新校验，直到全部通过 5. **调用 create_graph 或 update_graph**：校验通过后调用创建/更新工具（注意：create_graph 和 update_graph 内部也会自动校验，如有错误会拒绝执行） 6. **确认结果**：向用户确认规则创建成功 **⚠️ create_graph / update_graph 内置了校验逻辑。如果节点连接有 error 级别的问题，工具会返回错误并拒绝调用 setGraph。修复后重新调用即可。** ## 节点模板（直接复制使用） ### deviceInput - 设备触发（属性变化） ```json {"id":"$ID","type":"deviceInput","cfg":{"urn":"$URN","name":"deviceInput","version":1},"props":{"did":"$DID","siid":$SIID,"piid":$PIID,"preload":false,"dtype":"$DTYPE","operator":"=","v1":$V1},"inputs":{},"outputs":{"output":["$NEXT.trigger"]}} ``` ### deviceInput - 设备触发（事件） ```json {"id":"$ID","type":"deviceInput","cfg":{"urn":"$URN","name":"deviceInput","version":1},"props":{"did":"$DID","siid":$SIID,"eiid":$EIID,"preload":false},"inputs":{},"outputs":{"output":["$NEXT.trigger"]}} ``` ### deviceOutput - 控制设备（设置属性） ```json {"id":"$ID","type":"deviceOutput","cfg":{"urn":"$URN","name":"deviceOutput","version":1},"props":{"did":"$DID","siid":$SIID,"piid":$PIID,"value":$VALUE},"inputs":{"trigger":null},"outputs":{"output":[]}} ``` ### deviceOutput - 控制设备（执行动作） ```json {"id":"$ID","type":"deviceOutput","cfg":{"urn":"$URN","name":"deviceOutput","version":1},"props":{"did":"$DID","siid":$SIID,"aiid":$AIID,"ins":[{"piid":$PIID,"value":$VALUE}]},"inputs":{"trigger":null},"outputs":{"output":[]}} ``` ### deviceGet - 查询状态 ```json {"id":"$ID","type":"deviceGet","cfg":{"urn":"$URN","name":"deviceGet","version":1},"props":{"did":"$DID","siid":$SIID,"piid":$PIID,"dtype":"$DTYPE","operator":"=","v1":$V1},"inputs":{"input":null},"outputs":{"output":["$NEXT1.trigger"],"output2":["$NEXT2.trigger"]}} ``` ⚠️ `inputs` 必须用 `input`，不是 `trigger`。`output` 和 `output2` 都应连到 event 节点（如 condition.trigger）。禁止将 output2 连到 state 节点。 ### alarmClock - 定时触发（state 节点） ```json {"id":"$ID","type":"alarmClock","cfg":{"name":"alarmClock","version":1,"happenType":"now","tempOffset":0},"props":{"type":"periodicAlarm","hour":$H,"minute":$M,"second":0,"filter":{"day":[0,1,2,3,4,5,6]}},"inputs":{},"outputs":{"output":["$NEXT.input"]}} ``` ⚠️ state 节点，`inputs: {}`。连 delay 用 `delay1.input`，连 condition 用 `cond1.trigger`。禁止任何节点的 output 连到 alarmClock。 ### timeRange - 时间段（state 节点） ```json {"id":"$ID","type":"timeRange","cfg":{"name":"timeRange","version":1},"props":{"start":{"hour":$SH,"minute":$SM,"second":0},"end":{"hour":$EH,"minute":$EM,"second":0},"filter":{"day":[0,1,2,3,4,5,6]}},"inputs":{},"outputs":{"output":["$NEXT.condition"]}} ``` ⚠️ state 节点，`inputs: {}`。`output` **只能连到 condition.condition**。多分支时 output 数组可包含多个目标（如 `["cond2.condition","cond3.condition"]`）。禁止任何节点的 output 连到 timeRange。禁止使用 output2。 ### delay - 延时 ```json {"id":"$ID","type":"delay","cfg":{"name":"delay","version":1,"unit":"s","value":$SEC},"props":{"timeout":$MS},"inputs":{"input":null},"outputs":{"output":["$NEXT.input"]}} ``` ⚠️ `inputs` 必须是 `{"input": null}`（用 input，不是 trigger）。`props.timeout` 是实际执行的毫秒数（整数）。`cfg.unit` 和 `cfg.value` 是 UI 显示用的，可选。 ### condition - 当-如果-就（条件判断） ```json {"id":"$ID","type":"condition","cfg":{"name":"condition","version":1},"props":{},"inputs":{"trigger":null,"condition":null},"outputs":{"met":["$NEXT1.trigger"],"unmet":["$NEXT2.trigger"]}} ``` ⚠️ **`trigger` 和 `condition` 必须都有信号来源**，缺一不可。`trigger` = "当"（event 节点触发），`condition` = "如果"（state 节点提供条件值）。如果 `condition` 未连接 → 网关默认为 true，条件永远满足。如果 `trigger` 未连接 → 节点永远不会被触发。生成规则后必须遍历 outputs 数组确认两者都有来源。 ### signalOr - 任一事件 ```json {"id":"$ID","type":"signalOr","cfg":{"name":"signalOr","version":1},"props":{},"inputs":{"input0":null,"input1":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ⚠️ 输入名格式必须是 `input` + 连续数字（input0, input1, ...）。 ### logicOr - 满足任一条件 ```json {"id":"$ID","type":"logicOr","cfg":{"name":"logicOr","version":1},"props":{},"inputs":{"input0":null,"input1":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ⚠️ inputs 值可以是 `boolean | null`（状态条件）。 ### logicAnd - 满足全部条件 ```json {"id":"$ID","type":"logicAnd","cfg":{"name":"logicAnd","version":1},"props":{},"inputs":{"input0":null,"input1":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ### logicNot - 状态取反 ```json {"id":"$ID","type":"logicNot","cfg":{"name":"logicNot","version":1},"props":{},"inputs":{"input":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ### loop - 循环 ```json {"id":"$ID","type":"loop","cfg":{"name":"loop","version":1},"props":{"interval":$MS},"inputs":{"start":null,"stop":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ⚠️ `inputs` 是 `{start, stop}`，不是 `input`。已验证。 ### onlyNTimes - 最多触发N次 ```json {"id":"$ID","type":"onlyNTimes","cfg":{"name":"onlyNTimes","version":1},"props":{"n":$N},"inputs":{"input":null,"zero":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ### counter - 达到N次时触发 ```json {"id":"$ID","type":"counter","cfg":{"name":"counter","version":1},"props":{"n":$N},"inputs":{"input":null,"zero":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ### modeSwitch - 模式切换 ```json {"id":"$ID","type":"modeSwitch","cfg":{"name":"modeSwitch","version":1},"props":{},"inputs":{"input":null},"outputs":{"output0":[],"output1":[],"output2":[]}} ``` ⚠️ outputs 根据模式数量声明 output0, output1, ... ### register - 自定义布尔状态 ```json {"id":"$ID","type":"register","cfg":{"name":"register","version":1},"props":{},"inputs":{"setTrue":null,"setFalse":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ### onLoad - 启用时触发（state 节点） ```json {"id":"$ID","type":"onLoad","cfg":{"name":"onLoad","version":1},"props":{},"inputs":{},"outputs":{"output":["$NEXT.trigger"]}} ``` ### statusLast - 状态持续一段时间 ```json {"id":"$ID","type":"statusLast","cfg":{"name":"statusLast","version":1},"props":{"timeout":$MS},"inputs":{"input":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ### eventSequence - 事件先后发生 ```json {"id":"$ID","type":"eventSequence","cfg":{"name":"eventSequence","version":1},"props":{"timeout":$MS},"inputs":{"input1":null,"input2":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ### varSetNumber - 数值运算 ```json {"id":"$ID","type":"varSetNumber","cfg":{"name":"varSetNumber","version":1},"props":{"scope":"global","id":"$VAR_ID","elements":[{"type":"const","value":"$ + 1"}]},"inputs":{"input":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ⚠️ inputs 是 `input`，不是 `trigger`。 ### varSetString - 文本拼接 ```json {"id":"$ID","type":"varSetString","cfg":{"name":"varSetString","version":1},"props":{"scope":"global","id":"$VAR_ID","elements":[{"type":"const","value":"文本"}]},"inputs":{"input":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ### deviceInputSetVar - 设备触发赋值（state 节点） ```json {"id":"$ID","type":"deviceInputSetVar","cfg":{"urn":"$URN","name":"deviceInputSetVar","version":1},"props":{"did":"$DID","siid":$SIID,"piid":$PIID,"dtype":"number","scope":"global","id":"$VAR_ID","preload":false},"inputs":{},"outputs":{"output":["$NEXT.trigger"]}} ``` ⚠️ state 节点，`inputs: {}`。dtype 用 `"number"` 而非 `"int"`/`"float"`。 ### deviceGetSetVar - 查询设备赋值 ```json {"id":"$ID","type":"deviceGetSetVar","cfg":{"urn":"$URN","name":"deviceGetSetVar","version":1},"props":{"did":"$DID","siid":$SIID,"piid":$PIID,"dtype":"number","scope":"global","id":"$VAR_ID"},"inputs":{"input":null},"outputs":{"output":["$NEXT1.trigger"],"output2":["$NEXT2.trigger"]}} ``` ⚠️ 同 deviceGet，`inputs` 用 `input`，outputs 必须有 `output` 和 `output2`。 ### varChange - 变量值更新时触发（state 节点） ```json {"id":"$ID","type":"varChange","cfg":{"name":"varChange","version":1},"props":{"scope":"global","id":"$VAR_ID","varType":"number","preload":true,"operator":">=","v1":$V1},"inputs":{},"outputs":{"output":["$NEXT.trigger"]}} ``` ### varGet - 查询变量值 ```json {"id":"$ID","type":"varGet","cfg":{"name":"varGet","version":1},"props":{"scope":"global","id":"$VAR_ID","varType":"number","operator":">=","v1":$V1},"inputs":{"input":null},"outputs":{"output":["$NEXT1.trigger"],"output2":["$NEXT2.trigger"]}} ``` ⚠️ 同 deviceGet，`inputs` 用 `input`，outputs 必须有 `output` 和 `output2`。 ## 操作符与 dtype | dtype | 允许的 operator | v1 值类型 | |-------|----------------|----------| | boolean | `=` | true/false | | int | `>=`, `<=`, `=`, `!=`, `>`, `<`, `between`, `include` | 整数 | | float | `>`, `<`, `between` | 数字 | | string | `=` | 字符串 | ## 设备控制常见模式 - 开关灯：`siid=2, piid=1, value=true/false` - 亮度：`siid=2, piid=2, value=1-100` - 窗帘开合：`siid=2, piid=1, value=0-100` ## 详细参考 - [完整节点定义与校验规则](references/mijia-complete-reference.md) --- > Source: [allocnode/oh-my-sage](https://github.com/allocnode/oh-my-sage) — distributed by [TomeVault](https://tomevault.io).