How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/allocnode/oh-my-sage --skill mijia-automationBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
米家自动化规则创建
设计新自动化时的知识检索
不要一开始就堆节点。先把需求拆成:触发、状态、变换、条件、动作、退出、恢复,再读取 知识索引 中最相关的一至三个模式文件。
快速选择模式:
| 问题 | 模式 |
|---|---|
| 需要跨事件记住值、模式或时间点 | 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、字段、量程、步进、枚举和动作参数。不得照抄案例中的设备、阈值、变量名或私有标识。
案例知识按以下状态升级:
video → ui-sample → graph-diff → local-tested → gateway-roundtrip → runtime-verified → reusable-pattern视频案例只是设计线索。未达到 runtime-verified 的行为不得写成强制校验规则;达到 reusable-pattern 还必须满足脱敏、跨场景适用和边界明确,才可作为通用模式推荐。证据可从真实规则、源码或网关样本开始,不要求机械经过每一级。
完整节点字段按需读取 米家自动化规则完全参考,不要把全部节点模板和全部案例同时加载。
变量生命周期能力
变量管理分为三层,不能把其中一层的限制误判成网关不支持:
| 层级 | 能力与限制 |
|---|---|
| 网关 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"。
工具缺失或写入失败时
按以下顺序判断,不要直接宣布“网关无法读写变量”:
- 查看当前 MCP 工具列表是否包含上述专用变量工具。
- 工具缺失时检查运行中的 MCP 是否为旧构建;源码新增工具后必须重新构建并重启 MCP,当前进程不会动态注册新工具。
- 检查
src/core/tools/variable.ts、src/mcp/tools/variable.ts和实际运行的dist,确认功能是未实现、未构建还是未加载。 mijia_set_variable返回变量不存在时,改用mijia_create_variable,不要尝试用规则节点自动创建。mijia_call_api拒绝createVar等写方法时,改用专用工具,不要放宽通用工具的只读白名单。- 若怀疑功能曾存在但被回归删除,检查 Git 历史或 Session 中的真实工具调用记录,再下结论。
实机验证过的生命周期:创建临时变量 -> 读取配置和值 -> 修改 -> 回读 -> 删除 -> 再次读取确认不存在。创建或恢复变量工具后应完整执行一次该流程,并清理临时变量。
发现网关尚未封装的新能力时,读取 网关能力发现方法。不要靠猜测 API 名称,也不要因为当前 MCP 没有工具就判定网关不支持。
规则结构
{
"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 估算;检查重叠时按设备卡片原生可能的最大尺寸留出余量。
- 写入前对全部卡片做碰撞复检:本次摆放或移动的卡片与任何卡片重叠时拒绝写入。
关键校验规则
- 节点 id:只允许
[0-9a-zA-Z],不能用下划线、连字符 - outputs 连接格式:
"portName": ["nodeId.inputPort"](必须是点分隔,如"cond1.trigger")
- ❌ 错误:
"output": ["range1"](缺少.inputPort) - ✅ 正确:
"output": ["range1.trigger"]
- outputs 值必须是数组:
"output": []✓,"output": null✗ - 所有节点必须声明 outputs 端口:即使没有输出连接,也要声明端口(如
"outputs": {"output": []}) - deviceGet:必须有
outputs.output和outputs.output2 - inputs 命名:
deviceGet,varGet,statusLast, `delay` 用inputdeviceOutput,condition等用triggertimeRange,alarmClock等源节点没有输入端口(inputs: {})
- dtype 映射:
bool→boolean,uint8/int32→int,float→float - props 必须存在:
"props": {}不能省略 - cfg.name:值为节点类型名(如
"deviceInput") - 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 数组,确保:
- 引用的目标节点 ID 存在
- 引用的端口名是目标节点 inputs 中声明的端口名
- 点分隔格式正确:
"目标节点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 节点 → 通过校验,但语义错误
因此,生成规则后必须自行验证连接完整性,不能依赖网关报错。
工作流程(必须遵循)
当用户要求创建/修改自动化规则时,按以下步骤执行:
- 理解需求:分析用户的自动化逻辑,确定需要哪些节点
- 先写设计表:列出业务触发、持续状态、true/false/unknown 分支、变量及初值、状态转换、循环启停、恢复动作、失败行为和所选模式
- 生成节点列表:按照节点模板和连接规则构建 nodes 数组;超过 10 个节点时先列出事件边和状态边两张连接清单
- 调用能力校验:MCP 使用
mijia_validate_graph_capabilities,Web Agent 使用validate_graph_capabilities,确认设备字段、权限、类型、范围、动作参数和变量引用 - 调用结构校验:MCP 使用
mijia_validate_graph,Web Agent 使用validate_graph,检查连接完整性 - 修复错误:任一校验器报告 error 时修复并重新校验,直到全部通过
- 调用 create_graph 或修改工具:两项校验通过后调用创建/修改工具;工具内部仍会再次校验。MCP 修改已有规则优先用
mijia_patch_graph(见下文) - 确认结果:回读规则并确认启用状态、变量作用域和关键节点
设计表使用固定格式:
| 项目 | 设计 |
|---|---|
| 业务触发 | 哪个瞬时事件启动流程 |
| 持续状态 | 判断时读取哪些状态,值是否可能陈旧 |
| 分支 | true / false 分别做什么;unknown 如何识别和降级 |
| 变量 | ID、类型、初值、生产者、清理时机 |
| 状态转换 | 当前状态、允许的下一状态、异常兜底 |
| 循环 | start、每轮检查、最大次数、stop、zero |
| 恢复 | 结束、禁用、重启和人工操作后如何收敛 |
| 失败行为 | 查询失败、写入拒绝、校验失败或重试耗尽后停止、保持还是通知 |
| 模式与证据 | 选用的 PAT 及关键命题证据等级 |
deviceGet.output2 只表示比较结果不满足,不是查询失败或 unknown 专口。无法直接区分 unknown 时,用初始化/就绪变量、最后更新时间、在线状态或保守停止表达;不要虚构第三个输出端口。
MCP 模式下创建超过 10 个节点的复杂规则时,不要调用两个独立校验工具后再重复发送完整图。先确认当前 MCP 工具列表包含 mijia_graph_draft_*,然后使用分块草稿流程。草稿工具不用于更新现有规则(更新见下文 mijia_patch_graph 一节)。草稿流程:
mijia_graph_draft_begin创建草稿并取得draftId。mijia_graph_draft_append每批追加 5 至 10 个节点,每个节点只上传一次。- 校验失败后用
mijia_graph_draft_edit按 ID 修正或删除节点;用mijia_graph_draft_status查看轻量状态。 mijia_graph_draft_commit只传draftId;服务端一次完成结构校验、设备能力校验、布局和创建,不再调用两个独立校验工具。- 放弃方案时调用
mijia_graph_draft_discard;草稿会临时持久化并在 30 分钟后自动过期。
小规则和 Web Agent 继续使用原双校验流程。草稿工具缺失时不要虚构调用,改用原流程。复杂规则草稿提交失败时会保留;成功响应丢失或重复提交时返回同一个规则 ID。
修改已有规则:用紧凑文本,一条规则一读一写
读写已有规则时优先使用 规则文本格式,不要来回传节点 JSON。MCP 与 Web Agent 都有这组工具,参数相同;下文写 MCP 工具名,Web Agent 去掉 mijia_ 前缀即可(get_graph、patch_graph、put_graph_text、query_rules、get_log、check_layout)。
- 读:
mijia_get_graph {id, format:"text"}一次拿到备注(Markdown)和全部节点(一行一个)以及hash。大规则只看相关部分:focus:["节点ID"], depth:1。已读过且只想确认没变:ifNoneMatch:<hash>。 - 找引用:「谁在读某变量 / 谁在写某设备属性」用
mijia_query_rules {variable:"$livingOccupied"}或{device:"客厅音箱", property:"2/1"},不要逐条读规则。 - 写:一次
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只预览。
- 不必再单独校验和回读:写入前已做结构与设备能力两项校验;返回值里的
diff就是改动节点写入后的文本。 - 交付前看布局:返回值的
layout列出重叠、可能重叠、穿卡连线数和交叉估计;需要确认坐标确实存进网关时传verifyLayout:true(多一次网关往返),结果在savedPositionsVerified。有问题先修再交付,修不了就如实报告。也可随时用只读的mijia_check_layout {id}检查,或带上positions/layout预览效果。穿卡和交叉是估计值,不代表原生网页实际显示,只用来判断是否好维护。保存会整条重写规则,网关可能重新加载规则,进行中的延时不保证延续,挪卡片也一样。 - 改动很大:MCP 下用
scripts/rules.mjs pull把规则拉成本地文件,用普通文件编辑只改需要的行,再push(服务端为mijia_put_graph_text);Web Agent 直接把改好的完整文本交给put_graph_text。 - 看执行情况:
mijia_get_log {graph, minutes};先用summary:true看各节点执行次数,找出执行链断在哪一步。 mijia_update_graph是整图替换,仅兼容保留,只在补丁无法表达时使用。
⚠️ create_graph / patch_graph / put_graph_text / update_graph 内置了校验逻辑。如果节点连接有 error 级别的问题,工具会返回错误并拒绝调用 setGraph。修复后重新调用即可。
节点模板(直接复制使用)
deviceInput - 设备触发(属性变化)
{"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 - 设备触发(事件)
{"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 - 控制设备(设置属性)
{"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 - 使用变量动态设置属性
{"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 - 控制设备(执行动作)
{"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 - 查询状态
{"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 - 定时触发(事件源)
{"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 节点)
{"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 - 延时
{"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 - 当-如果-就(条件判断)
{"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 - 任一事件
{"id":"$ID","type":"signalOr","cfg":{"name":"signalOr","version":1},"props":{},"inputs":{"input0":null,"input1":null},"outputs":{"output":["$NEXT.trigger"]}}⚠️ 输入名格式必须是 input + 连续数字(input0, input1, ...)。
logicOr - 满足任一条件
{"id":"$ID","type":"logicOr","cfg":{"name":"logicOr","version":1},"props":{},"inputs":{"input0":null,"input1":null},"outputs":{"output":["$NEXT.condition"]}}⚠️ inputs 值可以是 boolean | null(状态条件)。
logicAnd - 满足全部条件
{"id":"$ID","type":"logicAnd","cfg":{"name":"logicAnd","version":1},"props":{},"inputs":{"input0":null,"input1":null},"outputs":{"output":["$NEXT.condition"]}}logicNot - 状态取反
{"id":"$ID","type":"logicNot","cfg":{"name":"logicNot","version":1},"props":{},"inputs":{"input":null},"outputs":{"output":["$NEXT.condition"]}}loop - 循环
{"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次
{"id":"$ID","type":"onlyNTimes","cfg":{"name":"onlyNTimes","version":1},"props":{"n":$N},"inputs":{"input":null,"zero":null},"outputs":{"output":["$NEXT.trigger"]}}counter - 达到N次时触发
{"id":"$ID","type":"counter","cfg":{"name":"counter","version":1},"props":{"n":$N},"inputs":{"input":null,"zero":null},"outputs":{"output":["$NEXT.trigger"]}}modeSwitch - 模式切换
{"id":"$ID","type":"modeSwitch","cfg":{"name":"modeSwitch","version":1},"props":{},"inputs":{"input":null},"outputs":{"output0":[],"output1":[],"output2":[]}}⚠️ outputs 根据模式数量声明 output0, output1, ... 空 outputs 仍占用并推进一个模式轮次,当前网关已实测;规则重启后的游标位置仍需验证。外部 App、语音或实体控制会改变设备状态时,优先使用状态查询链,不依赖内部游标。
register - 自定义布尔状态
{"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 - 启用时触发(事件源)
{"id":"$ID","type":"onLoad","cfg":{"name":"onLoad","version":1},"props":{},"inputs":{},"outputs":{"output":["$NEXT.trigger"]}}statusLast - 状态持续一段时间
{"id":"$ID","type":"statusLast","cfg":{"name":"statusLast","version":1},"props":{"timeout":$MS},"inputs":{"input":null},"outputs":{"output":["$NEXT.trigger"]}}eventSequence - 事件先后发生
{"id":"$ID","type":"eventSequence","cfg":{"name":"eventSequence","version":1},"props":{"timeout":$MS},"inputs":{"input1":null,"input2":null},"outputs":{"output":["$NEXT.trigger"]}}varSetNumber - 数值运算
{"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 - 文本拼接
{"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 - 设备触发赋值(事件源)
{"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 - 查询设备赋值
{"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 - 变量值更新时触发(事件源)
{"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 - 查询变量值
{"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