规则引擎功能说明

了解当前版本规则引擎的全部页面功能、配置方法、状态含义与运行边界。

阅读方法

先确认入口、权限和目标对象，再按编号完成操作。每一步都包含预期结果；详细字段和选项收在可展开的参考表中。

截图说明

截图来自原始操作手册。公开版会隐藏真实节点地址、连接地址和凭据；示例中的状态、时间和数据不代表当前生产环境。

开始前准备

项目	说明
能做什么	逐项掌握规则管理、配置、模拟、发布与追踪的实际功能。
从哪里进入	规则引擎 → 规则列表 → 编辑器
需要权限	查询、编辑、测试、发布和删除权限按职责分别配置。
预计时间	90 分钟

阅读导航与功能全景

蜂信物联（FastBee）规则引擎把设备上报、在线状态与时间计划转换成自动化业务流程。本册适用于当前 V4 规则工作台，按功能解释入口、字段、选项、运行状态和限制；《规则引擎场景使用手册》则按 18 个业务目标给出完整配置教程。首次使用可先阅读本册的工作台、触发、条件和动作，再按场景手册完成一条规则。

一条规则由触发入口、入口条件、执行流程和规则策略组成。触发入口回答“何时检查”，入口条件回答“是否开始”，执行流程回答“做什么、按什么次序做”，策略限制数据有效期、重复执行与失败后的处理。条件分支可以在执行过程中再次判断；延时只等待，不会自动复核条件。

本册依据 2026 年 9 月 27 日的当前版本页面与源码核对，配有本轮功能巡检和同批场景验证的真实页面图。设备动作、通知、Webhook、AI 的配置能力与外部执行结果分别说明。完整真实业务演示请结合场景手册；尚未接入的外部资源不承诺已经联通。

按角色找到要做的事

• 实施人员：第一次配置：场景复用 → 工作台 → 触发与条件 → 对应动作 → 模拟 → 发布。完成一条已绑定真实资源、已验证样例且经运行确认的规则
• 业务管理员：调整现有逻辑：规则列表 → 草稿与设置 → 画布排序/分支 → 版本发布。修改已作为新版本生效，原有执行实例可按旧版本追踪
• 运维人员：发现规则未执行：执行追踪 → 五分钟诊断 → 常见问题。能区分没有触发、条件不满足、无法判断、等待和动作失败
• 平台管理员：准备基础资源：产品与设备物模型、告警定义、通知资源、Webhook连接器、AI助手、角色权限。相关资源在当前租户选择框可用，字段类型与动作目标兼容

完整功能索引

• 规则管理：名称/状态筛选、查询重置、批量删除、复制、暂停恢复、历史版本恢复为草稿。规则列表与日常管理
• 可视编辑：节点库、画布与完整表单、独立属性栏、分组摘要、插入排序、布局、撤销重做。工作台；流程编排
• 规则逻辑：5类触发、组合条件、最近状态、6类动作、顺序并行、IF、延时、数据引用。触发至六类动作章节
• 配置提效：18场景、资源映射、集中参数调整、待配置项定位、AI生成草稿。场景复用；AI辅助
• 验证与运行：草稿校验、模拟样例、虚拟时间、预检、发布确认、版本、追踪、回执、诊断、终止实例。草稿与设置；模拟；发布；追踪

使用时请同时确认以下边界。

• 截图中的设备、产品和告警名称是演示资源；实际使用时选择本租户已有资源。
• 单文件 HTML 可离线阅读，左侧目录用于跳转，页面搜索用于查找功能名；图片可点击查看，浏览器打印可保存为 PDF。

1. 认识规则工作台

操作位置： 规则引擎→规则编辑器

查看顶部规则名称与保存状态，按左侧节点库、中间流程和右侧属性区认识工作台。

图：认识规则工作台

关键控件速查

配置项	用途与使用建议	生效与恢复
草稿与运行状态	顶部草稿状态说明编辑内容是否保存；运行状态说明发布版本是否已经启用；怎么看：分别读取两个状态，不能用草稿已保存代替已生效。	数据 · 来源：当前草稿与运行节点确认结果；真实事件由已生效版本处理；未发布草稿不参与运行。

规则列表与日常管理

规则列表是进入规则引擎的管理入口，默认以紧凑卡片展示。每张卡片集中展示规则名称与状态、触发器、作用范围、最近执行、运行版本和更新时间；右上角可切换为列表。编辑、模拟、发布与执行追踪在编辑页完成。

先用规则名称和状态筛选，再根据作用范围、最近执行和运行版本判断要处理的规则。状态不是简单的开关：草稿还未成为运行版本，候选版本待生效表示发布已提交但运行节点还在确认，已生效才会接收新事件，已暂停不再接收新的入口。

列表中的创建和管理操作

• 卡片／列表：点击规则区域右上角“卡片”或“列表”，选择浏览方式。切换只改变展示方式，保留当前查询条件和页码，同时清空已勾选项。
• 空白创建：点击列表右上角“空白创建”，从触发器、条件和动作开始配置。进入空白草稿；未保存前没有规则编号，也不会影响运行。
• 从场景创建：点击“从场景创建”，选择内置场景后按向导绑定本租户资源并调整参数。场景只提供规则骨架和示例，不携带真实租户资源编号。具体配置见场景使用手册。
• 编辑：点击卡片底部或列表行内的“编辑”。打开该规则的草稿；顶部运行状态仍指向当前已发布版本。
• 复制规则：在“更多”中点击“复制规则”，在资源复用向导中检查并替换设备、字段和动作资源。保存后才形成独立规则；原规则不被修改。失效或不匹配资源必须重新绑定。
• 暂停／恢复：已生效规则显示“暂停”，其他可恢复状态显示“恢复”。暂停阻止新的规则入口；已在运行或等待的流程仍按原发布版本完成。恢复使用已发布版本，不会把未保存草稿带入运行。
• 删除：勾选多张卡片或多行后点删除，或在“更多”中删除单条并确认。需要删除权限；删除前应先确认没有需要保留的版本和执行证据。
• 版本历史：在“更多”中打开版本历史，查看版本号、校验值、发布状态和发布时间。“恢复版本”只把该历史版本恢复为当前草稿，仍需校验、保存并再次发布才会影响运行。
• 执行追踪：点击卡片底部或列表行内的“执行追踪”，或在编辑页底部打开详细追踪。读取已发布运行版本的执行记录；没有发布过的草稿没有真实执行记录。

列表状态解释

• 草稿：定义可以编辑或已保存，但尚未成为运行版本。完成待配置项，校验、模拟并发布。
• 候选版本待生效／发布确认中：发布请求已进入运行确认阶段，页面会显示已确认节点数。等待确认；短时间内页面轮询状态。未显示已生效前，不应把它当作已运行。
• 已生效 vN：发布版本已被运行节点确认，可处理新的匹配事件。通过执行追踪核验实际入口、判断和动作回执。
• 已暂停 vN：已发布版本保留，但新的规则入口停止。需要继续处理新事件时恢复；需要改逻辑时先改草稿再发布。
• 发布失败：本次发布没有成为运行版本。查看发布前检查或校验提示后修正；当前运行版本保持不变。

使用时请同时确认以下边界。

• 列表中的“最近执行”和“在途”只用于快速判断；要确认动作结果必须进入执行追踪查看具体步骤和回执阶段。
• 列表操作受角色权限控制；看得到列表不等于一定能新增、编辑、发布或删除。

2. 找到规则管理入口

操作位置： 规则引擎→规则列表

进入规则列表，先用名称与状态查询，再在卡片中查看业务摘要、运行版本和最近执行；卡片底部提供编辑、执行追踪及更多操作。

图：紧凑卡片视图：首行规则、查询条件与展示方式切换

3. 切换为列表视图

操作位置： 规则引擎→规则列表

点击右上角“列表”，按列对比规则；窗口较窄时横向滚动查看其余字段。点击“卡片”可返回卡片展示。

图：列表视图：同一批规则按行展示；横向滚动可查看其余字段

关键控件速查

配置项	用途与使用建议	生效与恢复
规则名称 / 状态	名称输入框与状态下拉框共同限定列表查询范围；什么时候用：输入业务关键词，再选草稿、已生效或已暂停；点查询生效，点重置清空条件。	只改变当前列表展示，不更改规则草稿或运行状态；失败时：按本节操作入口重新核对当前状态。
卡片 / 列表	切换两种浏览方式，默认使用卡片；什么时候用：日常浏览用卡片，按列对比用列表；窄窗口可横向滚动。	保留查询条件和页码，清空已勾选项，不改变规则或运行状态；失败时：点击卡片或列表重新选择展示方式。

场景库、资源绑定与复制复用

从规则列表点击“从场景创建”，或在工作台点击“场景库”。向导分为选择场景、绑定资源、调整参数三步；没有合适模板时点“空白创建”。场景卡片显示业务用途、模板流程缩略图、所需资源和样例名称，可按用途分类或输入名称/用途关键词搜索。

