export

エクスポート

ユーザーからレンダリング、ダウンロード、または最終的な単独の成果物を求められた場合にのみエクスポートします。レビューのチェックポイントは通常、編集可能な ChatCut のタイムラインのままにします。自分の作業を確認するには、映像には preview_timeline を使用し、音声を聴くには format:"audio" でエクスポートします。自己確認のためにフル解像度でエクスポートしないでください（verification を参照）。

現在のツールスキーマで submit_export を使用します。プロジェクトの状態とユーザーの意図から、対象のタイムライン、範囲、解像度、コーデック、形式を確認します。アクティブでないタイムラインを推測して指定しないでください。エクスポートごとに、短く特徴的な name を付けます。返された renderId と expectedFilename をすべて記録します。

動画と音声はデフォルトでローカルにレンダリングされます。renderMode は省略し、接続された ChatCut エディターのタブでユーザーのデバイス上のタイムラインをレンダリングします。プラグインの基本スキルに記載されたブラウザーハンドオフからプロジェクトを開き、要求されたタイムラインをアクティブにして、配信が完了するまでそのタブを開いたままにします。対応可能なエディターが接続されていない場合は、報告されたブラウザーまたはタイムラインの問題を解決して、ローカルで再試行します。クラウドでの自動再試行はありません。エディターがすでに読み込めるメディアは、ローカルエクスポートのためにアップロードする必要はありません。

ブラウザーおよびクラウドのエクスポート状況の確認には track_export を使用します。生成／文字起こし用の track_progress は使用しないでください。返された renderId を渡すか、最新のプロジェクトエクスポートには最新レンダーのオプションを使用します。wait の呼び出しはステータスを一度読み取るだけです。再確認の間隔を守ってください。送信がタイムアウトした場合や、確認応答が不確かな場合は、再送信する前に最新のエクスポートを確認し、同じエクスポートが二重に開始されないようにしてください。

配信

完了したブラウザーエクスポート（source:"browser"）にはdownloadUrlがありません。レンダリングタブから、そのブラウザーのダウンロードにファイルが渡されます。完了していてもファイルが保存されたとは限らないため、見つけてから配信してください。

1. ユーザーのダウンロードフォルダー（通常は~/Downloads）でexpectedFilenameを探します。拡張子の前に (1)などのブラウザーが付けたサフィックスがある場合も考慮してください。expectedFilenameがない場合は、完了したtrack_exportエントリーのname（送信時の名前に.mp4、.webm、または.mp3を付けたもの）を探し、送信後に更新された最新の一致ファイルを選びます。その名前だけを検索してください。ほかのファイルを一覧表示したり、読み取ったりしないでください。ユーザーのコンピューター上のファイルを読み取れない場合は、ファイル名をユーザーに伝えてください。
2. 見つかった場合：パスと簡潔なレンダリングメタデータをユーザーに伝えます。Claude Codeでは、ローカルファイルのプレビューリンクも提供してください。Codexでは、通常のファイル配信方法でローカルファイルを表示してください。ユーザーが特定のフォルダーを指定した場合は、そこにファイルをコピーしてください。
3. 見つからない場合：結果にdeliveryGuidanceがある場合はそれに従い、レンダリングに使用したブラウザーに応じた手順を1つだけユーザーに依頼してから、もう一度探します。
   • Chrome：「アドレスバーのプロンプトで「複数のファイルのダウンロード」を許可してください（1回だけで、その後もサイトの許可は維持されます）。次に、エディターのエクスポートキューでもう一度ダウンロードをクリックしてください。
   • ClaudeデスクトップのBrowserペインまたはWorkBuddy：保存ダイアログで保存をクリックしてください。保存先はデフォルトで「ダウンロード」です。
   • Codexのアプリ内ブラウザー：エディターのエクスポートキューでもう一度ダウンロードをクリックしてください。
   • それ以外の場合：ブラウザーがファイルを保存した場所を尋ねてください。

ダウンロードフォルダーを読み取るのにユーザーの承認（macOSのプライバシープロンプトまたはホストのアクセス許可プロンプト）が必要な場合は、エクスポートファイルを探していることを伝えてください。ステータスに、ユーザーが指定したファイルにエクスポートが書き込まれたと表示されている場合は、そのファイルを配信してください。クラウドに切り替えてこれらの手順を省略してはいけません。また、リンクの取得や作業の確認だけを目的にクラウドを使ってはいけません。

ユーザーがローカルでの手順（エディターを開く、または上記のダウンロード手順）を実行できないと言った場合、または試しても失敗した場合は、ローカルでの障害を1文で説明し、クラウドでエクスポートするかどうかを尋ねてください。ユーザーの同意後にrenderMode:"cloud"でエクスポートし、そのdownloadUrlを配信します。ユーザーがその機会を得る前にクラウドを提案してはいけません。クラウドでも実行できない場合（たとえば4K、ユーザーのコンピューター上にしかなくアップロードできないメディア、またはクラウドレンダリングの拒否や失敗）に限り、ChatCut Desktopはユーザーのコンピューター上でレンダリングすることを伝えてください。起動するとDesktopはCodex、Claude Code、WorkBuddyに自動接続します。Codexでは、ChatCut Desktopプラグインのconnect-chatcut-desktopスキルでインストールできます。

downloadUrlを含む完了結果（クラウドの動画／音声、字幕、XML）は、ホストの通常のファイル／リンク配信方法で配信してください。ユーザーが特定のローカルパスを指定した場合は、そこにダウンロードしてください。Claude Codeでは、そのパスまたはファイル名が重複しないローカルパスにダウンロードし、パスとローカルファイルのプレビューリンクを提供してください。

キューに入っているエクスポートや実行中のエクスポートは配信しないでください。警告があれば、その出力への影響とともに報告してください。

その他の形式

字幕とNLE XMLのエクスポートには対応するsubmit_export形式を使用します。URL／パスを伴って同期的に完了する場合があります。サポートされていない要素や除外された要素に関する警告を報告してください。アーカイブはエディターのバンドルパイプラインで処理され、renderIdが返されない場合があります。その場合は、track_exportに対応していると約束せず、エディターで進行状況を確認してください。透明なモーショングラフィックを配信する場合は、現在のマニフェストで公開されている専用のMGエクスポートツールを使用し、返されたレンダーIDを追跡してください。

クラウドレンダリング

renderMode:"cloud"は、ユーザーから依頼された場合、または上記の手順を試した後にユーザーが同意した場合に限り使用してください。リモートから読み取れないメディアが原因でクラウドレンダリングがブロックされた場合は、ユーザーがアップロードを許可すればasset-importを使用し、許可されなければ障害を報告してください。ユーザーの意図を確認せずに、ローカルで編集をフラット化したり、別のものに置き換えたりしてはいけません。