Flow-Like Studio 核心概念详解:App、Flow、Board 与 Nodes 一次搞懂

原创2026-10-22 16:25:491,648 阅读

Flow-Like Studio 核心概念详解:App、Flow、Board 与 Nodes 一次搞懂

Flow-Like 是一款面向企业的强类型工作流开发平台,其桌面应用 Studio 用四个核心概念组织了所有功能:App(项目)、Flow(可执行流程)、Board(持久化画布)和 Nodes(类型化操作节点)。无论你是零基础新手还是有经验的开发者,读懂这四个词,就能看懂 Flow-Like 里的一切。本文用 5 分钟带你建立完整心智模型,不再被术语绕晕。

Flow-Like Studio 桌面应用界面,展示 App 中的工作流画布、Nodes 节点与 FlowScript 编辑器

上图:Studio 中打开的一个 App——左侧是项目资源(Flow 文件、UI 组件、数据存储),中间是 Nodes 组成的工作流画布,右侧是同一逻辑的 FlowScript 文本视图,底部是运行记录(Runs)与日志。

1. 一分钟认识 Flow-Like 与 Studio

Flow-Like 的定位是"构建企业运转所依赖的软件":把数据库、API、文件、AI 模型等已有系统,用可视化节点编排成可复用的流程,再挂上界面、定时任务或 API 对外提供服务。它内置 1,900+ 个 Nodes,覆盖 SQL 数据库、HTTP API、文档处理、媒体、UI、自动化和 AI/机器学习等领域。

  • Flow-Like:整个平台(作者工具 + 运行时 + 数据 + 权限 + 包管理)
  • Studio:桌面应用,负责创建 App、编辑 Flow、调试运行、查看日志

你可以从 README.md 的 "Try it locally" 章节找到第一个本地工作流的操作步骤,无需账号、API Key 或 AI 模型即可跑通。

2. App:一个解决方案的项目与治理边界

在 Flow-Like 中,App 不只是"应用",更是一个项目边界。它把属于同一方案的所有东西聚在一起:

App 内含 作用
Flows 该方案的所有可执行流程
Events 流程的对外暴露入口(API、定时、页面按钮等)
页面与 UI 可视化前端构建器产出的界面
文件与结构化数据 流程可读写的存储与数据表
Packages 依赖 引入的自定义节点与组件包
成员、角色、发布设置 团队协作与权限治理

Flow-Like App 结构图:一个 App 聚合 Flows、Experience、Data、Reuse 与 Delivery

上图:一个 App(Customer Support Copilot)作为项目边界,聚合工作流逻辑、事件与页面、数据存储、复用组件和团队交付设置。

关键认知:"App" 描述的是归属,而不是界面形态。一个 App 可以是纯自动化、一个 AI Agent、一组 API,也可以带交互页面——这些表面可以共享同一套逻辑和数据。

3. Flow:App 内的一条可执行流程

Flow 是 App 内的一条可执行流程。日常协作中你说"运行一下分诊 Flow""发布摄取 Flow 的第二版",指的就是它。一个 App 通常包含多个职责单一的 Flow。

Flow 有两种等价的编辑方式:

  1. 画布编辑器(Canvas):节点 + 类型化连线的可视化形式,适合追踪数据走向、检查分支;
  2. FlowScript 编辑器:把同一逻辑渲染为声明、调用、表达式、分支、循环等文本形式,适合搜索、评审和大批量修改。

Flow-Like 画布编辑器与 FlowScript 文本编辑器并排展示同一 Flow 逻辑

上图:左侧画布中 Nodes 通过连线构成执行链,右侧 FlowScript 面板显示同一流程的文本形式——两者始终双向同步。

4. Board:Flow 背后的"存档文件"

这是新手最容易混淆的一点:Flow 是概念,Board 才是真正被持久化存储和执行的对象。

  • Board:保存节点的图模型——Nodes、Pins(端口)、连线、变量、图层、注释、执行设置、版本信息;
  • Canvas:只是 Board 的可视化编辑器,不是 Board 本身;
  • FlowScript:是 Board 的类型化文本投影,而不是独立程序。