选择场景后点下一步。绑定资源页先填规则名称并选触发产品；触发设备可选，不选时使用产品范围。然后选择触发或判断字段，逐条核对判断对象、条件字段、控制对象与可写控制字段。告警、通知、Webhook、AI 动作还要选择本租户对应资源。跨设备场景中的触发设备、判断设备和控制设备可以不同，不能只绑定第一个设备就结束。

进入调整参数页，集中填写判断值、区间上限、等待秒数、执行频率与时间、控制参数、通知变量、请求参数或 AI 分析任务。只显示当前场景已有的项目；需增加条件、复杂映射、按间隔定时或更多编排时，进入画布后继续修改。进入画布并不等于保存：缺少资源时保留未保存配置，并展示“还有几项待配置”。

复制规则从列表“更多 > 复制规则”进入同一向导。复制保留原流程及仍有效的本租户资源，可集中更换设备、字段和动作资源。副本拥有独立节点标识，原规则不会被修改；保存副本后才创建独立记录。复制不会带入原规则的运行状态或执行历史。

18个内置场景

• 告警与恢复（6）：温度超限告警通知、温湿度组合告警、持续高温告警、温度恢复消警、设备离线告警、设备上线消警。异常发现、持续判定和恢复处理
• 设备联动（5）：温度触发设备控制、设备状态跨设备联动、多设备状态联合判断、多设备并行控制后通知、分级阈值告警。把一个或多个设备状态转成控制和分级处理
• 定时与等待（4）：每日定时设备控制、每周定时控制、定时状态巡检、延时后重新判断。计划执行、周期检查或等待复核
• 事件与业务集成（3）：设备事件通知、事件调用 Webhook、AI 分析后按结果分支。设备事件处理、外部业务对接和智能分析

向导字段怎么选择

• 规则名称：向导最多50字符；进入编辑器后名称最多128字符。用对象和处理结果命名，避免只写测试或规则1
• 触发产品/触发设备：选择事件所属产品；需要限定单设备时再选触发设备。换产品后必须重选设备和字段
• 判断条件/条件字段：每条条件单独选择状态来源对象与其物模型字段。联合判断需逐条确认，不要把不同设备字段都指向触发设备
• 控制动作/可写控制字段：选择真正接受命令的设备，再选可写属性或功能。只读温度等采集字段不能用于下发控制
• 通知模板/通知渠道/接收人：选择渠道一致的模板与有对应联系方式的接收人。无渠道、未绑定模板渠道或缺联系方式会阻止配置完成
• 缺失或不可用资源：先按待配置原因补齐基础资源，再回到当前配置选择。场景不会自动创建产品、设备、告警、连接器或AI助手

使用时请同时确认以下边界。

• 场景库目前是内置场景和已有规则复制，没有租户自定义模板的新增、发布或共享管理入口。
• 向导中的临时内容保留在当前编辑会话；刷新、关闭或确认切换新规则会丢弃未保存内容，不是自动保存草稿。
• 字段候选来自所选产品物模型，并按属性、事件、可写性等过滤；客户仍需确认实际业务含义和单位，不是自动完成字段匹配。

4. 选择内置场景

操作位置： 规则引擎→规则编辑器

点击“从场景创建”，使用分类和搜索选择用途相符的场景，再点下一步。

图：选择内置场景

5. 绑定本租户资源

操作位置： 规则引擎→规则编辑器

依次选择触发产品、判断对象、控制设备以及所需业务资源；未配置项留在向导提示中。

图：绑定本租户资源

6. 集中修改场景参数

操作位置： 规则引擎→规则编辑器

调整阈值、时间或控制参数后进入画布，继续完成剩余配置。

图：集中修改场景参数

关键控件速查

配置项	用途与使用建议	生效与恢复
绑定资源	分别绑定触发、判断、控制设备以及动作资源；什么时候用：跨设备场景逐个核对角色，控制字段需可写；缺失资源先在平台准备。	只修改待创建副本；进入画布后仍需保存与发布；失败时：按本节操作入口重新核对当前状态。

画布、属性面板与完整表单

工作台顶部是规则名称、草稿保存状态、运行状态和主要操作；左侧节点库负责添加功能，中间画布展示触发、条件和执行流程，右侧只配置当前对象，底部按需展开待处理项、模拟结果和执行记录。画布和属性区独立滚动，复杂流程不必展开成一张长表单。

点击触发节点配置触发方式与范围；点击入口条件配置整个条件组；点击动作或延时配置当前节点。点击顺序或并行组只展示执行方式和直属步骤摘要，点摘要再进入相应子节点。点击条件分支配置该判断以及两侧入口。点击画布空白处返回规则概览，查看动作数量、工作流节点数量、未保存状态和待配置项。

切换“完整表单”可按“何时触发、满足条件、执行动作”连续查看规则。完整表单与画布共享同一份草稿，修改后切回即可看到变化；不是两份独立规则，也不需要导入导出。画布适合定位与结构编辑，完整表单适合集中核对字段。

画布工具及实际作用

• 平移：按住画布空白处拖动。移动视口，不改规则逻辑
• 放大/缩小：点击画布右上角加减按钮。当前缩放范围50%至135%；百分比仅表示显示比例
• 适配画布：点击适配按钮。让流程尽量居中；较大流程仍可平移或通过缩略图定位
• 自动整理：点击自动整理按钮。重置手动节点位置并适配显示，不改变流程执行顺序
• 缩略图：点击右下缩略图目标区域。移动主画布视口到相应区域
• 拖动节点/组：按住节点拖动；移动组时子节点跟随。只调整布局；要改先后顺序必须用组内上移/下移
• 折叠/展开组：点击组标题右側折叠箭头。隐藏或显示组内步骤；隐藏的步骤仍参与执行
• ＋插入：点击连接位置的加号并选择业务动作、分支、延时或子组。按当前连接位置插入；不需要也不支持手工连线决定执行关系

节点编辑与撤销

• 左侧节点库：先选目标组或步骤，再点击所需动作/编排项。系统根据选择插入；插入后检查所在组和业务摘要
• 排序：选中父组，在步骤摘要旁点击上移或下移。只调整同一组直属子节点的次序；并行组排序不代表先后执行
• 删除节点：选中节点，点击右上删除按钮。删除容器会一并移除内部流程；根执行组不可删除，可改其步骤
• 撤销/重做：点击工具栏按钮；也可用Ctrl/Cmd+Z、Ctrl/Cmd+Shift+Z或Ctrl/Cmd+Y。会话记录最多30个规则定义/布局快照；不包含规则名称、优先级和备注，也不是服务端版本回滚
• 保存快捷键：Ctrl/Cmd+S。触发保存草稿；输入框内的文本撤销仍交由输入控件处理
• 属性栏宽度：桌面端拖动属性栏左边缘。可调340至480像素，默认380；同一浏览器记忆宽度
• 较窄桌面：小于1200像素时节点库折叠为图标，属性区覆盖显示。点击节点或工具栏“属性”打开，关闭可让出画布空间
• 移动端只读：小于992像素显示只读预览提示。可查看流程，编辑、模拟、保存和发布请用桌面端

使用时请同时确认以下边界。

• 连线由流程树自动生成，满足/不满足分支与汇合处用于读图；拖动节点不会接出新的分支。
• 变更规则或布局会出现未保存提示；离开页面时先保存，或在放弃修改提示中明确选择。撤销记录只在本次编辑会话有效。

7. 切换完整表单

操作位置： 规则引擎→规则编辑器

点击“完整表单”，连续核对何时触发、满足条件和执行动作；切回画布后修改仍保留。

图：切换完整表单

关键控件速查

配置项	用途与使用建议	生效与恢复
流程画布 / 完整表单	两种视图编辑同一份触发、条件和执行流程；什么时候用：定位结构用画布，集中核对配置用完整表单。	切换不创建新规则，已编辑字段保持一致；失败时：按本节操作入口重新核对当前状态。

触发器：规定规则何时开始判断

在画布中选中“触发”节点，在右侧属性面板选择触发方式、范围和字段。设备类触发先选择“产品下任一设备”或“指定设备”；前者适合一类同型号设备共用规则，后者适合一台重点设备。选择产品或设备后，字段下拉框只显示与触发方式相符的物模型字段。

属性上报在所选属性上报时启动，事件上报在所选事件产生时启动；设备上线或下线可限定为上线、下线或任意变化。状态满足变化用于依据设备最近状态而不是某一条瞬时上报来启动规则，常用于阈值、持续高温和恢复判断。定时检查按计划触发，后续条件应从“最近状态”读取数据。

新建规则的默认值是“属性上报、产品范围、每次满足”，产品、设备和触发字段均为空，必须选择后才能保存。进入定时检查时默认补入每天、09:00、Asia/Shanghai；切换为按间隔时默认 5 分钟，切换为每周时默认周一。切换触发对象或触发类型会使原先依赖触发字段的条件失去适用性，系统会要求重新选择相关字段；应在保存前按待配置项逐一补齐。

全部触发方式与配置项

