tesseract-video

Tesseractで動画を編集する

Premiere ProやAfter Effectsなど、ほかの編集ツールとの間でファイルを変換する方法については、変換をお読みください。共有された古い .tsrct ファイルを開くとき、ツールを更新するとき、または読み込みやレンダリングの違いを調べるときは、バージョンと互換性をお読みください。

CLI は、一部のコマンドについて基本的な使用状況のテレメトリーを送信する場合があります。TESSERACT_SKILL=tesseract-video とその他のアトリビューション用変数を使用して、任意でアトリビューションを設定できます。CLI のテレメトリー拒否設定を尊重し、ユーザーに代わってテレメトリーを有効にしないでください。

ユーザーの素材を基に、意図を持って編集してください。Tesseract はローカルで編集とレンダリングを行うエンジンであり、エージェントは編集上の判断を担います。成果物には、再生可能な動画と編集可能なプロジェクトの両方が含まれます。

素材を確認する

1. この SKILL.md があるディレクトリを起点に、このスキルのルートを特定します。CLI のインストールを読み、セッションごとに一度、必要な Tesseract のバージョンを確認します。タスク全体を通して、特定した実行ファイルのパスを使用してください。スクリプトと参照ファイルの場所は、インストール済みのスキルを基準とし、推測したホームディレクトリや開発用チェックアウトを基準にしないでください。
2. ローカルでの操作を読みます。提供されたメディアを調べ、重要な箇所のフレームをサンプリングし、ホストで利用できるメディアツールを使って音声を聴きます。メタデータだけではショットの内容は分かりません。音声を試聴できない場合は、全体を確認したと主張せず、その制約を明示してください。
3. 依頼内容から、成果物、対象者、アスペクト比、尺、必ず残す場面、提供されたブランド素材を確認します。編集に重大な影響を与える情報が不足している場合に限り、質問してください。小規模な修正では、既存の編集のスタイルと範囲を維持します。
4. 新規編集を計画する前に、編集上の判断を読みます。各ビートについて、映像素材、グラフィック付き映像素材、フルグラフィックのどれにするか、その理由とともに決めます。これは割り当ての目標ではありません。エンジンの機能を示すだけのためにモーショングラフィックスを追加しないでください。

新しい広告を制作する場合、または広告の冒頭を改訂する場合は、広告のフックをお読みください。実際の映像素材、訴求内容、根拠に基づき、冒頭数秒で視覚的なフックを作ります。異なるコンセプトを検討し、最も効果的なものを選び、その見せ方や動き、意図的な効果音を、音楽が提供されている場合は確認済みの冒頭の音楽キューに合わせて構成します。残りを仕上げる前に、フックと広告本編へのつなぎをレンダリングして確認してください。関係のない改訂の範囲は維持します。

音楽に合わせてテンポを決める場合や、話している映像をトリミングする場合は、波形を使った編集をお読みください。映像のタイミングを計画する前に、音楽の波形を生成して開きます。音楽を聴いてビート、フレーズ、大きな変化を確認し、映像の切り替わりをそれらに合わせます。音声については、概要波形と拡大した素材波形を使ってポーズを詰める箇所を選び、静かな語尾や語頭を切らないようにし、自然な呼吸を残します。波形上のマーカーは候補であり、自動的にカットを決めるものではありません。

大規模な新規動画では、素材の使用箇所、物語上の役割、グラフィックの扱い、音声の意図を含めた簡潔な編集計画を共有します。通常の許可済み編集はそのまま進めてかまいません。プレビューや個々の修正のたびに、新たな承認を求める必要はありません。

編集を作成する

