素材（Materials）

你上传到 TongFlow 的每个文件——图像、视频、音频、文档、3D 模型——都是一个素材。素材保存在跑工作室的本地机器上，可以从 Portfolio 对话框跨工作流复用。

素材库在哪里

打开左侧栏（工作区左上角）。第三个图标 FolderOpen 打开 Portfolio 对话框——这就是素材库。

[Workflow]  [Tasks (⚡)]  [Portfolio (📁)]   ← 三个按钮从左到右

Portfolio 对话框不在智能岛上。智能岛负责”加节点”和”运行”，Portfolio 负责”文件库”。

能上传什么

素材类型一般支持的格式
图像JPEG、PNG、WebP、GIF（静态）、HEIC
音频MP3、WAV、M4A、AAC、FLAC、OGG
视频MP4、MOV、WebM、MKV
文档PDF、DOCX、TXT、MD 等可提取文本的格式
3D 模型GLB、GLTF（以及你的查看器支持的其他格式）

具体可接受清单来自每个 Add 节点的文件拾取器——查看节点内的文件选择对话框的类型过滤可以知道当前支持的清单。

文件怎么存

  • 文件存在本地磁盘 data/uploads/
  • 元数据（文件名、大小、模态、MIME 类型）在 data/tongflow.db 的素材表
  • 没有中央 CDN。如果以后想把素材走 CDN，把 .env 里 NEXT_PUBLIC_FILE_BASE_URL 指向 CDN

添加素材

两种方式：

在 Add 节点内部（最常用）

  1. 从智能岛点对应图标（比如 Image）放一个 Add 节点
  2. 节点内部渲染一个就地拾取器——点击、选文件、上传完成
  3. 该素材既绑定到这个节点，也注册到 Portfolio 供之后复用

音频/视频节点除了文件拾取还提供摄像头/麦克风录制。

从 Portfolio 对话框

  1. 打开 Portfolio（左侧栏 FolderOpen）
  2. 点 上传 选一个或多个文件
  3. 素材登记完成，但还没绑到任何节点——之后可以拖到画布上

跨工作流复用

素材是安装级全局的，不是工作流级的。复用方法：

  1. 打开 Portfolio 对话框
  2. 找到目标素材（可按模态过滤）
  3. 从 Portfolio 拖到画布，或 在 Add 节点拾取器里选”从 Portfolio 选”

素材文件本身不重复——新节点引用同一个文件。

删除素材

Portfolio 对话框里悬停在素材上点删除。data/uploads/ 里的文件被移除，数据库行被丢掉。任何之前引用它的节点会显示”链接失效”状态，需要重新绑定。

TongFlow 在转换中怎么处理素材

转换任务跑到 Modal 上时，每次任务把素材上传一次过去处理。输出回到你的机器，落回 data/uploads/。Modal 对你文件的保留行为受他们自己的保留策略约束。

相关

  • 智能岛 —— 加节点，不是素材存放处
  • 节点类型 —— 哪些转换接受哪类素材
  • 快速开始 —— 含 NEXT_PUBLIC_FILE_BASE_URL 等环境变量