• 属性上报：产品或一台指定设备、一个或多个属性。温度、湿度或开关状态上报后判断
• 事件上报：产品或一台指定设备、一个或多个事件。设备报告故障事件后通知值班人员
• 设备上线或下线：产品或一台指定设备、状态：上线/下线/任意变化。网关离线告警、恢复消警
• 状态满足变化：产品或一台指定设备、属性；匹配模式；持续模式还需持续秒数。温度变为超过阈值，或连续 10 分钟高温
• 定时检查：每天、每周、间隔或 Cron；时间/星期/间隔；时区。每天 09:00 巡检设备最近状态

状态满足变化的匹配模式

• 每次满足：每次状态判断满足时都可进入规则。需要结合冷却时间防止重复通知
• 变为满足：从不满足转换为满足时才进入规则。阈值越界告警通常选此项
• 持续满足：连续满足设定秒数后才进入规则。过滤瞬时抖动；持续时间必须为正整数

定时检查的计划选项

• 每天：执行时间、时区。用于固定每日巡检或控制
• 每周：执行时间、一个或多个星期、时区。可选周一至周日
• 按间隔：1 至 1440 分钟、时区。生成 Quartz 的分钟步进表达式（0 0/N * * * ?）；按每小时分钟位匹配，不应理解为从保存时刻起严格每 N 分钟一次
• 高级 Cron：Quartz Cron 和 IANA 时区。服务端只接受合法的 6 或 7 段 Quartz Cron；可用“预览未来五次”复核计划

高级 Cron 读写示例

• 6段顺序：秒 分 时 日 月 星期：可选第7段是年份；星号表示该位置全部取值，问号用于日与星期中的一个位置不指定。使用“高级 Cron”输入后，先预览未来五次，确认每个时间点符合业务
• 0 0 9 * * ?：每天09:00:00。与每天09:00效果一致；日期按所选时区解释
• 0 0 9 ? * MON-FRI：周一至周五09:00:00。用于工作日巡检；不是法定工作日/节假日自动识别
• 0 0/5 * * * ?：每小时第0、5、10等分钟触发。按分钟刻度匹配，不从保存时刻起计时
• 按间隔输入超出分钟位能力：界面允许填写1至1440，但当前生成分钟步进Cron，较大数值可能被服务端拒绝。超过一小时的计划优先使用可预览通过的高级Cron；不能按界面上限推断严格支持任意分钟间隔

使用时请同时确认以下边界。

• 时区下拉框预置中国标准时间（Asia/Shanghai）和 UTC，也允许输入其他 IANA 时区；服务端会校验时区是否合法。
• 触发范围为“指定设备”时，页面只允许选择一台设备；需要多台同产品设备共用规则时，请选择产品范围。
• 功能调用虽然是底层事件类型，但当前 V4 编辑器不允许把它作为触发方式；功能调用应配置为设备动作。
• 定时触发不携带一条实时设备事件。定时控制必须明确目标设备或发布时固定的产品设备清单；定时巡检的判断字段应选择最近状态。
• 状态变化和定时检查中的条件只能从最近状态读取，不能把不存在的“本次事件”当成数据来源。

8. 配置持续满足触发

操作位置： 规则引擎→规则编辑器

选中触发节点，设置状态满足变化和持续秒数；条件使用最近状态。

图：配置持续满足触发

9. 配置定时触发

操作位置： 规则引擎→规则编辑器

选定检查对象、执行频率、时间和时区，用“预览未来五次”核对计划。

图：配置定时触发

关键控件速查

配置项	用途与使用建议	生效与恢复
预览未来五次	根据当前定时配置计算接下来的五个执行时间；什么时候用：填写频率和时区后使用，尤其用于核对 Cron 和跨时区计划。	只查看执行时间，不会实际运行规则；失败时：按本节操作入口重新核对当前状态。

条件：组合事件、最近状态和上游结果

在触发节点下方的“条件”节点或某个“条件分支”节点中，先选择条件结构，再逐项补充字段判断。全部满足表示每个子条件为真才通过，任一满足表示任意子条件为真即可通过，取反只能包含一个子条件；字段判断则由来源、对象、字段、运算符和比较值组成。可继续添加字段或条件组，形成嵌套逻辑。

字段来源分为本次事件、最近状态和已完成上游输出。本次事件只能用于属性/事件类触发；最近状态每个字段判断一次只能选择一个对象，可选触发设备或一个其他设备，不能在同一个字段判断内多选设备；上游输出只在流程内的条件分支可用，且只能选择当前节点之前、在所有可能路径上均已完成的动作输出。

最近状态有有效期。规则设置中的“状态有效期”默认 300 秒；状态缺失或过期的字段判断结果为“无法判断”，不能自动视为不满足。入口条件为无法判断时，规则入口记为 CONDITION_UNKNOWN，流程不创建实例；IF 条件为无法判断时节点记为失败，满足和不满足两侧均不执行。应在入口诊断或模拟结果确认原因，不要预期一定有流程实例详情。

条件字段来源

• 本次事件：当前属性上报或事件上报中的字段。定时和状态满足触发不提供此来源
• 最近状态：触发设备或当前租户中一台设备的可读属性，另含在线状态。读取时间超过状态有效期时结果为无法判断
• 已完成上游输出：前序动作已声明的输出字段。同级并行分支不能互引；并行组完成后的后续节点可引用各分支输出；单侧分支产生的输出不能在分支后直接引用

字段运算符

• 数值：大于、大于等于、等于、小于、小于等于、区间。区间需要下限和上限；单位和枚举值按物模型输入控件填写
• 非数值：等于、不等于、存在。存在不需要比较值；其他运算符需要填写比较值
• 组合条件：全部满足、任一满足、取反。全部/任一至少一个子条件；取反必须且只能有一个子条件

组合条件遇到无法判断时

• 全部满足：有一个明确不满足就整体不满足；没有不满足但有无法判断时，整体无法判断。温度满足、湿度状态过期，不会判为全部满足
• 任一满足：有一个明确满足就整体满足；都不满足时才是不满足；剩余情况无法判断。温度明确满足时，即便另一条件状态缺失，任一满足仍可成立
• 取反：满足变不满足，不满足变满足；无法判断仍无法判断。不能通过取反让缺失状态自动通过

使用时请同时确认以下边界。

• 选择字段、来源设备或上游输出后，系统会清空旧比较值，避免把温度值误用于另一个字段；需重新填写期望值。
• 跨设备状态判断可直接在“最近状态”对象下拉框选择当前租户中的一台设备，不需要先把该设备添加到规则；系统按所选设备所属产品的物模型过滤字段。
• 条件分支的“满足时”和“不满足时”各自是独立流程；没有业务动作的否则分支可删除，不应保留空执行组。

10. 配置多个设备的联合条件

操作位置： 规则引擎→规则编辑器

切到完整表单，在满足条件中逐条选择最近状态设备、字段、运算符和比较值。

图：配置多个设备的联合条件

字段说明

字段 / 控件	说明
条件来源	本次事件读取这次上报；最近状态读取设备的最后已知值；上游输出读取前序动作结果；缺失或过期数据会无法判断；IF无法判断时两侧都不执行。选填 · 来源：事件、设备最近状态、可引用的前序动作结果 · 选择：定时巡检或跨设备用最近状态；AI分支用已完成上游输出。推荐：按实施方案填写 · 示例：按实际环境填写

关键控件速查

配置项	用途与使用建议	生效与恢复
条件来源	本次事件读取这次上报；最近状态读取设备的最后已知值；上游输出读取前序动作结果；怎么选：定时巡检或跨设备用最近状态；AI分支用已完成上游输出；值从哪里来：事件、设备最近状态、可引用的前序动作结果；建议：保持当前值。	缺失或过期数据会无法判断；IF无法判断时两侧都不执行；影响 · 范围：当前规则；生效要求：需发布；填错时：选择不符合设备周期或业务频率的值，会改变进入规则的时机；恢复：按本节默认值和实际业务要求修正，再校验并发布。

流程编排：控制先后、并发、分支与等待

流程根节点以及任意组节点都可选择顺序执行或并行执行。顺序组按列表顺序逐项推进，可通过“上移、下移”或属性面板排序调整执行先后；并行组让各子流程从同一输入并发开始。拖动位置用于画布布局，真正的执行顺序由节点结构和排序决定。

条件分支先判断一个条件树，再分别进入“满足时”和“不满足时”流程。延时节点按秒等待，新增时默认 60 秒，允许 0 秒。要实现“等待后再确认”，请在延时后再增加一个条件分支并从最近状态重新读取字段，不能把延时理解为自动复核。

选中顺序组或并行组时，右侧只展示执行方式、直属步骤摘要、添加步骤与排序入口；点击摘要会定位到具体节点。组不会在属性栏递归展开全部子节点，避免复杂流程的配置表单撑高工作台。

流程节点的实际语义

