用途:为 DAG 与工作流可视化编辑器提供设计规范,目标是清晰直观、可组合,参考 n8n、ComfyUI、Retool Workflows、React Flow 等实践。
主要能力:
- 节点设计:节点作为独立组件,标题带图标,配置内联展示,操作放页脚,避免密集端口。
- 连线语义:隐式(顺序流)、显式最小(分支)、打包(多通道)、动画(执行数据流)四种模式。
- 手柄设计:单输入/单输出,类型用颜色或形状区分,悬停时显示。
- 自动布局:推荐 Dagre(层次化,rankdir: 'LR')或 ELK(layered,方向 RIGHT)。
- 导航:小地图、双击适配视图、面包屑、节点搜索。
- 技术栈:React Flow 提供 Background、Controls、MiniMap、useNodesState、useEdgesState;可自定义节点组件。
- 交互:拖拽连线、右键或 / 快捷添加节点、快捷键(Delete、Cmd/Ctrl+D/G/Z、空格拖拽平移、滚轮缩放)。
- 视觉状态:默认、选中、运行中(脉冲动画)、完成、错误;执行时边用虚线动画。
- 反模式:过多手柄类型、连线混乱、隐藏关键配置、无执行反馈、巨型节点、忽略触控。
使用方式:作为设计参考,在实现编辑器时按清单逐项落地,包括自动布局、自定义节点、边动画、小地图、快捷键、撤销重做、搜索、保存加载、导出 JSON/图片。
适用场景:构建低代码工作流、数据处理管道、AI 编排、自动化流程等可视化编辑器。
限制:资料未提供具体安装命令、收费、平台或效果数据;部分代码示例为示意,需结合项目实际调整。