全部文章

3 分钟看懂 uuos 画布编排

第一次打开 uuos，你会看到三块区域：左边节点库，中间画布，右边检查器。这篇文章用 3 分钟讲清楚它们背后的模型。

概念一：节点是执行单元

画布上的每个节点都是一个可执行单元，共 9 种：Start、LLM、HTTP、Template、Condition、Loop、RAG、SubFlow、End。

每种节点只做一件事。LLM 节点调模型，HTTP 节点调外部 API，Condition 节点算布尔表达式分流。复杂性来自组合，而不是某个万能节点——这是它和「一个大 prompt 解决一切」的根本区别。

节点顶部的色条按类别着色：青色是模型、绿色是检索、黄色是控制流。扫一眼画布就能看出这个工作流的结构重心。

概念二：连线是数据流

连线不是装饰，它声明「下游节点的输入来自上游节点的输出」。这个声明是强类型的事实：

• 编译器据此做环检测——循环依赖在保存时就被拒绝；
• 运行时据此决定执行顺序——没有连线关系的节点互不等待。

配合右侧检查器里的节点级校验（缺 URL 的 HTTP 节点、没选知识库的 RAG 节点都过不了保存），你连出来的图就是能跑的图。

概念三：层是并行的来源

保存时，编译器用 Kahn 算法变体把图编译成分层拓扑：

Layer 0: [start]                 串行
Layer 1: [llm·a, llm·b, http·c]  并行执行
Layer 2: [end]                   等待上层全部完成

同一层的节点没有数据依赖，运行时自动并行。你不需要（也不能）手动标注并发——并行度是从图结构里推导出来的，画对了图就拿到了并行。

把三个概念连起来

现在回看运行面板里的 SSE 事件流，一切都对上了：

event: node_started  llm·a      ← Layer 1 开始
event: node_started  llm·b      ← 同层，同时开始
event: delta         "..."      ← 流式输出逐字到达
event: node_completed llm·a     1,204 tok · $0.0031

节点开始/完成对应执行单元，事件顺序反映层结构，每个完成事件带着 token 与成本归因。

画布、引擎、可观测性说的是同一件事的三面：图即事实。想深入某一面，可以继续读执行引擎的设计。