素材（Materials）

TongFlow にアップロードするすべてのファイル ——画像、動画、音声、ドキュメント、3D モデル ——は 素材 です。素材はスタジオを動かしているマシンにローカルで保存され、Portfolio ダイアログを介してワークフロー間で再利用できます。

素材ライブラリの場所

ワークスペース左上の 左サイドバー を開きます。3 番目のアイコン FolderOpen で Portfolio ダイアログ が開きます ——これが素材ライブラリです。

[Workflow]  [Tasks (⚡)]  [Portfolio (📁)]   ← 3 つのボタン、左から右へ

Portfolio ダイアログは Smart Island 上にはありません。Smart Island はノードの追加と実行を、Portfolio はファイルライブラリを担当します。

アップロードできるもの

素材タイプ主な対応フォーマット
画像JPEG、PNG、WebP、GIF（静止）、HEIC
音声MP3、WAV、M4A、AAC、FLAC、OGG
動画MP4、MOV、WebM、MKV
ドキュメントPDF、DOCX、TXT、MD など、テキスト抽出可能なフォーマット
3D モデルGLB、GLTF（およびビューアが対応する他のフォーマット）

正確な対応リストは Add ノードのファイルピッカーから来ます ——Add ノード内のファイル選択ダイアログのタイプフィルターで、現在対応中のリストを確認できます。

ファイルの保存方法

  • ファイルはローカルディスクの data/uploads/ に保存
  • メタデータ（ファイル名、サイズ、モダリティ、MIME タイプ）は data/tongflow.db の materials テーブル
  • 中央 CDN はありません。後で CDN 経由で素材を配信したい場合、.env の NEXT_PUBLIC_FILE_BASE_URL を CDN に向けます

素材の追加

2 つの方法：

Add ノードの内部から（一般的）

  1. Smart Island から対応アイコン（例えば Image）をクリックして Add ノードを配置
  2. ノード内にインラインピッカーが表示されます ——クリックしてファイルを選択、アップロード完了
  3. 素材はこのノードに紐づくと同時に Portfolio にも登録され、後で再利用できます

音声 / 動画ノードはファイル選択に加えて、カメラ / マイク録画も提供します。

Portfolio ダイアログから

  1. Portfolio を開く（左サイドバー FolderOpen）
  2. Upload をクリックして 1 つ以上のファイルを選択
  3. 素材は登録されますが、まだ特定のノードに紐づいていません ——後でキャンバスにドラッグできます

ワークフローを跨いだ再利用

素材はインストール全体でグローバルで、ワークフローローカルではありません。再利用方法：

  1. Portfolio ダイアログを開く
  2. 素材を見つける（必要に応じてモダリティで絞り込み）
  3. Portfolio からキャンバスにドラッグ、または Add ノードのピッカーで「Portfolio から選択」

素材ファイル自体は重複しません ——新しいノードは同じファイルを参照します。

素材の削除

Portfolio ダイアログで素材にホバーして削除をクリック。data/uploads/ からファイルが削除され、データベースの行が落とされます。それを参照していたノードはリンク切れ状態を表示し、再バインドが必要になります。

変換時の素材の扱い

変換が Modal で実行されるとき、素材はタスクごとに 1 回 Modal にアップロードされ、そこで処理されます。出力はあなたのマシンに戻り、data/uploads/ に保存されます。Modal がファイルをどう保持するかは、彼らの保持ポリシーに従います。

関連