msg.tempAvg = (msg.temp1 + msg.temp2) / 2;

msg.tempAvg = (msg.temp1 + msg.temp2) / 2;
return {msg:msg, metadata:metadata, msgType:msgType};

转换节点只写 msg.x=1 不 return，引擎直接拒绝。这是头号坑。

出错时会看到：Wrong result type: Double

var limit = metadata.ss_tempHighLimit;

节点读属性时自动加 ss_ 前缀，漏了会拿到 null。

出错时会看到：null pointer

if (metadata.ss_tempHighLimit > 40) { }

var limit = parseDouble(metadata.ss_tempHighLimit);
if (limit > 40) { }

属性的值都是字符串，"45" 跟数字比会得出字符串比较的怪结果。

出错时会看到：不报错，但判断结果错——最危险

if (msg.pump) { }

if (msg.pump == true) { }
if (msg.temp1 == null) { }

泵状态可能是 1 / true / "true"，统一用 == true，与现有代码一致。

出错时会看到：不报错，但漏判

if (msg.temp1 == "25.4") { }

var t = msg.temp1;
if (t != null && t > 25) { }

设备发字符串数字会被当成“缺失”，还会触发 SENSOR_DATA_MISSING。

出错时会看到：不报错，但静默走错分支

var out = [];
out.push('A');
if (out.length > 0) { }

var out = [];
out.add('A');
if (out.size() > 0) { }

TBEL 是 Java 风格，写 push/length 直接报错。

出错时会看到：编译报错

var n = metadata.autoPlan.commands.size();

var p = JSON.parse(metadata.autoPlan);
var n = p.commands.size();

显式 parse 更稳妥，意图也更清楚。

出错时会看到：null pointer 或取不到值

return {msg:msg, metadata:metadata, msgType:msgType};

return msg.pump == true;

过滤器只有两个出口，返回对象会被拒绝。

出错时会看到：Wrong result type

return msg.temperatureAlarm == true;

var out = [];
if (msg.temperatureAlarm == true) out.add('TEMP_ALARM');
return out;

出口名称必须与连线的关系类型逐字一致，否则消息走不出去，看起来像“没反应”。

出错时会看到：消息无输出

if (metadata.extensionRoute == 'FEATURE' + id) { }

var route = 'FEATURE_' + msg.featureId;
if (route.contains('FEATURE_')) { }

+ 拼字符串，contains 判包含。布尔一律 == true，别依赖隐式转换。

出错时会看到：不报错但结果不符预期

C 风格 for 循环可用

var s=0; for(var i=0;i<5;i++){ s=s+i; } msg.r=s; return {msg:msg,metadata:metadata,msgType:msgType};

while 循环可用

var i=0; while(i<3){ i++; } msg.r=i; return {msg:msg,metadata:metadata,msgType:msgType};

复合赋值 += -= *= /= 可用

var x=10; x+=5; x-=2; x*=2; x/=4; msg.r=x; return {msg:msg,metadata:metadata,msgType:msgType};

自增 ++ 自减 -- 可用

var i=0; i++; i++; i--; msg.r=i; return {msg:msg,metadata:metadata,msgType:msgType};

取余 % 可用（现用于判断整数占空比）

msg.r = (50.5 % 1 != 0); return {msg:msg,metadata:metadata,msgType:msgType};

函数可以在文件任意位置定义

msg.r=twice(msg.n);
function twice(v){ return v*2; }
return {msg:msg,metadata:metadata,msgType:msgType};

函数里可以写 if 和 return

function pick(t){ if(t==null){ return -1; } if(t>30){ return 1; } return 0; }
msg.r=pick(msg.n); return {msg:msg,metadata:metadata,msgType:msgType};

switch/case 可用（case 与语句必须换行）

var m='B'; var r=0;
switch(m){
  case 'A':
    r=1;
    break;
  case 'B':
    r=2;
    break;
}
msg.r=r; return {msg:msg,metadata:metadata,msgType:msgType};

for 里 break 可用

