素材（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 指过去即可

添加素材

两种方式：

在 Add 节点里加（最常用）

  1. 从智能岛点对应图标（比如 Image），落一个 Add 节点
  2. 节点里自带一个就地拾取器——点击、选文件，上传完成
  3. 这个素材既绑定到当前节点，也登记进 Portfolio，之后可以复用

音频/视频节点除了选文件，还支持摄像头/麦克风录制。

从 Portfolio 对话框加

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

跨工作流复用

素材属于整个安装，不局限于某个工作流。复用方法：

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

磁盘上不会复制文件——新节点引用的是同一份。

删除素材

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

转换过程中素材怎么流转

转换任务跑在 Modal 上时，素材每个任务上传一次，在那边处理。输出回传到你的机器，落回 data/uploads/。Modal 对你文件的留存，以其自身的保留策略为准。

相关