算子节点基础操作 (Working with Nodes)

本文档系统拆解在主画布上搭建工作流的高频日常操作：添加节点、选择与平移对齐、重命名、节点克隆、锁定保护、节点删除、引脚连线以及参数配置。关于工作流的触发执行机制，请参阅工作流执行与局部调度；关于将节点框选打组，请参阅节点视觉编组。

向画布添加节点 (Adding nodes)

唤起 Add Node (添加节点) 快速检索弹窗有三种途径：

当鼠标光标悬浮在画布上方时按下键盘 Tab 键；
当鼠标光标悬浮在画布上方时按下 Shift+A 快捷键（若光标脱离画布区域，按下 Shift+A 则会触发全局全选）；
在空白画布上点击鼠标右键，选择 Add Node。

弹窗会在当前鼠标光标所在坐标弹出，选中目标算子后即可直接就地生成。弹窗支持全字段智能模糊检索——键入关键词可实时按类名、描述或标签进行过滤，亦可逐级展开树状分类目录。弹窗顶部常驻 Favorites (收藏夹) 与 Recent (最近使用) 快捷列表。

此外，你也可以随时从左侧侧边栏的 Nodes 标签页中直接按住鼠标左键将节点拖拽至画布上。

节点选择与空间排列 (Selecting and moving)

单击选中：点击任意节点即可将其选中；
全选与取消：使用 Cmd/Ctrl+A 可一键全选当前流中的所有节点；按下 Escape 键一键清空选中；
框选多选：在空白画布处拖拽矩形选区，即可批量框选内部的所有节点；
增量多选：按住 Shift（或 Cmd/Ctrl）并连续点击多个节点即可构建多选集合。

当选中多个节点时，按住拖拽其中任意一个节点，整个多选集合将保持相对空间间距整体同步位移。同时，多选集合上方会浮现专属的悬浮快捷工具条，支持一键批量执行复制 (Copy)、克隆 (Duplicate)、锁定 (Lock)、重置 (Reset)、删除 (Delete) 以及打组 (Create Group) 等操作。

键盘高阶漫游与排版快捷键

方向键智能跳跃：按下键盘上的上下左右方向键，光标选中焦点会自动跳跃至该方向上距离最近的相邻节点，无需频繁伸手抓取鼠标；
聚焦适配 (F)：按下 F 键即可将当前选中的节点居中放大适配视口（若未选中任何节点，则自动对全局图谱进行整体居中适配）；
全图智能排版 (Shift+G)：自动基于拓扑依赖流向重新计算节点坐标，一键生成整洁优美的画布布局。

节点重命名规范 (Renaming)

在 Griptape Nodes 底层，节点的显示别名同时充当其在工作流内部的唯一物理标识符 (ID)。因此，重命名一个节点会自动级联更新代码与拓扑中涉及该节点的所有下游引用。

重命名单个节点：选中节点后按下 R 键，或悬停在节点标题上点击浮现的铅笔图标，亦可右键选择 Rename。输入新名称后敲回车 Enter（或点击空白处）确认修改，按下 Escape 放弃修改；
批量重命名多个节点：多选一组节点后按下 R 键（或右键选择 Rename），系统会弹出 Rename nodes 批量重命名对话框。填入一个基准名称（Base Name），首个节点会直接采用该名字，其余节点将自动自增追加序号（如 Base_1、Base_2...）。

节点克隆、复制与粘贴

就地克隆 (Duplicate)：快捷键 Cmd/Ctrl+D（或点击节点悬浮栏上的克隆图标）。系统会在原节点紧邻的右侧就地生成一份完全独立的新节点副本，该副本不会继承任何外部连线；
序列化复制 (Copy)：快捷键 Cmd/Ctrl+C。将选中的节点及其当前配置的全部参数数值完整序列化并写入系统剪贴板；
跨画布粘贴 (Paste)：快捷键 Cmd/Ctrl+V。在鼠标光标附近反序列化并生成节点。支持跨工作流标签页复制粘贴：在一个工作流标签中复制，切换到另一个工作流标签中粘贴即可实现资产跨流迁移。

节点锁定保护机制 (Locking)

锁定一个节点能够为关键节点施加防呆保护：处于锁定状态的节点严禁被手动触发计算、严禁被删除、严禁修改任何参数值，且无法动态追加新参数，直至用户主动解锁。

按下快捷键 L（支持批量多选生效）、点击节点标题栏上的锁头图标，或右键选择 Lock/Unlock 均可快速切换锁定状态。