var s=0;
for(var i=0;i<9;i++){
  if(i==4){ break; }
  s=s+i;
}
msg.r=s; return {msg:msg,metadata:metadata,msgType:msgType};

数组有 .size() 和 .length 两种写法

var a=[1,2,3]; msg.r = a.size() + a.length; return {msg:msg,metadata:metadata,msgType:msgType};

continue 不支持（用 if 包住循环体替代）

var s=0;
for(var i=0;i<5;i++){
  if(i==2){ continue; }
  s=s+i;
}

顶层裸大括号代码块不合法

var a=1;
{
  msg.r=a+1;
}

空值与数字比较不报错，静默返回 false

msg.r = (msg.missing > 30);

短路保护写反了不会报错，只会算错

var t=msg.missing; msg.r = (t > 30 && t != null);

字符串与数字宽松相等（1=="1" 为真）

msg.r = ('1' == 1);

布尔与数字宽松相等（true==1 为真）

msg.r = (true == 1);

parseDouble(null) 会报错，要先判空

msg.r = parseDouble(metadata.ss_missing);

除以 0 得到 Infinity，不是报错

msg.r = 5 / 0;

对 0 取模会报错（/ by zero）

msg.r = 5 % 0;

改哪里：设备服务端属性

1. 打开设备 iot_race → 属性 → 服务端属性
2. 改 tempLowLimit / tempHighLimit / maxTempDiff / minFlow / minPressure / maxPressure
3. 下一帧遥测立即生效，不用部署

改哪里：autoConfig

1. control.cjs configure --sensor temp1 --target 38 --hysteresis 1.5
2. 或面板「自动温控」页签填表后点保存

改哪里：autoConfig

1. 先把泵和加热器都关掉并确认遥测
2. control.cjs dose --liters 2 --duty 60 --maxFlow 20

改哪里：autoConfig.flowScale

1. 做一次已知体积的输送，比如用量杯接 1 L
2. 比较 autoRuntime.totalL 与实测体积
3. 新 flowScale = 旧值 × (实测 ÷ 平台累计)

改哪里：「等待遥测超时检查」节点

1. 规则链编辑器里双击该节点
2. 改 periodInSeconds（当前 6）

改哪里：统一键名节点 + 安全状态分流节点

1. 在「统一键名并计算状态」脚本末尾加一行：msg.tempJumpAlarm = msg.tempDiff != null && msg.tempDiff > 3;
2. 在「安全状态分流」脚本里追加出口：result.push(msg.tempJumpAlarm ? 'TEMPJUMP_ALARM' : 'TEMPJUMP_CLEAR');
3. 新建一个创建告警节点和一个清除告警节点，告警类型字符串必须完全一致
4. 从分流节点连出 TEMPJUMP_ALARM 和 TEMPJUMP_CLEAR 两条线
5. 改完把规则链导出覆盖回 iot_race_rule_chain.json

改哪里：告警节点后面

1. 把一个发送邮件节点拖到「温度异常告警」的下游
2. 连接类型选 Created
3. 配置收件人和正文模板

改哪里：controller.tbel 里的 8000

1. 改 controller.tbel 中停机段的 now - r.lastCommandAt >= 8000
2. build.cjs → verify.cjs → sync-dashboard.cjs

改哪里：autoConfig

1. 方式一：control.cjs stop，自动模式变 OFF，告警完全不受影响
2. 方式二：把 controlCapabilities 里对应功能的 enabled 改成 false（handled 保持 true）
3. 方式三：删掉「保存遥测与派生状态」到「读取自动控制参数」的连线（排障用，记得改回来）

原有模板部分。遥测统一键名、存时序、跑四个维度的告警。这条线跟自动控制完全独立，自动控制关掉它照常工作。

消息类型分流
唯一入口。按消息类型分三路：遥测走主数据路径，RPC 请求先过手动接管判断，属性更新进扩展命令入口。

读取安全阈值
从设备服务端属性读 6 个阈值放进 metadata。所以改阈值不用动规则链。

统一键名并计算状态
把 temperature1/t1/flow/press 等别名统一成标准键，并算出 tempAvg、tempDiff、sensorFault、temperatureAlarm、pressureAlarm、flowAlarm。

