节点组、画布标注与剪贴板¶

节点组会改变蓝图结构；普通框、注释框和图片框只服务阅读。选择合适的对象，才能在整理画布时避免意外改变执行逻辑。

节点组¶

节点组把一组节点封装为具有明确输入输出的嵌套子图。默认需要选择至少两个可移除、且允许进入节点组的节点；开始和结束节点不能进入普通节点组。

下文提到的快捷键均为默认键位，可在设置中修改。选中节点后按 Ctrl+G，或在右键菜单选择“建立组”。编辑器会保留组内连线，并把穿过组边界的执行线和数据线改写成组接口。

进入和退出节点组¶

• 双击节点组进入内部编辑。
• 组内部包含入口与出口终端，用于连接外部接口。
• 位于组内时，左上返回键先回到外层画布，不会直接退出整个蓝图。

编辑节点组接口¶

选中外层节点组，或在组内选中入口、出口终端时，右侧会显示“节点组接口”面板。接口分为：

• 执行输入
• 执行输出
• 数据输入
• 数据输出

可以添加接口并修改显示名称。每类接口至少保留一个；只有末尾接口同时满足未连接、无自定义名称、且不是唯一接口时，才可以删除。该限制可以避免删除中间接口后让既有连线错位。

实例名称与共享定义¶

外层对节点组执行普通重命名时，修改的是当前实例别名。在组内部修改名称或接口时，修改的是共享的节点组定义，会同步到引用该定义的关联实例。

Alt+D 用于链接复制所选节点组并开始移动，新实例继续共享同一组定义。Shift+D 或普通复制、粘贴会为节点组建立独立定义；需要两个副本以后分别修改时使用独立复制路径。

解散节点组¶

“解散组”会把内部节点和连线展开回当前画布，并恢复可恢复的边界连接，不是简单删除内部内容。解散后仍应检查外部路线和节点位置。

普通框¶

选中节点后按 Ctrl+T，或右键选择“并入新框”，可创建包围选择的普通框。

• 拖动普通框会同时带动与框区域重叠的节点。
• 调整框大小只改变框自身，不移动节点。
• 删除框只删除视觉框，不删除其中节点。
• PageUp / PageDown 调整一层，Shift+PageUp / Shift+PageDown 置顶或置底。

普通框适合划分流程阶段，不提供输入输出，也不会成为一个可执行节点。

注释框¶

在画布空白处右键选择注释框。注释支持多行文字，双击进入编辑，Enter 换行。拖动或删除注释只影响注释自身，不会移动或删除附近节点。

建议在注释中说明：

• 这段流程的目的和前置条件。
• 关键变量或目标来自哪里。
• 失败时允许重试、跳过还是终止。
• 仍在开发中的节点为什么暂时保留。

图片框¶

在画布空白处右键选择图片框。图片框可导入图片或截取屏幕范围，用作设计参考。图片存在时会保持宽高比显示；它不会参与图像识别，也不会因为放在节点旁边就成为节点输入。

导入较大图片时，编辑器可能询问保留原尺寸或等比缩小。作为节点运行资源的图像应通过对应节点或变量引用，而不是依赖图片框。

节点剪贴板¶

节点编辑器使用软件进程内的专用剪贴板：

• Ctrl+C 复制所选节点。
• Ctrl+X 剪切所选节点。
• Ctrl+V 粘贴到指针位置。
• Shift+D 在当前画布复制并立即移动。

它不使用系统剪贴板，也不会覆盖自动化工作区剪贴板或宏片段剪贴板。可以退出一个蓝图再进入另一个蓝图继续粘贴；关闭或重启软件后，节点剪贴板会清空。

复制内容与依赖¶

复制节点选择时，剪贴板包含：

• 所选节点。
• 所选节点彼此之间的连线。
• 实际引用的变量定义。
• 所需节点组定义。
• 实际引用的 Image、Video 和 ONNX 资源。

与未选节点相连的外部连线不会复制。普通框、注释框和图片框也不属于节点选择，不会随节点复制。

粘贴到其他蓝图时，编辑器会合并依赖资源，并处理变量或定义 ID 冲突。粘贴位置优先使用当前鼠标位置；没有可用位置时会参考活动节点或视口中心。

如果依赖缺失或数据无效，粘贴会失败并保留目标蓝图原状态。剪切时若删除源选择失败，原剪贴板内容也会恢复。

不能复制或删除的对象¶

• 开始节点不能复制、剪切或删除。
• 结束节点可以复制，但最后一个结束节点不能剪切或删除。
• 由软件维护的内部节点可能不提供普通复制入口。

跨蓝图粘贴完成后，系统会迁移可识别依赖，但仍需核对目标、文件路径、公开变量默认值和业务语义是否适合新蓝图。

选择哪种整理方式¶