跳转至

编辑器界面概览 (The Editor)

可视化编辑器 (Editor) 是创作者搭建、调试、运行并深度自省 Griptape Nodes 工作流的核心视觉工作区。它以一张无限画布（Canvas）为中心：你将各类功能算子节点拖拽到画布上、拉线连接其输入输出引脚，并触发执行。

窗口中的所有其他组成部分——顶部的页眉状态栏、主菜单栏以及左右两侧的折叠侧边栏——均围绕该画布展开：用于为工作流命名、触发调度运算、检索待添加的算子，以及在节点运行时实时洞察其内部执行状态与数据流动。

主画布核心交互 (The canvas)

主画布是工作流拓扑生长的核心土壤。算子节点表现为带有输入输出插槽的矩形卡片；节点之间的连线代表数据流与执行流的传输通道。

画布漫游导航快捷操作

  • 平移画布 (Pan)：按住键盘 空格键 (Space) 并按住鼠标左键拖拽（即使鼠标悬浮在某个节点上方也能全局平移）；或者直接按住鼠标中键拖拽；
  • 缩放视图 (Zoom)：滚动鼠标滚轮、触控板双指捏合，或在左上角缩放条上滑动；也可以按住 Z 键并左右拖拽鼠标实现类似 Photoshop 的丝滑刷擦式缩放（Scrubby Zoom）；
  • 框选与多选 (Select)：在空白画布处拖拽框选一组节点；按住 Shift 并单击节点可以逐一追加或剔除多选。

画布辅助视窗与水印控制

  • 小地图 (Minimap)：位于角落的缩略视窗（若被隐藏可在编辑器设置中开启），一览工作流全局拓扑，点击或在视窗内拖拽可实现毫秒级快速定位漫游；
  • 左下角工具集：提供一键放大、缩小、自适应居中适配视口（Fit View），以及 Toggle Clean Mode（一键纯净模式——隐藏画布底部的装饰性水印标志，方便截图分享）。

在画布任意空白处按下键盘 Tab 键，可在光标所在位置即刻弹出 Add Node (添加节点) 快速检索弹窗。关于节点的配置交互，请参阅 节点基础操作指南；完整快捷键矩阵请查阅 键盘快捷键完全速查。

顶部导航栏 (The header)

页眉横跨窗口顶部，功能划分为三大核心簇：

  1. 左侧信息区：包含侧边栏展开/折叠按钮、主菜单栏 以及当前工作流的显示名称。当存在尚未保存的修改时，名称末尾会亮起星号 * 标识；一旦工作流在本地落盘保存过至少一次，其下方会呈现真实的物理文件名（如 <workflow>.py）；
  2. 中间执行调度控制区：
调度按钮 核心作用与行为逻辑
Run Workflow (运行全流) 从起点开始执行整个工作流的全量拓扑图计算。
Run To Selected (运行至选中项) 仅沿着依赖链向上回溯，计算至当前选中的单个节点为止并暂停。
Run From Selected (从选中项起步运行) 以当前选中的单个节点为起点，沿着依赖链向下顺延执行后续所有节点。
Cancel Run (中断运行) 立即向引擎发送中断指令，强行取消当前正在执行中的计算流。

提示：Run To Selected 与 Run From Selected 仅在画布上恰好选中唯一一个节点时才会激活可用。详见 工作流执行与局部调度。

  1. 右侧系统状态区：包含引擎切换器（用于选择当前编辑器连接哪一台后端的执行引擎实例）、全局报错历史记录下拉列表，以及唤起发布弹窗的 Publish Workflow（发布工作流）按钮。

核心功能主菜单栏 (The menu bar)

1. 文件菜单 (File)

  • New (新建) / Open... (打开...) —— 新建空白工作流或打开磁盘已有工程；
  • Rename... (重命名...) —— 修改工作流标识名称；
  • Save (保存) / Save As... (另存为...) / Save As New Version (另存为新版本) —— 其中另存为新版本操作会在磁盘上自动生成带自增编号的新文件（如 my_workflow_v002.py），绝不覆盖历史文件；
  • AutoSave (自动保存) —— 开启或关闭后台定时静默自动保存；
  • Refresh Libraries (刷新算子库) —— 免重启动态重新加载本地算子库变更；
  • Report Issue (提交缺陷反馈) —— 唤起官方 Bug 提交通道；
  • Exit (退出编辑器) 与 Delete (永久删除当前工作流文件)。

2. 资源管理菜单 (Manage)

用于管理工作流运转所依赖的底层资源生命周期：

  • Model Management (大模型管理) —— 管理可供节点调用的大语言模型、视觉模型与本地模型接入点；
  • Library Management (算子库管理) —— 安装、同步、升级与配置算子库（详见 算子库管理手册）；
  • Engine Management (引擎服务管理) —— 审查与切换正在运行的后端执行引擎连接；
  • Project Management (项目工程管理) —— 在不同的项目模板与工作区之间无缝切换（详见 GUI 项目管理指南）。

3. 设置菜单 (Settings)

整合了所有可配置的全局参数面板：All Settings（全量配置）、Agent Settings（智能体设置）、Editor Settings（编辑器交互偏好）、Theme Settings（画布主题）、Engine Settings（引擎参数）、File System（文件系统与工作区）、Libraries（算子库设置）、MCP Servers（MCP 服务协议）、API Keys & Secrets（密钥凭证）以及 实验性预览特性 (Beta Features)。

菜单底部提供了快速工具：Copy Path to Settings（复制配置文件路径到剪贴板）、Show Settings Folder（在系统文件管理器中打开配置文件夹）以及 Reset Settings to Default（一键恢复出厂缺省配置）。

左侧探索侧边栏 (The left sidebar)

左侧侧边栏是发掘与向画布添加节点的主要阵地：

  • Favorites (收藏夹)：常驻在最顶部。点击任意节点卡片上的星标，即可将其置顶固定在此，免去高频节点的反复检索；
  • 实时搜索框：键入关键词即时过滤下方活跃标签页中的节点。

搜索框下方提供两个浏览视图： 1. Nodes (按功能分类)：将官方内置与第三方安装的所有算子节点按照功能领域（图像处理、文本大模型、逻辑控制、变量处理等）分类呈现； 2. Libraries (按算子库分类)：按照节点所在的具体来源算子库进行归类罗列。

从任一视图中按住鼠标左键直接拖拽目标节点至主画布上，即可完成实例化添加。

右侧状态与属性面板 (The right sidebar)

右侧侧边栏集成了深度调试与参数编排的四大核心选项卡（点击面板右上角的三点菜单可以按需勾选隐藏或显示任意标签）：

  • Properties (参数属性面板)：创作者最核心的工作交互区。选中画布上的任意节点时，此处会渲染出该节点的所有参数滑块、输入框、下拉菜单与开关，用于精细调节节点的计算行为；
  • Chat (AI 助手交互)：直接在编辑器内部与常驻智能体对话，支持随时切换模型服务商并挂载 MCP 工具服务；
  • Code (代码审查与脚本)：实时呈现当前工作流编译后的原生 Python 源码，支持语法高亮检索与直接调试运行；
  • Logs (实时执行日志)：输出引擎调度全流程的流式控制台日志，支持按日志级别（Debug、Info、Warning、Error、Critical）分级过滤与关键词搜索。

下一步探索推荐 (Where to go next)