• 顺序执行：添加动作、延时、条件分支或子组，并用排序调整。按子节点顺序执行；前序动作输出可供后续节点引用
• 并行执行：添加多个互不依赖的子流程。各子流程从同一输入开始；同级分支互不可引，但并行组完成后的后续顺序节点可引用各分支输出
• 条件分支：配置判断条件、满足时流程和可选的不满足时流程。只进入命中的一侧；分支后仅两侧都稳定产生的输出才能继续引用
• 延时：填写非负秒数。等待后继续，不会自动重新读取设备状态
• 动作：在当前节点配置六类业务动作。产生动作回执及可被后续引用的已声明输出

使用时请同时确认以下边界。

• 容器节点必须至少有一个子节点；条件分支必须有“满足时”流程，不满足时流程可省略。
• 不能把节点移动到自身或自己的子节点内，系统会阻止形成循环。
• 流程节点总数受服务端结构校验限制，当前上限为 1000；条件树深度上限为 16。页面没有这两项的配置控件，复杂业务宜拆分为多条可维护规则。

11. 在组摘要中排序和选中步骤

操作位置： 规则引擎→规则编辑器

点击顺序组，使用上移或下移调整直属步骤；点步骤摘要打开该步骤的参数。

图：在组摘要中排序和选中步骤

12. 设置延时等待

操作位置： 规则引擎→规则编辑器

选中延时节点填写秒数；需要等待后复核时，在后方增加独立条件分支。

图：设置延时等待

13. 设置等待后的复核分支

操作位置： 规则引擎→规则编辑器

选中条件分支，使用最近状态重新判断；仅在满足的一侧继续动作。

图：设置等待后的复核分支

关键控件速查

配置项	用途与使用建议	生效与恢复
上移 / 下移	改变当前组内直属子节点的位置和结构顺序；什么时候用：要调整先后顺序时使用；拖动画布节点只改变布局。	顺序组按新次序执行；并行组仍并行，调整后需重新发布才能影响新实例；失败时：按本节操作入口重新核对当前状态。

数据引用：安全复用事件和前序结果

当字段旁出现“固定值 / 事件或上游字段”时，可选择把数据绑定到当前参数。事件绑定读取本次事件中的同类字段；上游绑定读取已完成动作声明的输出。绑定适用于设备设置值、功能入参、通知模板变量、Webhook 请求字段和 AI 分析输入，也可在流程内条件分支中使用。

编辑器不会把所有动作结果都展示为候选项。它会根据当前位置计算可用输出：顺序流程只能看见自己之前的动作；并行流程的同级分支互不可见，但并行组完成后的后续节点可以引用各分支输出；条件分支之后只能保留两条分支都产生的稳定输出。保存和发布前服务端会再次验证，因此不能通过手工修改定义绕开依赖顺序。

AI 动作的报告模式可提供请求标识、任务标识和报告；结构化模式只允许引用已声明的 result.字段。设备动作可供后续使用确认阶段和结果；其他普通业务动作提供结果字段。字段不在声明范围内会被校验拒绝。

引用规则速查

• 设备属性设置值和功能入参：本次事件、已完成上游输出。未来节点、同级并行分支、未声明输出
• 通知变量、Webhook 请求字段、AI 输入：本次事件、已完成上游输出。资源不可用或来源字段不在当前触发/前序输出中
• 流程内条件分支：最近状态、已完成上游输出；事件触发时也可用本次事件。定时/状态触发中的本次事件，以及单侧分支才产生的输出

配置示例

• 设备控制值：选择“本次事件 · 温度”。把当前温度写入一个允许写入的目标字段
• 通知内容变量：选择“上游 AI 分析 · result.severity”。通知模板中展示 AI 的结构化等级
• Webhook 请求字段 temperature：选择“本次事件 · 温度”。构造请求体中的 temperature 字段

使用时请同时确认以下边界。

• 绑定不是字段类型转换器。应选择类型、单位和语义兼容的来源字段；物模型输入控件负责固定值的格式和枚举选择。
• 切换目标产品、设备、控制字段、通知模板或动作类型时，旧绑定会被清空或重新校正，应重新检查待配置项。
• 上游输出引用在模拟时可展示路径和示例值；真实运行中的值仍取决于该动作的实际执行结果。

14. 引用前序动作的结构化输出

操作位置： 规则引擎→规则编辑器

在 AI 动作后方的条件分支选择已完成上游输出，再选择 result.severity 等已声明字段。

图：引用前序动作的结构化输出

字段说明

字段 / 控件	说明
已完成上游输出	候选项由当前节点前方已经完成且声明了输出的动作产生；并行同级分支不能互相引用；并行汇合后的后续步骤可使用组内结果。选填 · 来源：当前工作流依赖关系和动作输出声明 · 选择：先配置前序动作输出，再在后续参数或IF条件中选择对应字段。推荐：按实施方案填写 · 示例：按实际环境填写

关键控件速查

配置项	用途与使用建议	生效与恢复
已完成上游输出	候选项由当前节点前方已经完成且声明了输出的动作产生；怎么选：先配置前序动作输出，再在后续参数或IF条件中选择对应字段；值从哪里来：当前工作流依赖关系和动作输出声明；建议：保持当前值。	并行同级分支不能互相引用；并行汇合后的后续步骤可使用组内结果；影响 · 范围：当前规则；生效要求：需发布；填错时：选择不符合设备周期或业务频率的值，会改变进入规则的时机；恢复：按本节默认值和实际业务要求修正，再校验并发布。

动作：控制设备

操作顺序：在顺序组或并行组的“添加步骤”中添加动作，选中该动作，在“动作类型”选择控制设备；依次选择控制对象、目标资源、控制字段，再填写设置值。新增动作默认就是控制设备：定时触发默认指定设备，其他触发默认触发设备。

控制对象有三项：触发设备、指定设备、发布时固定产品设备清单。指定设备可多选，但只能保留同一产品的设备；选择目标产品或改变设备后，控制字段、固定值和绑定会清空并重新选择。产品模式在发布时冻结目标清单，之后新增同产品设备不会自动加入该运行版本。

控制字段只显示可写属性和设备功能，不显示只读属性、事件或设备状态。属性只有一个“设置值”，可选固定值或事件/上游字段；功能会按物模型参数逐行出现，每个入参都独立选择固定值或事件/上游字段。固定值由物模型控件按整数、枚举、单位等格式填写。

控制设备字段与动态出现条件

• 控制对象：触发设备、指定设备、发布时固定产品设备清单。定时触发新增动作默认指定设备，其他触发默认触发设备；后两项分别显示目标设备或目标产品
• 目标设备：仅控制对象为指定设备时出现。可多选同一产品设备
• 目标产品：仅控制对象为产品设备清单时出现。发布时将其设备清单冻结
• 控制字段：当前目标产品的可写属性或功能。必填；切换后重填参数
• 设置值/功能入参：属性显示一个值；功能按声明参数逐行显示。每项选固定值，或选择本次事件/可用上游输出

使用时请同时确认以下边界。

• 示例：温度触发设备控制中，选择指定设备“执行器”、控制字段“设温”、固定值 26；运行后在执行记录的该动作节点查看下发回执。DISPATCHED 仅代表已向设备运行面派发，DEVICE_ACK 或 DEVICE_RESULT 才表示收到更高等级的设备确认。
• 设备动作必须配置控制字段。当前编辑器没有动作超时输入控件；接口高级定义若设置超时，服务端允许 1 至 300000 毫秒。

15. 配置设备控制

操作位置： 规则引擎→规则编辑器

选择控制对象、可写属性或功能，再填设置值或映射每个入参。

图：配置设备控制

字段说明

字段 / 控件	说明
控制对象 / 控制字段	目标设备决定可写属性或功能列表；运行时下发命令；需要在追踪中按回执阶段判断完成程度。选填 · 来源：当前租户设备及其产品物模型 · 选择：先选实际执行器，再选可写字段；采集温度等只读字段不能下发。推荐：按实施方案填写 · 示例：按实际环境填写

关键控件速查

配置项	用途与使用建议	生效与恢复
控制对象 / 控制字段	目标设备决定可写属性或功能列表；怎么选：先选实际执行器，再选可写字段；采集温度等只读字段不能下发；值从哪里来：当前租户设备及其产品物模型；建议：保持当前值。	运行时下发命令；需要在追踪中按回执阶段判断完成程度；影响 · 范围：当前规则；生效要求：需发布；填错时：选择不符合设备周期或业务频率的值，会改变进入规则的时机；恢复：按本节默认值和实际业务要求修正，再校验并发布。

动作：产生告警

操作顺序：添加动作后选择“产生告警”，选择告警定义，再选择告警级别和关联对象。关联对象默认可选触发设备或指定设备；选择指定设备时才出现“关联设备”多选框。

告警级别可选提醒通知、轻微问题、严重警告，分别对应 1、2、3。告警定义从当前租户可用的定义中选择；关联对象决定本次告警归属的设备主体。

产生告警字段