• 新規編集：tsrct project createで、ポータブルな.tsrctドキュメントを作成します。レイヤーを配置する前に、ローカルの映像素材をインポートしてください。既存の.tsrctの場合は、編集可能なJSONを確認し、そのコピーをチェックアウトします。元のファイルと安定したIDを保持してください。レンダリングの前に、project commitでJSONを保存するか、project applyでサポートされているアクションバッチを適用します。
• プロジェクトの構造を変更する前に、ネイティブ編集をお読みください。ソース時間、編集時間、レイヤー時間はそれぞれ異なる時間軸です。特に、クリップを移動しても、再生されるソース内の場面が意図せず変わらないようにしてください。
• 映像のカット、シーン全体、編集可能なオーバーレイは、ドキュメント内の単一コンポジションにネイティブレイヤーとして保持してください。シーンにはグループを使用します。activeRangeはクリップを親に配置し、sourceRangeはソース内の場面を選択します。ベース映像、キャプション、オーディオのトラックは作成しないでください。
• トーキングヘッドのカットでは、アイラインの連続性に従ってください。パンチインを含め、適切なフレーミングで、カットをまたいで話者の目の高さと画面上の位置を揃えます。自然な頭の動きと意図的なカメラ変更を保ちながら、レンダリングしたカット前後のフレームと再生を確認してください。
• モーション作業では、モーションデザインを読み、その後、関連するオーサリングリファレンスだけを読んでください。例は実際のスキーマを示すものであり、そのビジュアルスタイルを必須のテンプレートとしているわけではありません。
• 新しい編集やサウンドの作業を行う際は、毎回サウンドデザインを読んでください。ダイアログ、音楽、マイクロSFX、構成上の合図、フォーリー／環境音を検討し、作品に必要な役割のサウンドを使用します。個々のキューごとの承認を求めず、提供された素材やローカル素材、またはプロシージャルヘルパーから適切なサウンドを追加してください。選択したファイルはproject import-asset --kind audioでインポートし、編集可能なAudioレイヤーとして保持します。配置、ダッキング、ローカルでの準備、測定にはオーディオとタイミングを使用してください。有用なソース音声と選択した音楽は保持します。音声やキャプションを捏造しないでください。
• 映像にカラー補正、ルック、ログ変換、ショットマッチングが必要な場合、またはユーザーからカラーについて尋ねられた場合は、カラーグレーディングをお読みください。ベイク済みの編集で必要な場合はショット単位の制御を含め、シーンを考慮したワークフローに従ってください。別途依頼されなくてもショット間の一貫性を保ちますが、意図的な照明の違いは残してください。ソースを基準にしたニュートラルと肌のチェックに従い、前に作成したグレーディング済みプレビューではなく、元のソースと最終出力の対応するタイムスタンプから、中央値のLab領域を使用してください。補正はネイティブかつ編集可能な状態に保ち、ルック適用時も肌を自然に保ち、強調したプレビューでセカンダリー選択を確認します（CLIにマットプレビューの切り替え機能はありません）。空間的なnoiseReductionは1つだけ使用し、エッジの保持を確認してください。ノイズリダクションを参照してください。デフォルトのドキュメントでは、HDR出力にしてもグレーディングがHDR領域で処理されるわけではありません。フィルムライクなハイライト、光のようなコンポジット、ベンダーLUTを使わないカメラログ、またはSDRとHDRの両方に対応する単一のグレードが必要な場合は、そのリファレンスのACESの節を使用してください。トラッキングや自動マッチングを約束する前に、同リファレンスの「制限事項」を確認してください。
• 音声のクリーンアップが必要な場合は、音声クリーンアップをお読みください。部屋のノイズとリバーブ／エコーを見分け、必要に応じて控えめなEQ／ダイナミクス処理、またはローカルノイズリダクションを使用し、音量を揃えて比較してください。声のディテールとタイミングを保ってください。このプラグインには、バンドルされた残響除去モデルはありません。
• タイポグラフィ、グラフィック、映像、オーディオは、ネイティブかつ編集可能な状態に保ってください。提供された画像はproject import-asset --kind imageでアセットとしてインポートし、テキスト、ベクターグラフィック、シーン全体を平坦化したものに置き換えないでください。既存の映像素材を使用してください。このプラグインには、生成動画やアバターのサービスはありません。
• ユーザーが提示したブランドのリファレンスを尊重してください。Mirageのブランディングはこのプラグインを示すものであり、このプラグインで作成されるすべての動画を示すものではありません。

必要な場合にのみ機能を確認する

ローカル操作を使用して、インストール済み CLI のスキーマを参照してください。

機能の一覧と制限については機能、ネイティブレイヤーとフッテージについてはFX の作成、サポートされているキーフレームとスクリプトの操作についてはモーションを確認してください。スキーマ全体を出力するのではなく、必要な定義を検索してください。アクションスキーマには、サポートされている単独の操作とそのフィールド制限が含まれています。ローカル操作を使用して、アクションと JSON のチェックアウト／コミットのどちらを選ぶか判断してください。インストール済みのスキーマと実際のレンダリング結果を優先してください。

レビューと引き渡し

映像の変更を確認して修正するには、フィルムストリップレビューを使用してください。会話のカットや音楽のタイミングについては、波形編集に従ってください。レビューと納品を完了し、実施したチェックと制限事項を報告してください。最終書き出し時の映像チェックに従い、カットやフェードから離れた複数の書き出し時刻を確認してソースと比較し、説明のつかない黒画面があれば納品を保留してください。絶対パスのローカルファイルリンクを使用し、対応している場合は動画をインラインで表示してください。クラウド同期と公開には対応していません。

ホストでローカルコマンドを実行できない場合、またはローカル GPU／ファイルシステムにアクセスできない場合は、このパッケージにローカル実行環境が必要であることを説明してください。ホスト型サービスで代用したり、レンダリングエンジンを暗黙に切り替えたりしないでください。