🔗 工作流变量与数据引用

变量与数据引用是工作流各节点之间传递信息的桥梁。掌握 ${} 引用语法，才能把上游节点的输出灵活地组装到下游节点中。

基本引用语法：${节点标题.字段名}

节点之间通过 ${节点标题.字段名} 语法引用上游节点的输出字段：

${变量设置.Text}       引用「变量设置」节点的 Text 字段
${JS执行器.Value}      引用「JS执行器」节点的 Value 字段
${大模型.回复}          引用「大模型」节点的输出文本

引用时请确保：

• 节点标题唯一且稳定：重命名节点后，原有引用需要同步更新
• 被引用节点在上游：只能引用执行顺序在前的节点输出
• 字段名与节点输出一致：可点击节点查看其实际输出字段

变量设置节点：${变量名}

「变量设置」节点用于定义流程中反复使用的静态或动态变量。在其他节点中通过 ${变量名} 直接引用：

变量设置：变量名 = Model，值 = musetalk
下游节点：视频模型字段填 ${Model}

把模型名、分辨率、输出目录等公共参数收敛到变量设置节点，后续修改只需改一处。

原始 JSON 引用：@RAW()

当需要拿到上游节点输出的完整 JSON（而不是某个具体字段）时，可使用 @RAW() 语法：

• @RAW(节点标题) 返回该节点输出的原始 JSON 结构
• 适合在 JS 执行器中做整体解析、遍历列表字段
• 与 ${} 单字段引用互为补充：取整块用 @RAW()，取具体值用 ${}

JS 执行器中的引用与映射

JS 执行器节点支持输入输出字段映射，可以在代码中接收上游变量、返回处理结果：

1. 在输入映射中把上游字段映射为代码内的变量
2. 在脚本中处理数据（字符串拼接、数组遍历、JSON 解析等）
3. 将结果作为输出字段返回，供下游节点以 ${JS执行器.字段} 引用

引用使用建议

• 先看后引：点击节点查看其输入/输出数据面板，确认字段名再引用
• 变量集中管理：把多节点复用的值放进「变量设置」节点，避免散落各处
• 逐步调试：先只连两三个节点跑通，再逐步扩展链路
• 注意转义：在文本中输出字面量 ${} 字符时需注意转义，避免被误解析

本章相关文档

• 工作流调试与排错 — 变量取不到值时如何排查
• 工作流使用说明 — 工作流基础入门
• 工作流实战案例 — 变量引用的完整示例