• 告警定义：当前租户可用定义。选择要创建的告警类别
• 告警级别：提醒通知、轻微问题、严重警告。仅产生告警时出现
• 关联对象：触发设备、指定设备。指定设备时显示关联设备
• 关联设备：可多选设备。仅指定设备时出现

使用时请同时确认以下边界。

• 示例：温度高于 35 后选择“高温告警定义”、严重警告、触发设备；模拟结果显示命中的动作预览，真实运行后在执行记录和告警记录核对创建结果。
• 定时触发没有触发设备。产生告警时应把“关联对象”改为“指定设备”并选择设备；产品归属由所选设备确定，页面不单独提供目标产品字段。

16. 配置产生告警

操作位置： 规则引擎→规则编辑器

选择告警定义、告警级别和关联设备，确认告警归属。

图：配置产生告警

字段说明

字段 / 控件	说明
告警定义 / 告警级别	告警定义标识业务告警，级别可选提醒通知、轻微问题或严重警告；真实运行创建属于当前规则与设备的规则告警。选填 · 来源：当前租户告警定义 · 选择：选择已配置的告警定义，按业务严重程度选级别，并核对关联设备。推荐：按实施方案填写 · 示例：按实际环境填写

关键控件速查

配置项	用途与使用建议	生效与恢复
告警定义 / 告警级别	告警定义标识业务告警，级别可选提醒通知、轻微问题或严重警告；怎么选：选择已配置的告警定义，按业务严重程度选级别，并核对关联设备；值从哪里来：当前租户告警定义；建议：保持当前值。	真实运行创建属于当前规则与设备的规则告警；影响 · 范围：当前规则；生效要求：需发布；填错时：选择不符合设备周期或业务频率的值，会改变进入规则的时机；恢复：按本节默认值和实际业务要求修正，再校验并发布。

动作：恢复告警

操作顺序：应在同一条规则的温度恢复或设备上线分支中添加动作，选择“恢复告警”，再选择关联对象。指定设备时选择关联设备；恢复动作没有告警级别。页面仍显示告警定义以帮助识别用途，但当前运行恢复定位不按该字段筛选。

运行时按当前规则、设备主体和未恢复状态定位告警，而不是按规则版本或告警定义定位。它不能用独立的“温度恢复消警”规则去恢复另一条规则产生的告警；同一规则同一设备下的未恢复规则告警会被一并恢复，最多处理 1000 条。

恢复告警字段

• 告警定义：当前租户可用定义。页面可选用于业务识别，但不作为当前运行恢复定位条件
• 关联对象：触发设备、指定设备。决定当前规则下要恢复的设备主体
• 关联设备：可多选设备。仅指定设备时出现

使用时请同时确认以下边界。

• 示例：在一条高温规则中，IF 的高温分支产生告警，温度恢复分支对同一触发设备执行恢复；真实运行后在执行记录确认恢复动作，再检查该规则和该设备的未恢复告警已关闭。
• 不要用另一条独立规则尝试按同一告警定义跨规则消警，也不要依赖当前页面没有提供的 alertLogId。仅添加“否则”空分支不会执行恢复。

17. 查看恢复告警配置

操作位置： 规则引擎→规则编辑器

选择恢复告警动作与关联对象；要关闭已产生的告警，恢复动作必须位于产生告警的同一规则中。图示只展示该动作表单。

图：查看恢复告警配置

字段说明

字段 / 控件	说明
关联对象 / 关联设备	确定恢复动作查找未恢复规则告警的设备主体；关闭同一规则同设备的未恢复规则告警，不按版本或告警定义细分。选填 · 来源：当前租户设备与规则告警归属 · 选择：恢复动作放在原开警规则内，选择同一设备；独立新规则无法清除原规则告警。推荐：按实施方案填写 · 示例：按实际环境填写

关键控件速查

配置项	用途与使用建议	生效与恢复
关联对象 / 关联设备	确定恢复动作查找未恢复规则告警的设备主体；怎么选：恢复动作放在原开警规则内，选择同一设备；独立新规则无法清除原规则告警；值从哪里来：当前租户设备与规则告警归属；建议：保持当前值。	关闭同一规则同设备的未恢复规则告警，不按版本或告警定义细分；影响 · 范围：当前规则；生效要求：需发布；填错时：选择不符合设备周期或业务频率的值，会改变进入规则的时机；恢复：按本节默认值和实际业务要求修正，再校验并发布。

动作：发送通知

操作顺序：选择“发送通知”，选择通知模板；页面自动带出模板所属的通知渠道，然后选择接收人，并为模板声明的变量填写固定值或选择事件/上游字段。切换模板会同步渠道并清空已选接收人，必须重新选择。

发送账号、标题、内容、附件不是独立的规则动作字段。它们只在所选通知模板的变量定义中出现，页面以中文变量名显示，并可逐项选择固定值或事件/上游字段。发送账号在真正执行前由当前租户、模板渠道和接收人联系方式生成，前端填写的账号不会被信任。

接收人按模板渠道过滤：邮件只显示已配置邮箱的用户；短信和语音只显示已配置手机号的用户；机器人/HTTP 类渠道可不需要用户接收人。运行期还会校验接收人属于当前租户且具有该渠道联系方式。

通知字段与动态规则

• 通知模板：当前租户模板。必选；决定渠道与变量
• 通知渠道：模板所属渠道，只读显示。不能在动作中另选渠道
• 接收人：符合渠道联系方式的用户，多选。邮件/短信/语音需选 1 至 100 人；机器人/HTTP 例外
• 发送账号、标题、内容、附件：模板变量中声明时动态出现。每项可填固定文本，或绑定本次事件/上游输出

使用时请同时确认以下边界。

• 示例：选择“告警邮件”模板，选择有邮箱的值班人员，将标题绑定为固定“高温告警”、内容变量绑定温度；模拟显示通知预览，真实运行后在执行记录查看通知动作回执。
• 模拟不发送通知；动作成功回执也应结合渠道投递日志确认，不能只凭模拟匹配认定收件人已收到。

18. 配置通知模板和变量

操作位置： 规则引擎→规则编辑器

选择模板和接收人，再为动态显示的标题、内容等变量填写固定值或绑定字段。

图：配置通知模板和变量

字段说明

字段 / 控件	说明
通知模板 / 接收人	模板决定渠道及标题、内容等动态变量，接收人按渠道联系方式过滤；真实运行调用通知服务；模拟只显示内容预览。选填 · 来源：当前租户通知模板、渠道和用户联系方式 · 选择：选择有邮箱或手机号等对应联系方式的用户，再填模板声明变量。推荐：按实施方案填写 · 示例：按实际环境填写

关键控件速查

配置项	用途与使用建议	生效与恢复
通知模板 / 接收人	模板决定渠道及标题、内容等动态变量，接收人按渠道联系方式过滤；怎么选：选择有邮箱或手机号等对应联系方式的用户，再填模板声明变量；值从哪里来：当前租户通知模板、渠道和用户联系方式；建议：保持当前值。	真实运行调用通知服务；模拟只显示内容预览；影响 · 范围：当前规则；生效要求：需发布；填错时：选择不符合设备周期或业务频率的值，会改变进入规则的时机；恢复：按本节默认值和实际业务要求修正，再校验并发布。

动作：调用 Webhook

操作顺序：选择“Webhook”，从可用连接器中选择一个连接器，再点击“添加请求字段”。为每个字段输入请求体键名，并从本次事件或当前可用的上游输出中选择值；可删除或重命名字段。

在画布右侧及完整表单的 Webhook 主动作编辑器中，请求字段只有“事件或上游字段”选择器，没有固定值输入框。场景向导的“调整参数”页可能显示已有请求字段的固定值输入。进入画布后要逐项核对最终字段来源；如果同名字段仍有映射，不要把向导填写值直接当作最终发送内容，先运行模拟查看动作预览。

连接器不可用时会在下拉框禁用，发布校验还会确认连接器归属当前租户且已启用。模拟仅展示将构造的请求体和路径，不会向远端发出请求。

Webhook 字段

• Webhook 连接器：从可用连接器下拉框选择。发布前校验连接器可用性
• 请求字段名：添加后输入，可重命名或删除。成为请求体键
• 请求字段值：选择本次事件或已完成上游输出。成为请求体值；主动作编辑器无固定值控件，场景向导已有字段可能显示固定值输入

使用时请同时确认以下边界。

• 示例：新增 temperature 字段并绑定“本次事件·温度”，新增 deviceNo 字段并绑定上游输出；模拟查看请求预览，真实执行后在执行记录查看连接器回执。
• Webhook 动作的成功表示连接器执行结果；不能把模拟预览或请求已构造当成外部系统业务处理成功。

19. 配置 Webhook 字段映射

操作位置： 规则引擎→规则编辑器

选择可用连接器并映射请求字段。图中环境没有连接器，先由管理员补齐后才能完成发布；本图不代表已经调用成功。

图：配置 Webhook 字段映射

字段说明

