必须将文件字段命名为uploaded_file，通过手动配置输入映射和显式声明输出字段（如parsed_text、file_metadata）实现跨节点引用，且避免使用保留字file/files作为输出名。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中构建一个既能接收用户上传的文件、又能让工作流中不同节点彼此引用处理结果的自动化流程，必须绕过默认的单节点文件处理限制，通过手动配置节点输入和输出字段实现跨节点传递。
准备支持文件上传的触发节点
进入工作流画布，点击左上角「+ 添加节点」→ 选择「开始节点」→ 在右侧配置面板中，将「触发方式」设为「表单触发」。
在「表单字段」区域点击「添加字段」→ 类型选「文件」→ 字段名称填“uploaded_file”→ 勾选「允许多文件上传」（如需支持多个附件）→ 保存设置。
这一步是整个流程的入口前提，【文件字段必须命名为 uploaded_file，后续节点将依赖此精确字段名读取】。命名错误会导致下游节点无法获取文件对象。
配置文件解析节点并暴露输出字段
从「开始节点」拖出连线，接入「代码节点」或「知识库检索节点」（若需OCR/文本提取）→ 点击该节点，在右侧「输入」区域手动添加一条输入映射：Key 填 “file”，Value 填 `{{start.uploaded_file}}`。
如果是代码节点，编写Python逻辑读取 `file` 参数（它实际是包含 url、name、size 等属性的字典），调用 `requests.get(file['url'])` 下载内容，再做PDF解析或图像识别等操作。
关键一步：在该节点的「输出」配置区，点击「添加输出字段」→ 字段名设为 `parsed_text` → 值填 `{{code.output.text}}`（假设代码节点返回了text键）→ 再添加一个输出字段 `file_metadata` → 值填 `{{code.output.metadata}}`。
输出字段名必须显式声明，否则其他节点无法通过 `{{parse_node.parsed_text}}` 这类语法引用——Dify不会自动透出代码节点的任意返回值。
实现跨节点引用：让第三个节点调用前序结果
第一步：从解析节点拉出连线，接上一个新的「大模型节点」。
第二步：在该大模型节点的「提示词」编辑框中，直接插入变量引用：比如写“请基于以下材料回答问题：{{parse_node.parsed_text}}。原始文件名是{{parse_node.file_metadata.filename}}。”
第三步：检查右侧「输入」区域，确认没有手动覆盖 `parse_node.parsed_text` 的映射——如果这里误写了 `input_text: {{start.uploaded_file}}`，会覆盖掉你真正想用的解析后文本。
第四步：运行测试时，上传一个含表格的PDF，观察大模型节点是否收到结构化文本而非二进制乱码——若收到的是URL字符串而非解析后文字，说明代码节点未正确返回 `text` 字段或输出映射名不匹配。
补充：让同一份文件被多个分支同时消费
方法一：从「开始节点」直接拉出多条线，分别连到「代码节点A」和「代码节点B」，两个节点都配置 `file: {{start.uploaded_file}}` 作为输入。这样两个分支各自独立处理原始文件，互不干扰。
方法二：若需先统一预处理再分发，可在第一个代码节点完成基础解析后，在其「输出」中新增字段 `raw_content`，值为 `{{code.output.content}}`；后续所有分支节点均引用 `{{preprocess_node.raw_content}}`，避免重复下载和解析。
注意：Dify不允许节点输出字段名为 `file` 或 `files`，这类保留字会导致引用失败，改用 `uploaded_doc` 或 `source_blob` 等自定义名更安全。
