RuleGo-Editor 地址：https://editor.rulego.cc/ (opens new window) 允许在线设计、修改、调试规则链，而无需本地运行前端服务。

完整在线演示：http://8.134.32.225:9090/editor/ (opens new window) —— 对接 RuleGo-Server 的工作区（本文所有截图即此环境）：保存到服务端、运行调试、执行历史全流程可用，随手试不伤数据。

它支持 纯前端方式 和 RuleGo 后台服务联动方式 操作。

📘 本文是快速导览。完整分步教程（14 章 79 页，每步带界面标注图）见 用户使用手册 PDF，编辑器内「⋯」菜单也内置了同一份手册。

界面总览

工作区模式打开一条规则链后，界面分五个区（浅色主题）：

• ① 顶栏：产品标识、「新建规则链」入口；右侧依次为连接状态灯、「保存」、「部署/下线」运行开关、「调试」、「⋯」更多操作菜单、用户胶囊。
• ② 标签页条：每条打开的规则链一个标签，带运行状态徽标与未保存红点；「+」新建，「∨」列出全部标签。
• ③ 资源管理：规则链树，按分类分组，含子规则链与共享节点。
• ④ 组件库：按功能分组的组件面板，画布节点的来源。
• ⑤ 状态栏：画布右下角，缩放控制与节点数。

界面提供浅色/深色/跟随系统三种外观（「⋯」菜单 → 外观与帮助），面板开合状态自动记忆。

创建规则链

点击标签页条右侧「+」，填写基本信息：

• ① 名称：规则链显示名（如「冷链仓库温度监控」）。
• ② ID：唯一标识，留空自动生成。
• ③ 描述：用途说明，显示在链列表与资源树。
• ④ 创建：保存到服务端并立即上线运行。

创建后新链自动打开，画布初始有一个「输入」节点（消息入口），顶栏出现「下线」按钮说明链已在运行：

画布编排

组件库：左侧按功能分组（输入端点/公共/过滤器/转换器/动作/外部的/AI/IoT 等），支持搜索定位：

拖入节点：把组件卡片拖到画布目标位置松开即添加节点；悬停卡片可预览组件说明：

连线：从节点边缘锚点拖到目标节点，弹出关系标签确认（如 js 过滤的「成功/失败」两条分支），消息按判定结果走对应连线：

画布还支持：框选批量操作、对齐参考线、Ctrl+C/V 复制粘贴、Ctrl+Z 撤销、右键菜单（在此添加节点/粘贴/自动布局/全屏/面板开关）、右下角缩放控件（Ctrl+0 复位）。

节点配置

双击节点，右侧面板展开「配置」标签。脚本类节点（如 js 过滤）内置代码编辑器，带语法高亮，直接写函数体：

例如 js 过滤返回 return msg.temperature > 8：返回 true 走「成功」连线，否则走「失败」。表单类节点（如日志）则是字段表单 + 即时校验；低频字段收在「高级配置」折叠组。配置改动自动回传画布即刻生效。每个节点还有「调试模式」开关——开启后该节点每次消息进出都记录 IN/OUT 日志。

保存与部署

• 脏态：有未保存修改时标签页出红点，「保存」按钮变实心可点（Ctrl+S）。
• 保存 ≠ 改变运行状态：运行中的链保存后新版本立即生效；已下线的链保存只落库、保持下线，通知附「部署」按钮引导上线。

顶栏运行开关按状态切换：运行中显示红色「下线」（旁附下拉：重启此链/重启全部），已停显示「部署」。术语约定：部署 = 让改动上线，下线 = 停链。

每次保存自动留一个历史版本快照（默认保留最近 20 个），顶栏版本徽标（如 v3）或「⋯」菜单 → 历史版本可随时比对差异、一键回滚：

调试运行

点击顶栏「调试」，右侧面板填入模拟消息（消息类型 + JSON 请求体），点「发送」执行；勾选「等待结果」同步取回出口消息：

要看逐节点的消息流动，打开底部「调试控制台」（WebSocket 实时接收），每个节点的 IN/OUT 消息与耗时按时间列出，IN/OUT/LOG 可按类型过滤，支持暂停与清除；断线自动重连。调试表单按链自动记忆上次发送的参数，反复调试不用重填；执行失败时错误信息自带出错链与节点位置，JS 脚本错误的行号与编辑器一致：

对已下线的链发送会被守卫拦截，并给出带「部署」按钮的引导通知；点击部署成功后该消息自动重发一次。「从此节点运行」「仅该节点」可把调试范围缩小到单节点。

运行记录

底部面板的「运行记录」标签列出历史执行（支持筛选），失败的记录直接标出出错节点；点开可看节点级明细与耗时瀑布图（横条越宽耗时越久，「最慢」标签指出瓶颈），勾选两条记录还能做对比（差异定位/消息 diff/瀑布对比），用于回溯定位：

AI 智能助手

点击顶栏 AI 助手打开对话面板，自然语言创建和修改规则链（多服务商：Gitee AI、DeepSeek、通义千问、智谱 AI、OpenAI、Ollama），生成结果一键应用到画布：

示例对话：

• 创建一个 MQTT 到 HTTP 的数据转发规则链
• 在 HTTP 节点前面加一个过滤器节点，过滤 temperature > 50 的数据
• 把日志输出改为写入 Redis

详细教程请参考 AI 助手使用教程 (opens new window)

纯前端方式

RuleGo-Editor 支持脱离 RuleGo 独立使用：设计好规则链后，通过「⋯」菜单 →【数据与运行】→【导出】下载规则链 JSON 配置文件，交给 RuleGo 使用；也支持导入现有 DSL 文件继续编辑。

RuleGo 后台联动方式

先运行 RuleGo 提供的 RuleGo-Server (opens new window)，然后在编辑器的系统设置中配置 API 根目录（用户菜单 → 系统设置）。配置后台后，可直接保存规则链到服务端、调试和查询节点执行日志。

后台工程设置了允许跨域，所以你可以在本地运行 RuleGo 服务，然后在 https://editor.rulego.cc/ (opens new window) 这个编辑器配置调用的 API。