字段 / 控件	说明
Webhook 连接器 / 请求字段	连接器规定外部调用配置，请求字段用事件或上游字段映射；当前没有连接器时不能完成发布；预览不证明远端调用成功。选填 · 来源：当前租户连接器和当前规则可用字段 · 选择：先选择可用连接器；新增请求字段名后为它选来源。推荐：按实施方案填写 · 示例：按实际环境填写

关键控件速查

配置项	用途与使用建议	生效与恢复
Webhook 连接器 / 请求字段	连接器规定外部调用配置，请求字段用事件或上游字段映射；怎么选：先选择可用连接器；新增请求字段名后为它选来源；值从哪里来：当前租户连接器和当前规则可用字段；建议：保持当前值。	当前没有连接器时不能完成发布；预览不证明远端调用成功；影响 · 范围：当前规则；生效要求：需发布；填错时：选择不符合设备周期或业务频率的值，会改变进入规则的时机；恢复：按本节默认值和实际业务要求修正，再校验并发布。

动作：AI 分析

操作顺序：选择“AI 分析”，选择可用 AI 助手，填写分析任务。助手声明输入结构时，页面按其 inputSchema 或 inputs 动态列出每个输入项；没有声明时只提供一个“分析输入”。每项都可填固定值或绑定本次事件/已完成上游输出。

选择助手后会记录助手标识和代码。输出形式可选报告或结构化结果：报告用于文本结论；结构化结果需逐行添加结果字段，填写字段名并选择文本、数字或布尔类型。结构化字段名必须以英文字母开头，只能包含字母、数字、下划线，最长 64 位；字段数为 1 至 32，不能重名。

要让 AI 结果参与后续分支，先在 AI 动作中声明结构化字段，例如 severity:string；再把 AI 动作放在条件分支前的顺序流程中，条件来源选择“已完成上游输出”，选择 result.severity 并比较 high。只有在所有可达路径上已经完成的 AI 输出才会出现在候选项。

AI 分析字段

• AI 助手：可用助手列表。选择后写入助手标识与代码；不可用助手禁选
• 分析任务：始终显示。必填；说明要分析的问题
• 分析输入：由助手输入结构动态生成；无结构时为分析输入。逐项选固定值或事件/上游输出
• 输出形式：报告、结构化结果。报告输出文本；结构化结果显示结果字段表
• 结果字段：仅结构化结果出现。名称加类型：文本、数字、布尔

使用时请同时确认以下边界。

• 示例：选择“设备异常分析”助手，任务填“判断告警等级”，把温度绑定给输入，声明 severity:string；后续 IF 用 result.severity = high 决定是否通知。模拟使用明确的结构化样例并显示路径；真实运行在执行记录中查看 AI 动作结果和后续分支。
• AI 助手必须可用且属于当前租户；模拟不调用真实 AI。报告模式不能当作自定义结构化字段引用，只能使用报告模式已声明的 requestId、taskId、report。

20. 配置 AI 分析与输出字段

操作位置： 规则引擎→规则编辑器

选择 AI 助手和分析任务，选结构化结果时声明输出字段和类型，供后续条件分支使用。

图：配置 AI 分析与输出字段

字段说明

字段 / 控件	说明
输出形式 / 输出字段	报告供阅读；结构化结果供后续节点按字段判断；只允许后续引用已声明结构化字段；模拟使用显式样例。选填 · 来源：AI助手及本规则声明的输出结构 · 选择：需要IF按等级分支时，选结构化结果并声明severity等字段与类型。推荐：按实施方案填写 · 示例：按实际环境填写

关键控件速查

配置项	用途与使用建议	生效与恢复
输出形式 / 输出字段	报告供阅读；结构化结果供后续节点按字段判断；怎么选：需要IF按等级分支时，选结构化结果并声明severity等字段与类型；值从哪里来：AI助手及本规则声明的输出结构；建议：保持当前值。	只允许后续引用已声明结构化字段；模拟使用显式样例；影响 · 范围：当前规则；生效要求：需发布；填错时：选择不符合设备周期或业务频率的值，会改变进入规则的时机；恢复：按本节默认值和实际业务要求修正，再校验并发布。

规则设置、草稿与校验

编辑页把可编辑的草稿和正在运行的发布版本分开显示。顶部“未保存／草稿已保存／新规则”只描述当前编辑内容；右侧运行状态和底部运行版本描述线上正在执行的版本。保存草稿不会启用规则，也不会修改运行版本。

画布空白处的概览会列出待配置项。点击待配置项可定位到触发器、条件、工作流节点或规则设置中的对应字段；“校验”把服务端返回的问题集中显示，点击问题同样可定位。

规则设置字段

• 规则名称：规则列表和编辑页的名称，最长128个字符。使用能说明触发对象和业务结果的名称；为空时不能保存。
• 优先级：规则的业务优先级，取值1至9999；新建规则默认100，数值越小越先进入评估队列。它决定候选规则的评估先后，不能改变同一规则内部画布节点的执行顺序。
• 备注：记录维护目的、责任边界或变更原因。适合留下阈值依据、值班说明和外部依赖信息。
• 最近状态有效期：限制条件读取的最近状态能使用多久；V4新建默认300秒。用于跨设备、持续和定时判断；超出有效期的状态会成为“无法判断”，不会被当成不满足。
• 冷却：规则计划成功提交时开始的重复进入抑制；V4新建默认60秒。设置为0表示不增加冷却。计划未能提交会释放预占，不能把“动作最终成功”当作冷却起点。
• 冷却 · 范围：选择按触发设备分别冷却，或按整条规则统一冷却。设备分别处理时选“按触发设备”；全局只需一次处理时选“整条规则”。
• 每日生效时段：限制规则每天允许进入的开始和结束时间，开始和结束必须同时填写，格式为HH:mm或HH:mm:ss。使用触发器时区，未填时默认Asia/Shanghai；开始晚于结束表示跨午夜，二者相等表示全天有效。
• 动作失败：选择动作失败时停止后续动作，或继续执行并把实例标记为失败；V4新建默认停止后续动作。对必须串行成功的控制链路选停止；可独立处理的通知或记录可选择继续，但要在追踪中关注失败。

草稿操作与反馈

• 保存草稿：先检查本地待配置项、历史规则迁移状态和规则名称，再创建或更新草稿。按提示定位缺失字段；保存失败不会改变已发布运行版本。
• 校验：把当前草稿提交给规则校验服务，收集问题并在底部展示。点击某条问题定位控件，补齐资源、字段或参数后再次校验。
• 撤销／重做：在本次编辑会话中回退或恢复编辑器记录的变更。只影响当前编辑内容；保存、发布和其他页面的历史版本不由此撤销。
• 历史规则迁移：编辑页会显示可转换预览或需要整改的原因。无法无损转换时不能保存；应按问题完成V4配置后再保存。
• 移动端访问：窄屏显示只读预览。请在桌面端完成编辑、保存、模拟和发布。

使用时请同时确认以下边界。

• 保存、模拟通过和运行生效是三件事：保存写入草稿，模拟计算预期路径，发布并经运行节点确认后才会处理真实事件。
• 多人或多页面同时修改时，服务端使用版本锁保护更新；提示状态冲突后应重新打开规则，比较最新草稿再决定如何合并。

21. 设置规则策略

操作位置： 规则引擎→规则编辑器

打开“规则设置”，调整优先级、状态有效期、冷却、生效时段和动作失败策略。

图：设置规则策略

字段说明

字段 / 控件	说明
最近状态有效期	限定最近状态可参与判断的最长年龄，单位秒，默认300；过期和未就绪状态不参与正常数值判断。选填 · 来源：设备上报周期与业务实时性要求 · 选择：结合设备实际上报周期设置；小于上报周期可能频繁无法判断。推荐：300 · 示例：按实际环境填写
冷却	抑制重复进入执行流程的时间，单位秒，新建默认60；计划成功提交后占用冷却；并不等待动作最终成功。选填 · 来源：业务允许的重复处理频率 · 选择：设置0关闭冷却；频繁告警按业务期望选择间隔。推荐：60 · 示例：按实际环境填写

关键控件速查

配置项	用途与使用建议	生效与恢复
最近状态有效期	限定最近状态可参与判断的最长年龄，单位秒，默认300；怎么选：结合设备实际上报周期设置；小于上报周期可能频繁无法判断；值从哪里来：设备上报周期与业务实时性要求；建议：300。	过期和未就绪状态不参与正常数值判断；影响 · 范围：当前规则的条件和入口策略；生效要求：需发布；填错时：选择不符合设备周期或业务频率的值，会改变进入规则的时机；恢复：按本节默认值和实际业务要求修正，再校验并发布。
冷却	抑制重复进入执行流程的时间，单位秒，新建默认60；怎么选：设置0关闭冷却；频繁告警按业务期望选择间隔；值从哪里来：业务允许的重复处理频率；建议：60。	计划成功提交后占用冷却；并不等待动作最终成功；影响 · 范围：当前规则的条件和入口策略；生效要求：需发布；填错时：选择不符合设备周期或业务频率的值，会改变进入规则的时机；恢复：按本节默认值和实际业务要求修正，再校验并发布。

