--- name: mijia-automation description: 米家自动化极客版规则与变量管理指南。当用户想要创建智能场景、设备联动、定时任务、条件触发,或创建、读取、修改、删除自动化变量时使用此 Skill。 metadata: author: oh-my-sage version: "3.9" --- # 米家自动化规则创建 ## 设计新自动化时的知识检索 不要一开始就堆节点。先把需求拆成:触发、状态、变换、条件、动作、退出、恢复,再读取 [知识索引](references/index.md) 中最相关的一至三个模式文件。 快速选择模式: | 问题 | 模式 | |---|---| | 需要跨事件记住值、模式或时间点 | `PAT-STATE-01` | | 需要计算、映射、取整、量化或夹紧 | `PAT-NUM-01` | | 需要多源汇总、任一/全部或至少 k 个 | `PAT-AGG-01` | | 需要日期、时长、时间窗口或节律 | `PAT-TIME-01` | | 需要重复执行、停止、清零或恢复 | `PAT-LOOP-01` | | 需要设备跟随、双向同步或按实际状态切档 | `PAT-SYNC-01` | | 需要跨设备型号、跨规则、模板或虚拟事件 | `PAT-ADAPT-01` | 常见组合:节律照明 = `TIME + NUM + LOOP`;外部可改档设备 = `STATE + SYNC`;重复提醒 = `STATE + LOOP + ADAPT`。 模式用于选择结构和发现风险,不是固定模板。组合模式后仍须根据目标设备 MIOT Spec 重新确定 DID、URN、字段、量程、步进、枚举和动作参数。不得照抄案例中的设备、阈值、变量名或私有标识。 案例知识按以下状态升级: ```text video → ui-sample → graph-diff → local-tested → gateway-roundtrip → runtime-verified → reusable-pattern ``` 视频案例只是设计线索。未达到 `runtime-verified` 的行为不得写成强制校验规则;达到 `reusable-pattern` 还必须满足脱敏、跨场景适用和边界明确,才可作为通用模式推荐。证据可从真实规则、源码或网关样本开始,不要求机械经过每一级。 完整节点字段按需读取 [米家自动化规则完全参考](references/mijia-complete-reference.md),不要把全部节点模板和全部案例同时加载。 ## 变量生命周期能力 变量管理分为三层,不能把其中一层的限制误判成网关不支持: | 层级 | 能力与限制 | |------|------------| | 网关 API | 支持 `createVar`、`deleteVar`、`getVarValue`、`getVarConfig`、`setVarValue` | | 专用 MCP 工具 | 使用 `mijia_create_variable`、`mijia_delete_variable`、`mijia_get_variable_value`、`mijia_get_variable_config`、`mijia_set_variable` | | 通用原始 API 工具 | `mijia_call_api` 故意只允许只读方法;写方法被拒绝不代表网关没有写能力 | 关键规则: - 新建变量必须调用 `mijia_create_variable`;`mijia_set_variable` 只修改已存在变量,不会自动创建。 - `varSetNumber`、`varSetString`、`deviceInputSetVar` 和 `deviceGetSetVar` 只写已存在变量,不能用作变量创建器。 - 变量 ID 必须匹配 `^[a-zA-Z0-9]+$`,不能含下划线、连字符或中文;显示名称 `name` 可以包含中文。 - `type` 只能是 `number` 或 `string`,初始值和后续值必须与类型一致。 - `createVar` 的显示名称必须放在 `userData: { name }`,不能传顶层 `name`。缺少 `userData.name` 时变量虽可按 ID 读取,但极客版 UI 的变量选择器不会显示它。 - 删除变量前检查所有规则引用;删除是不可恢复操作。 ### 本规则变量的作用域名与创建时机 - 作用域名 = `R` + **规则 ID 的数字部分**,去掉 `graph_` 前缀。例:规则 `graph_1700000000000` → 作用域 `R1700000000000`;规则 `1700000000000` → `R1700000000000`。可用 `mijia_call_api getVarScopeList` 核对。 - 节点里写 `"scope": "rule"` 的自动替换**只发生在** `mijia_create_graph` 和 `mijia_graph_draft_begin`(经由 `variables` 参数)。 - **`mijia_patch_graph` 和 `mijia_update_graph` 都没有 `variables` 参数**。给已有规则新增变量时,必须先单独调用 `mijia_create_variable` 并显式传真实作用域字符串,节点里也要写真实作用域,不能写 `"rule"`。 ### 工具缺失或写入失败时 按以下顺序判断,不要直接宣布“网关无法读写变量”: 1. 查看当前 MCP 工具列表是否包含上述专用变量工具。 2. 工具缺失时检查运行中的 MCP 是否为旧构建;源码新增工具后必须重新构建并重启 MCP,当前进程不会动态注册新工具。 3. 检查 `src/core/tools/variable.ts`、`src/mcp/tools/variable.ts` 和实际运行的 `dist`,确认功能是未实现、未构建还是未加载。 4. `mijia_set_variable` 返回变量不存在时,改用 `mijia_create_variable`,不要尝试用规则节点自动创建。 5. `mijia_call_api` 拒绝 `createVar` 等写方法时,改用专用工具,不要放宽通用工具的只读白名单。 6. 若怀疑功能曾存在但被回归删除,检查 Git 历史或 Session 中的真实工具调用记录,再下结论。 实机验证过的生命周期:创建临时变量 -> 读取配置和值 -> 修改 -> 回读 -> 删除 -> 再次读取确认不存在。创建或恢复变量工具后应完整执行一次该流程,并清理临时变量。 发现网关尚未封装的新能力时,读取 [网关能力发现方法](references/gateway-capability-discovery.md)。不要靠猜测 API 名称,也不要因为当前 MCP 没有工具就判定网关不支持。 ## 规则结构 ```json { "id": "13位纯数字规则ID", "nodes": [节点1, 节点2, ...], "cfg": { "id": "13位纯数字规则ID", "enable": true, "uiType": "graph", "userData": { "name": "规则名称", "lastUpdateTime": 1710000000000, "transform": {"x": 0, "y": 0, "scale": 1, "rotate": 0} } } } ``` **节点位置自动布局**:创建和修改时不需要手动设置 `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.目标端口名"` ### 事件源、条件状态和流程节点 | 类型 | 特征 | 代表节点 | |------|------|----------| | **事件源** | 无输入,主动产生流程事件 | deviceInput, alarmClock, onLoad, varChange | | **条件状态源/变换** | 向 condition 或 logic 提供布尔状态 | timeRange, 设备属性状态, logicOr/logicAnd/logicNot | | **流程节点** | 接收事件后查询、判断、延时或执行 | deviceGet, condition, delay, deviceOutput | **⚠️ 无输入节点不能接收上游连接。条件状态通常连接 `condition.condition`,也可以先进入 `logicOr` / `logicAnd` / `logicNot`,再连接 `condition.condition`。** ### ⚠️ 网关不检查连接完整性(已验证) 网关 `setGraph` **只校验节点级别结构**(字段类型、必填字段),**不校验连接级别的逻辑完整性**。以下错误都能通过网关校验但在运行时不工作: - condition 的 condition 端口未连接 → 网关允许保存,但实测不会执行 met 分支 - deviceGet.output2 连到 state 节点 → 通过校验,但语义错误 **因此,生成规则后必须自行验证连接完整性**,不能依赖网关报错。 ## 工作流程(必须遵循) 当用户要求创建/修改自动化规则时,按以下步骤执行: 1. **理解需求**:分析用户的自动化逻辑,确定需要哪些节点 2. **先写设计表**:列出业务触发、持续状态、true/false/unknown 分支、变量及初值、状态转换、循环启停、恢复动作、失败行为和所选模式 3. **生成节点列表**:按照节点模板和连接规则构建 nodes 数组;超过 10 个节点时先列出事件边和状态边两张连接清单 4. **调用能力校验**:MCP 使用 `mijia_validate_graph_capabilities`,Web Agent 使用 `validate_graph_capabilities`,确认设备字段、权限、类型、范围、动作参数和变量引用 5. **调用结构校验**:MCP 使用 `mijia_validate_graph`,Web Agent 使用 `validate_graph`,检查连接完整性 6. **修复错误**:任一校验器报告 error 时修复并重新校验,直到全部通过 7. **调用 create_graph 或修改工具**:两项校验通过后调用创建/修改工具;工具内部仍会再次校验。MCP 修改已有规则优先用 `mijia_patch_graph`(见下文) 8. **确认结果**:回读规则并确认启用状态、变量作用域和关键节点 设计表使用固定格式: | 项目 | 设计 | |---|---| | 业务触发 | 哪个瞬时事件启动流程 | | 持续状态 | 判断时读取哪些状态,值是否可能陈旧 | | 分支 | true / false 分别做什么;unknown 如何识别和降级 | | 变量 | ID、类型、初值、生产者、清理时机 | | 状态转换 | 当前状态、允许的下一状态、异常兜底 | | 循环 | start、每轮检查、最大次数、stop、zero | | 恢复 | 结束、禁用、重启和人工操作后如何收敛 | | 失败行为 | 查询失败、写入拒绝、校验失败或重试耗尽后停止、保持还是通知 | | 模式与证据 | 选用的 PAT 及关键命题证据等级 | `deviceGet.output2` 只表示比较结果不满足,不是查询失败或 unknown 专口。无法直接区分 unknown 时,用初始化/就绪变量、最后更新时间、在线状态或保守停止表达;不要虚构第三个输出端口。 MCP 模式下**创建**超过 10 个节点的复杂规则时,不要调用两个独立校验工具后再重复发送完整图。先确认当前 MCP 工具列表包含 `mijia_graph_draft_*`,然后使用分块草稿流程。草稿工具不用于更新现有规则(更新见下文 `mijia_patch_graph` 一节)。草稿流程: 1. `mijia_graph_draft_begin` 创建草稿并取得 `draftId`。 2. `mijia_graph_draft_append` 每批追加 5 至 10 个节点,每个节点只上传一次。 3. 校验失败后用 `mijia_graph_draft_edit` 按 ID 修正或删除节点;用 `mijia_graph_draft_status` 查看轻量状态。 4. `mijia_graph_draft_commit` 只传 `draftId`;服务端一次完成结构校验、设备能力校验、布局和创建,不再调用两个独立校验工具。 5. 放弃方案时调用 `mijia_graph_draft_discard`;草稿会临时持久化并在 30 分钟后自动过期。 小规则和 Web Agent 继续使用原双校验流程。草稿工具缺失时不要虚构调用,改用原流程。复杂规则草稿提交失败时会保留;成功响应丢失或重复提交时返回同一个规则 ID。 ### 修改已有规则:用紧凑文本,一条规则一读一写 读写已有规则时优先使用 [规则文本格式](../../../docs/rule-text-format.md),不要来回传节点 JSON。MCP 与 Web Agent 都有这组工具,参数相同;下文写 MCP 工具名,Web Agent 去掉 `mijia_` 前缀即可(`get_graph`、`patch_graph`、`put_graph_text`、`query_rules`、`get_log`、`check_layout`)。 1. **读**:`mijia_get_graph {id, format:"text"}` 一次拿到备注(Markdown)和全部节点(一行一个)以及 `hash`。大规则只看相关部分:`focus:["节点ID"], depth:1`。已读过且只想确认没变:`ifNoneMatch:`。 2. **找引用**:「谁在读某变量 / 谁在写某设备属性」用 `mijia_query_rules {variable:"$livingOccupied"}` 或 `{device:"客厅音箱", property:"2/1"}`,不要逐条读规则。 3. **写**:一次 `mijia_patch_graph` 完成全部改动: - `add`:新增节点的文本,可多行,可含 `var` 声明和 `@tts`、`@pulse` 宏;ID 已存在会拒绝,不会误覆盖。 - `replace`:整行替换已有节点;ID 不存在会拒绝。 - `merge`:只改个别字段或连线(`outputs` 按端口整体替换),`removeIds`:删除节点并清理连线。 - `note`:`{section, append}`、`{replace, with}`、`{changelog}` 修改备注,不用手工拼富文本,高度自动调整。 - `variables`:需要的变量,不存在才创建,写入失败自动删除。 - `positions`:`{节点ID: {x, y}}` 只挪卡片;只挪位置也会保存。 - `layout`:默认只给新卡片找空位;整理乱掉的规则用 `{mode:"full"}` 全图重排,`pinned` 指定不动的卡片。 - `baseHash` 必传;挪卡片或重排时同时传 `baseLayoutHash`(读取时返回的 `layoutHash`),防止覆盖别人在 App 里挪过的位置。`dryRun:true` 只预览。 4. **不必再单独校验和回读**:写入前已做结构与设备能力两项校验;返回值里的 `diff` 就是改动节点写入后的文本。 5. **交付前看布局**:返回值的 `layout` 列出重叠、可能重叠、穿卡连线数和交叉估计;需要确认坐标确实存进网关时传 `verifyLayout:true`(多一次网关往返),结果在 `savedPositionsVerified`。有问题先修再交付,修不了就如实报告。也可随时用只读的 `mijia_check_layout {id}` 检查,或带上 `positions` / `layout` 预览效果。穿卡和交叉是估计值,不代表原生网页实际显示,只用来判断是否好维护。保存会整条重写规则,网关可能重新加载规则,进行中的延时不保证延续,挪卡片也一样。 6. **改动很大**:MCP 下用 `scripts/rules.mjs pull` 把规则拉成本地文件,用普通文件编辑只改需要的行,再 `push`(服务端为 `mijia_put_graph_text`);Web Agent 直接把改好的完整文本交给 `put_graph_text`。 7. **看执行情况**:`mijia_get_log {graph, minutes}`;先用 `summary:true` 看各节点执行次数,找出执行链断在哪一步。 8. `mijia_update_graph` 是整图替换,仅兼容保留,只在补丁无法表达时使用。 **⚠️ create_graph / patch_graph / put_graph_text / 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,"piid":$PIID,"id":"$VAR_ID","scope":"$SCOPE","dtype":"number","min":$MIN,"max":$MAX,"step":$STEP},"inputs":{"trigger":null},"outputs":{"output":[]}} ``` ⚠️ 极客版 UI 实测支持将规则变量直接写入设备属性。`dtype` 数值属性用 `number`,`min/max/step` 必须与目标 MIOT 属性范围一致。 ### 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 节点。 `deviceGet` 取得网关可用于判定的属性值,不得默认等同于物理设备的实时状态。缓存、最近上报、离线和未知值语义需按设备与固件实测;安全动作必须设计未知/旧值保护。 ### alarmClock - 定时触发(事件源) ```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"]}} ``` ⚠️ 事件源,`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`,也可连到 `logicOr.inputN` / `logicAnd.inputN` / `logicNot.input` 后再进入 `condition.condition`。多分支时 output 数组可包含多个目标。禁止任何节点的 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/logic 节点提供条件值)。`condition` 未连接时网关虽允许保存,但实测不会执行 met 分支;`trigger` 未连接时节点不会被触发。 ### 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.condition"]}} ``` ⚠️ inputs 值可以是 `boolean | null`(状态条件)。 ### logicAnd - 满足全部条件 ```json {"id":"$ID","type":"logicAnd","cfg":{"name":"logicAnd","version":1},"props":{},"inputs":{"input0":null,"input1":null},"outputs":{"output":["$NEXT.condition"]}} ``` ### logicNot - 状态取反 ```json {"id":"$ID","type":"logicNot","cfg":{"name":"logicNot","version":1},"props":{},"inputs":{"input":null},"outputs":{"output":["$NEXT.condition"]}} ``` ### 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, ... 空 outputs 仍占用并推进一个模式轮次,当前网关已实测;规则重启后的游标位置仍需验证。外部 App、语音或实体控制会改变设备状态时,优先使用状态查询链,不依赖内部游标。 ### register - 自定义布尔状态 ```json {"id":"$ID","type":"register","cfg":{"name":"register","version":1},"props":{},"inputs":{"setTrue":null,"setFalse":null},"outputs":{"output":["$NEXT.trigger"]}} ``` ⚠️ `outputs.output` 是**上升沿触发**(已实测):只在 false → true 那一刻发一次信号;`setFalse` 不发,重复 `setTrue` 也不发。接 `condition.condition` 时当状态读,接 `xxx.trigger` 时当上升沿事件用。需要「变 false 时也执行动作」必须另引事件链。 ### onLoad - 启用时触发(事件源) ```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 - 设备触发赋值(事件源) ```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"]}} ``` ⚠️ 无输入事件源,`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":["$NEXT.trigger"]}} ``` ⚠️ `inputs` 用 `input`。极客版 UI 实测只生成 `outputs.output`,没有 `output2`;不要套用 `deviceGet` 的双输出结构。 ### varChange - 变量值更新时触发(事件源) ```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)