Flow-Like 内部通过一个类型化中间表示 BoardAst 让画布编辑和文本编辑双向同步:画布改动会更新文本投影,文本改动经解析、对齐(reconciliation)后以原子补丁写回 Board,运行时始终执行的是 Board,而非 FlowScript 源码。这套机制的完整讲解见 14-board-ast-text.mdx。

Manage Board 面板:配置 Board 名称、描述、Stage、Log Level、执行模式与版本

上图:Studio 的 Manage Board 面板——在这里管理 Board 的设置、日志级别、本地/远程执行模式,并创建 Major/Minor/Patch 版本。生产环境的 Event 可以固定指向某个不可变的 Flow 版本,而开发继续在新草稿上进行。

5. Nodes 与 Pins:类型化积木的两种连线

Node(节点) 是 Flow 中最小的具名操作:裁剪字符串、调用服务、读写文件、分支判断、调用模型等。每个节点都带有目录身份和契约:人类可读的名称与文档、类型化的输入/输出端口(Pins)、默认值、执行行为、版本与环境限制,以及权限要求(如外部 WASM 节点声明的网络、存储等能力)。内置节点目录源码位于 packages/catalog/。

节点之间靠 Pins 通信,而连线分成两种,回答两个不同的问题:

  • 数据连线(Data wire):值从哪来?——粉色虚线,携带字符串、整数、布尔、结构化数据等带类型声明的值;
  • 执行连线(Execution wire):什么时候允许执行?——黑色实线,控制节点的先后顺序与分支走向。

Flow-Like 顺序工作流结构:receiveIncident 事件节点依次连接三个 Call 节点,展示执行连线与数据连线

上图:最简单的线性 Flow——执行连线(黑色实线)决定顺序,数据连线(粉色虚线)传递 report、normalized、status 等类型化值。

这里还有一个重要区分:

  • 纯节点(Pure node):没有执行端口,只在别的操作需要它的值时按需求值(如字符串转换);
  • 非纯节点(Impure node):位于执行路径上,因为顺序很重要(如发消息、更新状态)。

Flow-Like 分支工作流:Trim String 与 Contains 节点为 Branch 提供条件,Branch 的 True/False 执行路径分别连接 Log Error 与 Print Info

上图:带分支的 Flow——Trim String → Contains 这条数据链为 Branch 的 Condition 提供布尔值,执行连线则保证只有一条路径上的日志节点真正运行。

6. 四个概念如何串起来:一句话心智模型

App 拥有解决方案,Flow 表达一个流程,Board 把流程存成一张图,Nodes 是图上类型化的操作步骤。

完整链条如下:

  1. 在 Studio 中创建一个 App(项目边界);
  2. 在 App 中新建 Flow,打开画布编辑 Board;
  3. 从 1,900+ 节点的目录中添加 Nodes,用数据连线喂值、用执行连线控序;
  4. 用 Event 把流程暴露给调用方(API、定时任务、页面按钮、聊天等);
  5. 运行时(本地或远程的 Rust Runtime)加载所选 Board 版本执行,运行日志和证据回到 Studio 的 Runs/Logs 中。

Flow-Like FlowScript 编辑器:右侧文本视图展示类型接口定义,与左侧画布上的工作流 Nodes 双向同步

上图:FlowScript 文本视图中的接口声明(FlowPath、NodeDBConnection、Metadata 等)对应左侧画布中同一 Flow 的类型化节点。

7. 延伸阅读与关键路径

想了解的内容 去哪里找
术语总表与平台地图 introduction.mdx
App/Flow/Board 与 Event 的完整关系 03-one-platform-one-flow-model.mdx
Nodes、Pins、连线与执行模型 05-nodes-pins-wires-execution.mdx
Board ⇄ AST ⇄ FlowScript 的同步机制 14-board-ast-text.mdx
第一个本地工作流(Hello Flow) README.md "Try it locally" 章节
自定义 Nodes(Rust 原生 + 15 种语言 WASM 模板) templates/
内置节点目录实现 packages/catalog/

掌握这套词汇后,你就可以按书中 04-first-flow-incident-triage.mdx 的引导,亲手搭出第一个带分支、类型和运行日志的完整 App 了。🚀

登录后查看全文
flow-like