模拟测试与发布前验证

模拟用于验证当前编辑草稿的判断路径和动作预览。它可使用尚未保存的内容，输入一次模拟事件、最近状态和虚拟时间；有场景样例时还可先加载样例。模拟不会下发设备命令、发送通知、调用Webhook或AI，也不会修改冷却状态。

运行结果按步骤展示触发、判断和编排路径，并列出预期动作。点击“定位节点”可回到相关节点检查字段。模拟中出现“满足”只是模型计算结果，不是外部服务或设备的成功回执。

模拟输入

• 场景样例：有样例时从下拉列表加载，再按需要修改。快速得到该场景定义的事件、状态和AI结构化样例。
• 样本设备：选择触发设备；不选时使用触发器默认设备。确定模拟事件的设备主体和可用物模型字段。
• 样本字段与样本值：选择本次上报字段并按物模型类型填写值。验证属性、事件或设备状态入口能否匹配。
• 最近状态样本：可添加多条：设备、属性、值、观测时间和“状态已就绪”。验证跨设备条件、持续条件和定时判断；过期或未就绪状态应表现为无法判断。
• 虚拟时间：填写希望模拟的时间。验证定时触发、每日生效时段、延时和状态有效期等时间相关逻辑。
• AI结构化输出样例：仅当场景或草稿含AI输出时填写。验证AI结果分支；它是本地模拟样例，不会请求AI服务。

建议验证顺序

• 1. 配置就绪：查看画布概览的待配置项并逐项处理。没有阻塞问题，字段和资源均可用。
• 2. 校验：点击“校验”，处理所有返回问题。显示规则校验通过；必要时再打开完整表单检查。
• 3. 模拟命中与不命中：分别填写应满足和应不满足的样本。路径、条件结果和动作预览符合预期；不命中不应出现动作预览。
• 4. 发布前检查：保存草稿后点击发布，阅读范围摘要和固定设备清单提示。预检没有错误，确认该范围和动作影响后再确认发布。
• 5. 真实运行核验：版本生效后用执行追踪查看真实事件和回执。以追踪中的节点状态、动作回执和失败原因作为运行证据。

使用时请同时确认以下边界。

• 模拟失败通常表示草稿结构、输入类型或资源约束有问题；先阅读错误和校验问题，再定位并修正，不要把失败结果当成真实运行失败。
• 模拟输入不创建设备状态、告警或执行记录；真实执行记录只来自已发布运行版本。
• 虚拟时间用于检查规则收到样本后的时段、状态有效期和等待逻辑。模拟通过不证明真实定时调度已经按时触发；先用“预览未来五次”核对计划，再在版本生效后查看对应时间的真实执行记录。

22. 设置模拟样本

操作位置： 规则引擎→规则编辑器

打开“模拟测试 > 配置模拟样本”，准备设备状态、观测时间、状态就绪与虚拟时间，再运行模拟。

图：设置模拟样本

23. 读取模拟路径与动作预览

操作位置： 规则引擎→规则编辑器

查看条件实际值、判断结果和动作预览，确认样例命中路径；模拟不外发业务动作。

图：读取模拟路径与动作预览

关键控件速查

配置项	用途与使用建议	生效与恢复
运行模拟	用当前草稿及样本计算路径和预期动作；什么时候用：分别输入命中、不命中和缺失状态样例，核对不同路径。	不写入真实状态、不修改冷却，不发送设备命令或外部请求；失败时：按本节操作入口重新核对当前状态。

发布、运行确认与版本管理

发布会先保存当前草稿，再运行发布前检查。通过后，确认对话框会显示作用范围；产品批量控制会固定本次发布的设备清单。发布成功后页面显示“已发布并等待运行节点确认”，此时不要把草稿已保存或候选版本当作已生效。

编辑器在确认期间会刷新规则状态，显示候选版本已确认的节点数；状态变为“已生效 vN”后，新的匹配事件才由该版本处理。若发布失败，当前运行版本不会改变。

发布过程与版本操作

• 保存前：补齐待配置项并保存草稿。草稿持久化，但仍不运行。
• 发布前检查：点击发布后等待预检；如有错误，在问题面板逐项修正。预检令牌仅用于当前检查通过后的发布；错误不会替换运行版本。
• 确认 · 发布：核对作用范围和批量设备清单，确认后提交。创建候选版本并等待运行节点确认。
• 运行确认：查看顶部运行状态和列表状态。候选版本确认中显示进度；确认完成后显示已生效版本号。
• 暂停／恢复：在列表中暂停或恢复。暂停停止新入口，恢复继续采用已有发布版本。
• 查看版本历史：从列表“更多”打开版本历史。可核对版本号、校验值、发布状态和发布时间。
• 恢复历史版本：在版本历史确认“恢复版本”。把历史版本写成可编辑草稿，之后仍必须校验、保存和发布；它不是立即回滚。

版本历史中的发布状态原值

• pending_runtime：候选版本正在等待运行节点加载确认。等待确认进度；确认失败或超时后检查运行节点状态和版本备注。
• published：该版本已经由全部预期运行节点确认并成为已发布版本。可结合规则顶部“已生效 vN”和真实执行追踪继续核验。
• runtime_failed：至少一个运行节点未能加载候选规则版本。查看版本备注中的原因，修复运行环境后重新发起发布；当前运行版本保持不变。

使用时请同时确认以下边界。

• 发布权限与编辑权限不同；有编辑权限的用户仍可能没有发布、暂停、恢复或终止运行实例的权限。
• 发布确认轮询最多持续约一分钟；若长时间仍处于确认中，应让运行环境管理员检查运行节点连接和确认状态，再重新读取规则状态。
• 恢复历史版本为草稿不会替代首次 · 发布：从未发布过的规则仍需保存、通过预检并完成运行确认后才会出现运行版本。

24. 阅读发布确认范围

操作位置： 规则引擎→规则编辑器

点击发布，完成保存与预检后核对作用范围。确认发布会创建候选版本，仍需等运行节点确认。

图：阅读发布确认范围

25. 确认运行版本已生效

操作位置： 规则引擎→规则编辑器

读取编辑器运行状态；只有显示已生效才代表运行确认完成。

图：确认运行版本已生效

26. 查看版本历史

操作位置： 规则引擎→规则编辑器

从列表“更多 > 版本历史”查看版本号、校验值、状态和时间。恢复版本只恢复为草稿。

图：查看版本历史

关键控件速查

配置项	用途与使用建议	生效与恢复
恢复版本	把指定历史版本恢复为当前草稿；什么时候用：需要以旧版配置为修改起点时使用，先核对版本号和时间。	不会立即切换运行版本；仍需检查草稿并重新发布；失败时：按本节操作入口重新核对当前状态。

执行追踪、诊断与运行终止

执行追踪针对已发布的运行版本。编辑页底部显示最近执行编号、触发对象、结果和开始时间；打开详细追踪后，选择一条执行记录，可在真实流程图中逐节点查看条件结果、等待至、失败代码、失败原因、输入输出摘要和动作回执。

追踪列表会每1.5秒刷新，当前界面固定读取该规则最近30条记录，没有提供筛选控件或翻页控件。打开某个实例后还会订阅实时步骤。实时连接断开时会提示并尝试重连，已收到的增量步骤仍保留。追踪中的发布版本流程用于解释历史实例，不能用当前草稿替代它。

执行状态和动作回执

• 执行完成／执行失败：整个实例结束，失败状态应结合失败原因和具体节点查看。从流程图选失败节点，再看时间线的判断说明、实际值、目标值和回执。
• 等待中／执行中／待执行：实例尚未结束，可能在延时、排队或等待动作回执。保留追踪抽屉观察实时更新；不要把等待直接认定为失败。
• 已取消／已终止：实例被取消或由有发布权限的用户终止。查看终止原因和哪些节点已经完成；重新运行需由新的真实入口触发。
• 无法判断：条件需要的状态缺失、过期或未就绪。检查最近状态的设备、字段、观测时间和状态有效期，不能把它视为不满足。
• 已下发：动作已提交给设备或服务通道。不等同于设备物理执行完成；继续看设备确认或设备执行结果。
• 通知服务已受理：通知提供方已经接收请求。不表示收件人已经送达或阅读；按通知渠道的回执能力核验。
• 服务已响应／业务结果已记录：Webhook、AI或业务动作返回了受限摘要。查看HTTP状态、耗时等安全摘要；页面不会展示外部响应正文。

诊断和终止操作

• 五分钟诊断：在“规则设置 > 高级策略与诊断”点击“开启5分钟诊断”。需要测试权限；最多记录1000条明细，统计区会显示观察次数和截止时间，明细在执行追踪中查看。
• AI解释本次执行：在详细追踪中先选择一条执行记录，再点击该按钮。只根据该实例的追踪事实解释原因，不生成、保存或发布规则。
• 终止运行实例：仅对未结束实例点击“终止运行实例”，填写必填原因并确认。需要发布权限；取消尚未开始节点，已经下发的设备命令无法撤回。状态版本冲突时重新加载实例后再决定。
• 实时追踪：选中执行实例后保持追踪抽屉打开。实时流断开会自动重连；连接恢复前可查看已加载历史步骤。