节点删除及其运行期熔断机制 (Deleting)

选中一个或多个节点后按下 Delete 键（或部分键盘上的 Backspace），即可将其彻底移除。删除节点会自动拔除清理其关联的所有输入输出连线。

若删除的是一个仅充当线路弯折中继的 Dot 转向点节点，系统会自动将原线路两端的端子直接缝合相连，绝不会掐断整条数据流。

在工作流运行期间删除节点会发生什么？

用户完全无需等待漫长的工作流运算结束即可在运行时直接删除节点。底层引擎会根据计算依赖进行精准熔断：

当前计算链路不再依赖该节点：例如该节点早在一分钟前已计算完毕，或者它处于一条完全不相干的旁支链路上。引擎将不受任何影响，继续高速运转；
当前计算链路依然强依赖该节点：例如下游即将执行的节点仍在等待该节点的计算输出。引擎会立即安全熔断取消本次运行！并在控制台明确报告究竟是哪个下游节点因缺失该输入而导致中断，防止使用空默认值产生错误的计算废件。

参数端口连线交互 (Connecting parameters)

节点上凡是具备输入或输出能力的参数，在其行边缘均呈现接线引脚（左侧为 Input 输入端子，右侧为 Output 输出端子）：

建立连线：按住鼠标左键从一个引脚拉出连线，拖动至目标节点的兼容引脚上松开；
智能向后派生：按住引脚向空白画布拖出并松开鼠标，系统会自动就地打开 Add Node 菜单，并自动将所选新节点的输入引脚预先连好，实现流水线级的高速链式搭建；
类型兼容感知：连线拖拽期间，画布上所有类型不兼容的引脚会自动暗化置灰，直观指引可落脚的引脚；
断开连线：单机选中连线线缆后按下 Delete 键删除，或悬停在线缆上点击浮现的剪刀/端开图标。

转向点与线路整理 (Dot and reroute nodes)

Dot 节点 (转向点) 是一种没有任何多余业务逻辑的纯透明数据中继节点，专门用于在拥挤复杂的画布上将原本穿插交叉的长连线优雅绕折，理顺视觉拓扑。

悬停或选中某条连线，按下键盘 I 键，系统会即刻在该鼠标位置切断连线并插入一个 Dot 节点。数据无损流经该点。删除 Dot 节点会自动直连两端。

自由注释便签 (Notes)

便签是画布上免执行的纯文本便利贴，用于记录工程设计意图、TODO 待办事项或针对上游依赖的警告备忘。

光标悬浮在画布任意处按下键盘 N 键即可就地生成一张便签。便签不参与任何图执行调度，无法被锁定，也不受批量运行指令影响。

属性面板深度编排 (Properties Panel)

在右侧侧边栏中切换至 Properties 面板（快捷键 Cmd/Ctrl+B）。选中画布上的节点后，面板会以规范的垂直流式表单呈现该节点的所有参数项。在 Properties 面板中编辑参数与在节点内部控件上输入完全等价、实时双向同步。

动态追加自定义参数 (Custom Parameters)

部分支持动态扩展的节点（如各类通用智能体或脚本节点）允许用户自行追加额外参数：

点击节点底部的 Add parameter 按钮唤起配置弹窗：

配置属性	详细规格说明
Name	参数在底层代码中的唯一变量名标识（同一节点内必须唯一）。
Display Name	在前端界面上呈现的人类可读标签。
Type	强类型约束：`Any`、`str`、`bool`、`int`、`float`、`dict`、`json` 或多媒体类型 `image`、`audio`、`video`。
Tooltip	鼠标悬浮在参数上时展示的解释性帮助说明。
Input / Output	参数的功能模式：允许作为输入接入、允许作为输出引出，或兼具二者。
Default Value	参数在连线或输入前的缺省基底数值。

针对不同的数据类型，弹窗会自动呈现专属的高级修饰项（如字符串的多行 Markdown 文本框、数值类型的 Min/Max/Step 滑块范围，或下拉菜单的静态枚举选项列表）。

自动折叠已连线的参数 (Hide connected parameters)

按下快捷键 Shift+H（或在编辑器设置中开启 Hide Connected Parameters），系统会自动将所有已经接入了有效上游连线的输入参数行全部折叠隐藏。

这是一个极佳的画布降噪利器：因为一旦某个参数的数值已经确定由上游连线驱动，原本的静态输入控件便失去了常驻占位的意义。再次按下 Shift+H 即可瞬间恢复展开。