保存遥测与派生状态
存所有键为遥测，用设备时间戳。自动控制判断“数据是否新鲜”就靠它。

安全状态分流
按 4 个独立维度输出最多 8 个分支，互不压制。

温度异常告警

清除温度告警

压力异常告警

清除压力告警

开泵无流量告警

清除无流量告警

传感器缺失告警

清除传感器告警

读意图和事实 → TBEL 状态机算决策 → 存状态 → 存遥测。

读取自动控制参数
读 autoConfig（意图）和 autoRuntime（事实）。

计算自动控制状态
整条链的核心：TBEL 状态机。判新鲜度、认新 runId、校验参数、累计输送量、决定是否发指令、决定是否停机、判断停机是否已确认。

需要保存自动状态
只有 autoWrite=true 才往下走。不新鲜或重复的帧在这里被丢掉。

保存自动控制状态
把 autoRuntime 存回服务端属性。先记账、后动作。

生成自动控制遥测
把 autoMode/autoStatus/autoReason/deliveredLiters 变成遥测，供仪表板显示。

保存自动控制遥测

有指令时逐条下发并记录设备反馈。停机是“先关加热器、再停泵”，串行执行。

自动控制动作分流
按 metadata 分流：COMMAND=有指令要发，WATCH=要安排看门狗。

生成第一条自动指令
把 autoPlan.commands[0] 还原成 RPC。停机时第一条通常是关加热器。

下发第一条自动指令
下发 RPC，超时 3 秒。Success 和 Failure 都接同一结果节点，超时也留痕。

记录第一条指令结果
比对设备真实反馈与期望值，写出 autoRpcConfirmed。

保存第一条指令结果

还有第二条停机指令
commands 超过 1 条时继续，通常意味着“关加热器之后还要停泵”。

生成第二条停机指令

下发第二条停机指令

记录第二条指令结果

保存第二条指令结果

每帧运行任务安排一次 6 秒后的检查。设备失联就锁定任务并尝试停机。这套节点是复制出来的，脚本内容由 build.cjs 自动同步。

准备遥测看门狗
生成空消息，类型改为 AUTO_WATCHDOG。6 秒后重新读状态，不用现在的快照。

等待遥测超时检查
延迟 6 秒放行。这个秒数在节点表单里改，不用写脚本。

超时读取自动控制参数

超时计算自动控制状态
同一个状态机走 watch 分支：任务还在跑且超过 5 秒没遥测，就判 TELEMETRY_TIMEOUT 并要求停机。

超时需要保存自动状态

超时保存自动控制状态

超时生成自动控制遥测

超时保存自动控制遥测

需要超时停机指令

面板点泵/加热器开关会走这条。先把自动模式置 OFF，再执行你的指令。不依赖状态机，任何时候可用。

手动控制接管判断
判断 RPC 方法是不是 Pump/Heater/setPump。是就进接管流程。

保存原始手动请求

读取手动接管前状态

手动接管退出自动模式
把 autoConfig.mode 置 OFF，autoRuntime 置 MANUAL / MANUAL_TAKEOVER。

保存手动接管状态

恢复手动控制请求
把用户原始请求原样还原并下发。接管只关自动模式，不动别的执行器。

手动指令与自动指令最终都汇总到这里发给设备。

下发泵和加热器 RPC
手动指令真正落地的地方，只在这里下发一次。

保存客户端属性
保存设备上报的客户端属性，仅在值变化时更新。

给未来功能预留的协议化通道。当前没有注册处理器，未知功能会被拒绝并回写原因。

扩展功能命令入口
只有带 controlCommand 的属性更新才继续。

读取扩展命令回执

校验扩展命令协议
校验版本、requestId、时间戳、operation，并按已注册处理器判断功能是否支持。

扩展命令去重

保存扩展命令回执

恢复扩展命令参数

后续功能分发接口
按 extensionRoute 输出分支。当前没有注册任何 FEATURE_ 分支，所以扩展命令一律被拒绝。