分组节点

分组节点是一个强大的组织工具，允许你将多个工作流节点组合在一起，使复杂的工作流更容易理解、管理和维护。分组有助于可视化工作流的逻辑结构，提高工作流的可读性。

核心概念

什么是分组节点？

分组节点是一个可视化的容器，可以包含多个工作流节点。它提供：

• 可视化组织 - 将相关节点组合在一起，提高清晰度
• 逻辑结构 - 表示功能模块或工作流部分
• 内容文档 - 添加 Markdown 描述来解释分组用途
• 批量操作 - 将多个节点作为单个单元进行管理

何时使用分组

分组在以下情况下特别有用：

• 组织复杂工作流 - 将大型工作流分解为逻辑部分
• 记录工作流部分 - 添加描述，解释每个部分的作用
• 管理相关节点 - 将协同工作以实现特定目标的节点分组
• 提高可读性 - 使工作流一目了然，更容易理解

功能特性

创建分组

可以通过多种方式创建分组：

1. 选择节点并创建分组

   • 在画布上选择多个节点
   • 右键单击并选择"创建分组"或使用键盘快捷键
   • 选中的节点将自动添加到新分组中

2. 手动创建分组

   • 使用工具栏中的分组创建工具
   • 拖动以定义分组区域
   • 创建空白分组后，可以将节点拖拽到分组中

添加节点到分组

拖拽节点到分组：

• 点击并拖拽节点，将其移动到分组区域内
• 当节点完全进入分组区域时，会自动加入该分组
• 节点加入分组后，可以使用"整理分组"功能来自动调整分组大小和节点布局

从分组中移除节点

拖拽节点移出分组：

• 点击并拖拽分组内的节点，将其移出分组区域
• 当节点完全移出分组区域时，会自动从分组中移除
• 节点移出分组后，可以使用"整理分组"功能来自动调整分组大小

分组内容（Markdown 编辑器）

分组支持使用 Markdown 的富文本内容：

• 双击分组以打开 Markdown 编辑器
• 添加描述、注释或文档
• 使用 Markdown 语法进行格式化：
  • 标题（#、##、###）
  • 粗体和斜体文本
  • 列表（有序和无序）
  • 链接和代码块

分组内容示例：

# 用户认证流程

此分组处理所有用户认证逻辑：
- 验证凭据
- 生成 JWT 令牌
- 处理刷新令牌

分组外观

分组支持自定义外观：

• 颜色编码 - 从预定义颜色中选择，以视觉区分分组
• 半透明背景 - 分组具有半透明的彩色背景，可以透过分组看到节点
• 可调整大小 - 调整分组大小以适合内容
• 不遮挡节点 - 分组位于节点后方，不会影响节点的操作和交互

分组操作

分组支持各种操作：

激活/停用分组节点

• 同时切换分组内所有节点的激活状态
• 用于临时禁用整个工作流部分
• 工具栏根据分组节点显示激活状态

复制和复制

• 复制 - 复制整个分组及其所有节点和连接
• 复制 - 在新位置创建分组的副本
• 键盘快捷键：Cmd/Ctrl+C（复制），Cmd/Ctrl+D（复制）

删除分组

• 移除分组容器（节点保留在画布上）
• 或删除分组及其所有节点
• 键盘快捷键：Delete

整理分组

• 自动重新组织分组内的节点
• 优化布局以提高可读性
• 键盘快捷键：Shift+T

分组工具栏

悬停在分组上时，会出现一个工具栏，提供快速操作：

• 运行 - 执行分组中的所有节点（如果全部激活）
• 删除 - 移除分组
• 激活/停用 - 切换分组节点的激活状态
• 更多菜单 - 访问其他选项：
  • 更改分组颜色
  • 复制分组
  • 复制分组
  • 整理节点
  • 删除分组

上下文菜单

右键单击分组以访问上下文菜单：

• 更改颜色 - 为分组选择颜色
• 激活/停用 - 切换激活状态
• 粘贴 - 将节点粘贴到分组中
• 复制 - 复制分组
• 整理 - 重新组织分组内的节点
• 删除 - 移除分组

最佳实践

分组命名和文档

• 使用描述性内容 - 添加清晰的 Markdown 描述，解释分组的用途
• 记录工作流部分 - 使用分组来记录工作流的不同阶段
• 保持分组聚焦 - 每个分组应代表单个逻辑单元或功能

分组组织

• 逻辑分组 - 将协同工作以实现特定目标的节点分组
• 避免过度嵌套 - 不要不必要地创建分组中的分组
• 一致的颜色编码 - 一致地使用颜色来表示相似类型的分组

工作流结构

• 从触发器开始 - 将触发器节点保留在分组外部以提高清晰度
• 按功能分组 - 按功能目的对节点进行分组
• 记录复杂逻辑 - 使用分组内容来解释复杂的工作流部分

键盘快捷键

操作	快捷键
创建分组	选择节点 → 右键 → 创建分组
编辑分组内容	双击分组
复制分组	Cmd/Ctrl+C
复制分组	Cmd/Ctrl+D
删除分组	Delete
整理分组	Shift+T

示例

示例 1：认证流程

分组结构：

• 分组名称：用户认证流程
• 内部节点：
  • 验证凭据 → 生成令牌

分组内容：

# 用户认证

处理用户登录和令牌生成

可视化表示：

[用户认证流程]
    ├─ 验证凭据
    └─ 生成令牌

示例 2：数据处理管道

分组结构：

• 分组名称：数据处理管道
• 内部节点：
  • 获取 → 转换 → 存储

可视化表示：

[数据处理管道]
    ├─ 获取
    ├─ 转换
    └─ 存储

限制

• 分组是可视化组织工具，不影响工作流执行
• 分组内的节点仍根据其连接执行
• 分组不能包含其他分组（无嵌套）
• 分组边界是视觉指南，不限制节点放置

提示

• 使用分组来记录工作流逻辑
• 按功能或重要性对分组进行颜色编码
• 保持分组大小合理 - 过大的分组变得难以管理
• 随着工作流的发展更新分组内容
• 使用"整理"自动组织分组内的节点