n8n 中文文档

画布组

提示

Feature availability 功能可用性

Canvas Groups 从 n8n 2.28.0 开始逐步推出,并从 n8n 2.31.0 起在所有实例上可用。

Canvas Groups 画布分组可将相关节点整理到画布上一个带名称的分组中。你可以将处理工作流某一部分的节点放入分组、为分组命名,并在需要简洁视图时将其折叠。Canvas Group 会随工作流保存,因此任何打开工作流的人都能看到相同的结构。你可以折叠 Canvas Group 以获得更简洁的视图;这项个人偏好保存在浏览器中。你还可以为 Canvas Group 添加描述,方便阅读工作流的人快速了解这一部分的作用。

包含展开和折叠 Canvas Groups 的工作流,其中一些带有描述

创建画布组

  1. 选择要分组的节点。在它们周围拖动一个选择框,或按住 Ctrl/Cmd 并单击每个节点。
  2. 选择所选内容上方工具栏中的 Group nodes 组节点 图标 Group nodes icon,在所选内容的右键菜单中选择 Group nodes 组节点,或按 Ctrl/Cmd + G。
  3. n8n 创建画布组并突出显示名称字段,以便你可以立即输入名称。

只有所选节点能够组成有效的 Canvas Group 时,才能进行分组。相关规则请参阅可分组的内容。

命名画布组

创建 Canvas Group 时,n8n 会自动分配默认名称(例如「Group 1」)并突出显示,你可以立即将其替换为更具描述性的名称,也可以保留建议名称。

以后要重命名 Canvas Group,请选择它并按 Space,或在右键菜单中选择 Rename group 重命名分组。对于展开的 group,这会突出显示名称,以便你直接编辑;对于折叠的 group,这会打开一个可编辑名称的对话框。你也可以直接点击展开 group 的名称进行编辑。点击 group 外的任意位置即可保存。Group 名称不能为空。

为 Canvas Group 添加描述

你可以为 Canvas Group 添加最多 145 个字符的可选描述,方便读者无需展开即可了解该工作流部分的作用。描述会随工作流保存,并在复制、粘贴或 duplicate Canvas Group 时保留。

在展开的 Canvas Group 上,描述会显示在名称下方。点击 Add description 添加描述,输入描述,然后按 Enter 保存。

在折叠的 Canvas Group 上,名称旁会显示 info 图标。将鼠标悬停在图标上即可查看描述。

要让描述保持可见而不需要悬停,请选择 description card 上的 eye 图标将其锁定打开,或右键点击 Canvas Group 并选择 Show group description 显示分组描述。要一次显示或隐藏所有描述,请在画布右键菜单中使用 Show group descriptions 显示分组描述 / Hide group descriptions 隐藏分组描述。与折叠状态一样,描述可见性是保存在浏览器中的个人偏好。

当你缩小到足够低的缩放级别(大约低于三分之二)时,描述会隐藏。如果导入的工作流包含超过 145 个字符的描述,n8n 会缩短它们并显示 warning。

折叠和展开画布组

折叠 Canvas Group 可隐藏其中的节点,只显示名称,以及你添加的描述(请参阅为 Canvas Group 添加描述)。这会将大型工作流缩减为更易读的视图。

点击 Canvas Group 的 header 可折叠或展开它。要一次操作多个 group,请在画布右键菜单中使用 Expand all groups 展开所有分组 / Collapse all groups 折叠所有分组,或按 Alt + G 展开、Shift + Alt + G 折叠。选择 groups 或 group 内节点时,快捷键作用于这些 groups;没有选择任何内容时,快捷键作用于所有 Canvas Groups。

n8n 会记住您展开的 Canvas Group,并在重新打开工作流时保持相同视图。此偏好保存在浏览器中,仅适用于您和当前设备。它不会随工作流保存,也不会同步到其他浏览器或其他用户。

取消分组

要将画布组重新分成单独的节点,请选择其上方的 Ungroup 取消分组 图标 Ungroup icon,在右键菜单中选择 Ungroup nodes 取消分组节点,或按 Ctrl/Cmd + Shift + G。节点保留在画布上。

右键菜单中的 group 操作

右键点击 Canvas Group 可打开它的 context menu。Rename group 重命名分组和 Ungroup nodes 取消分组节点位于顶部,随后是与多节点选择相同的操作,但针对 group 调整措辞(例如 Copy group 复制分组、Delete group 删除分组等)。该菜单也适用于折叠的 groups,操作会应用到其中隐藏的节点。

右键点击画布空白区域可使用 Expand all groups 展开所有分组 和 Collapse all groups 折叠所有分组。如果你的选择中包含 groups,context menu 会改为提供 Expand selected 展开所选内容 和 Collapse selected 折叠所选内容。

可分组的内容

并非每个选择都可以成为 Canvas Group。当你选择节点时,n8n 会检查一些规则,并且仅在全部通过时才显示 Group nodes 组节点 图标 Group nodes icon。如果该图标未出现,请根据以下规则检查你的选择:

  • 节点尚未属于其他 Canvas Group。
  • 所选内容不包含触发器节点。触发器是工作流起点的锚点,必须位于 Canvas Group 外部。
  • 节点构成一条相连的链。不能将彼此不相邻的节点加入同一个 Canvas Group。
  • Canvas Group 外部的节点只能连接到分组中的第一个或最后一个节点,不能直接连接到中间节点。
  • AI 节点及其子节点(聊天模型、memory 和工具)必须一起位于同一个 Canvas Group 中。子节点连接不能跨越 Canvas Group 边界。
  • 所选内容至少包含两个项目。你不能创建单节点 Canvas Group。
  • Sticky notes 可以和节点一起成为 Canvas Group 的一部分。

如果已保存的工作流包含违反这些规则的 Canvas Groups(例如导入了在其他地方编辑过的工作流后),n8n 会在保存工作流时自动取消这些 groups,并显示 warning。节点会保留在画布上。

只读工作流程中的画布组

工作流以只读方式显示时(例如工作流历史记录或共享视图中),Canvas Group 默认展开,以便您查看完整工作流。

键盘快捷键

操作 快捷键
对所选节点进行分组 Ctrl/Cmd + G
取消所选节点的分组 Ctrl/Cmd + Shift + G
展开 Canvas Groups(所选或全部) Alt + G
折叠 Canvas Groups(所选或全部) Shift + Alt + G
重命名所选 Canvas Group Space

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。