选择真实流程节点后可查看的字段

• 流程图标题：发布版本号、状态修订和实例总状态。确认这是哪一个历史运行版本和哪次状态快照。
• 节点状态：节点名称和状态：待执行、执行中、等待中、已完成、失败、已取消、已终止或结果未知。先选失败或等待节点，再结合下面的详情与时间线分析。
• 条件与等待：条件结果，以及延时节点的“等待至”。条件为无法判断时检查状态数据；等待至尚未来临属于正常等待。
• 失败与动作回执：失败代码、失败原因和动作回执阶段。回执阶段说明动作到达的位置，不应把已下发直接当成设备执行完成。
• 输入输出摘要：当前节点的输入与输出字段，最多展示12项。敏感键、请求头、令牌、凭据和外部响应正文会被过滤；字符串也会截断。
• 时间线：阶段、状态、时间、消息／原因，以及数据来源、字段、实际值、目标值、观测时间和状态版本（存在时）。用时间线确认是入口、范围、条件、持续、提交动作、延时还是回执阶段造成了结果。

使用时请同时确认以下边界。

• 执行追踪是验证真实运行的依据；模拟的命中路径与动作预览不创建此处的真实记录。
• 动作回执强度不同：已排队、已下发、设备确认、设备执行结果、服务响应和业务结果分别表示不同阶段，不能相互替代。

27. 选择真实执行记录

操作位置： 规则引擎→规则编辑器

打开执行追踪，按执行编号、触发设备、结果和时间选择一次真实执行。

图：选择真实执行记录

28. 逐节点查看执行结果

操作位置： 规则引擎→规则编辑器

选择对应运行版本的流程节点，检查条件值、分支、失败原因和动作回执。

图：逐节点查看执行结果

29. 区分已下发与设备执行完成

操作位置： 规则引擎→规则编辑器

检查设备控制动作的回执阶段；已下发表示提交到运行通道，不证明物理设备完成动作。

图：区分已下发与设备执行完成

30. 找到限时诊断入口

操作位置： 规则引擎→规则编辑器

在规则设置底部打开执行追踪或开启五分钟诊断；当前未保存草稿的诊断按钮禁用，需先保存。

图：找到限时诊断入口

关键控件速查

配置项	用途与使用建议	生效与恢复
执行编号 / 节点详情	执行编号区分不同真实运行实例；节点详情显示该次判断值、状态和回执；怎么看：按开始时间找到对应实例，再选流程节点查看失败或等待原因。	数据 · 来源：已发布规则的真实执行与动作回执；使用该实例所属版本的流程读图；查看不会再次执行动作。

AI辅助、权限与运行边界

AI生成草稿是编辑辅助功能：选择可用助手，可选地描述希望实现的自动化，系统只依据当前选择的产品、设备和物模型生成草稿。生成成功会用返回的定义和布局替换当前编辑中的草稿内容，因此应先保存或确认不需要保留现有修改。生成后仍必须人工检查资源绑定、校验、模拟、保存和发布；AI不会自动发布。AI不可用或信息不足时，弹窗会保留原因，补足助手配置或提示词后可再次生成。

规则引擎控制面负责定义、资源选择、发布、状态和证据展示；设备协议接入、设备侧执行和外部通知、Webhook、AI服务的最终结果各由对应运行服务回传。页面中的“已下发”“服务已受理”等状态必须按其回执阶段理解。

AI辅助的正确使用

• AI生成规则草稿：输入自动化描述、可选助手和当前产品／设备／字段上下文；输出定义、布局及待处理问题，并替换当前编辑草稿。先保存要保留的草稿；检查生成的触发、条件、动作和资源，处理问题后校验、模拟、保存、发布。
• AI解释本次执行：输入当前定义以及所选真实实例的执行、任务、尝试、追踪和节点信息，输出解释文本。以该实例固定的历史版本流程和追踪为事实依据；解释不改变规则，不触发再次执行。
• AI不可用：生成草稿会提示未部署或无可用助手；解释会退回到已采集的追踪事实说明。配置可用助手后重试，或按现有事实手动排查；不要把不可用当作规则运行失败。

权限与职责边界

• 查看列表、详情、版本、执行和诊断统计：列表、查询权限。只能查看当前租户有权限的数据。
• 新建规则：新增权限。场景和AI均只产生草稿，不能绕过发布。
• 编辑、保存草稿、恢复历史版本、AI生成：编辑权限。不会直接让规则开始运行。
• 模拟与开启诊断：测试权限。模拟没有外部副作用；诊断为限时、限量观察。
• 发布、暂停、恢复、终止实例：发布权限。影响运行状态；终止不能撤回已经下发的命令。
• 删除：删除权限。删除前应保留业务需要的版本和执行证据。

使用时请同时确认以下边界。

• 规则数据按租户隔离；查询设备状态或执行实例时，服务端会验证当前租户归属。
• 当前版本提供的是恢复历史版本为草稿，不提供一键立即回滚已运行版本；任何运行变更仍走发布确认。
• 外部服务的成功与否以相应回执或业务结果为准。模拟、草稿保存、发布请求成功和动作下发均不足以单独证明物理设备执行或通知送达。

31. 打开 AI 生成草稿窗口

操作位置： 规则引擎→规则编辑器

先选产品、设备和字段，再点击 AI 生成，选择可用助手并描述目标。生成后检查覆盖的草稿；本轮仅查看入口，未调用外部 AI。

图：打开 AI 生成草稿窗口

关键控件速查

配置项	用途与使用建议	生效与恢复
生成草稿	按当前资源上下文和业务描述生成定义与布局；什么时候用：先保存要保留的内容，描述触发对象、阈值与处理动作后生成。	生成成功替换当前编辑草稿，仍需校验、模拟、保存和发布；失败时：按本节操作入口重新核对当前状态。

常见问题定位与恢复

排查时按“草稿校验 → 模拟样本 → 发布状态 → 真实执行追踪”的顺序进行。每一步回答不同问题：校验检查定义是否合法，模拟检查给定输入的预期路径，发布状态检查版本是否已进入运行面，执行追踪才说明真实事件和动作回执。

不要直接在列表状态上推断设备或外部服务已完成。先选中对应执行实例，查看其固定版本流程、失败节点、时间线和动作回执；然后再到设备、通知或连接器的责任系统核验最终结果。

按提示恢复

• “请先完成待配置项”或校验问题：画布概览和校验结果抽屉；点击问题会定位字段。补全资源、字段、条件或动作参数后再次校验并保存。
• 草稿保存失败：规则名称、待配置项、历史规则迁移提示和当前资源可用性。修正提示后重试保存；保存失败不会改变已发布版本。
• 发布前检查有错误：发布预检返回的问题和作用范围摘要。在草稿中修正并重新保存；不能绕开预检直接发布。
• 候选版本长期未生效或显示runtime_failed：顶部确认进度、版本历史的发布状态和版本备注。由运行环境管理员检查节点加载／确认；修复后重新发布，当前运行版本保持不变。
• 模拟显示不满足或无法判断：样本事件字段和值、最近状态的设备／字段／观测时间／就绪标记，以及虚拟时间。用物模型正确类型重填样本；为跨设备或定时判断补足未过期且已就绪的最近状态。
• 真实追踪显示条件无法判断：时间线中的数据来源、字段、观测时间、状态版本和规则设置中的状态有效期。核对设备是否已上报、字段是否匹配、状态是否过期；它不能按“不满足”处理。
• 执行被冷却或重复事件抑制：执行／诊断记录中的未执行原因，以及规则设置的冷却秒数与范围。确认这是业务预期；需要更频繁执行时调整草稿冷却并重新发布。
• 动作已下发但未见设备结果：追踪中的动作回执阶段、设备确认／执行结果和设备侧记录。已下发仅代表提交；检查设备在线、协议运行和设备侧回执，必要时等待或按业务流程触发新事件。
• 终止操作提示状态已变化：重新加载当前实例的状态修订和节点状态。确认实例尚未结束后，重新填写终止原因提交；已经下发的命令不能撤回。
• AI无法生成或解释：AI弹窗中的缺失信息、助手可用状态和当前产品／设备／物模型上下文。补齐资源或更换可用助手后重试；AI生成成功也要重新校验、模拟和发布。

使用时请同时确认以下边界。

• 需要保留问题现场时，先不要覆盖草稿；版本历史和执行追踪分别用于保留发布定义和运行事实。
• 当前页面没有执行记录的筛选、翻页或手动刷新按钮；详细追踪打开后会自动刷新最近30条。

生产操作提示

截图和示例用于说明操作位置与判断方法，不代表当前生产状态。涉及发布、启停、重绑、重试或删除时，应先确认目标环境、影响范围和恢复方案，并由授权人员执行。

蜂信物联（FastBee） · 商业版 WEB 操作手册