MartinDelophy/ai-video-editor

AI Video Editing with Timeline Studio

ユーザーの正確な編集リクエストとメディアを、可逆的なTimeline Studio編集に変換します。編集可能なタイムラインを唯一の情報源として保持し、不透明なワンショットレンダリングで置き換えないでください。

実行パスの選択

1. インストール後の初回ローカル使用時は、references/host-environment.md を読んでください。もし Node.js が利用できない場合は、依存関係のないシェルまたはPowerShellのブートストラップから開始し、それ以外の場合は node scripts/setup-host.mjs --check を実行します。Agent駆動のナレーション前処理を行う前に、node scripts/setup-host.mjs --check --capability voiceover も実行してください。この機能は、明示的な承認があった場合のみ、MeloTTSとその言語リソースを別の環境にインストールします。結果を機能の証拠として扱ってください。言語ランタイムや依存関係が欠落している場合は、正確なインストール計画を提示し、インストールモードの前にユーザーの明示的な承認を得てください。スキルのインストールを、ホストの変更やモデルのダウンロードの許可と決してみなさないでください。
2. ローカルプロジェクトファイルの処理を、決定論的編集のデフォルトとして扱います。メディアをローカルで検査し、コマンドレイヤーまたはローカルアーカイブサービスを通じてポータブルな .timeline を変更し、ローカルでレンダリングし、ローカルでデコード出力を検証します。エディタにUIがあるからといって、単にブラウザを開かないでください。
3. https://video-editor.ai-creator.top/ は、ユーザーが明示的にウェブサイトの使用を希望した場合、ローカルリポジトリやプロジェクトパスを提供しなかった場合、またはホスト型のみの機能が必要な場合にのみ、正規のホスト型エディタとして扱ってください。
4. このリポジトリが利用可能な場合は、そのエージェントコマンドレイヤーとローカルメディアツールを優先してください。ローカルサーバーとブラウザを起動するのは、検証済みのUI専用操作であり、かつローカルプロジェクトパイプラインでは表現できず、ユーザーがローカルのみのワークフローを要求していない場合のみです。実際のサーバーURLはプロセス出力から読み取り、ポート5173を決して想定しないでください。
5. package.json でAgentコマンドスクリプトを確認してください。npm run ... --if-present を機能検出として使用しないでください。これは静かに成功する可能性があるためです。
6. コマンドランナーが存在する場合、references/command-contract.md を読み、プロジェクトを検査し、バージョン管理された計画を構築し、構造バリデーターを実行し、project.run の前に project.diff を信頼できるセマンティックドライランとして使用します。
7. 必要な操作がローカルコントラクトに欠けている場合は、正確なギャップを述べてください。リポジトリ開発作業の場合は、UIにフォールバックする前に、最小限の共有ローカル操作とレンダラーサポートを実装してください。それ以外の場合は、ブラウザワークフローに切り替える前に確認を取ってください。
8. UIオートメーションのみが利用可能だった場合に、決定論的または冪等性のある実行を主張しないでください。制限を明記し、UIがサポートする場合は編集可能なプロジェクトアーカイブを保持してください。

ワークフロー

1. 編集前の検査

• ユーザーのプロンプトを創造的なブリーフとしてそのまま保持します。
• 参照されているすべてのアセットを、明示的なパスまたはURLに解決します。承認なしにディレクトリをスイープしないでください。
• メディアの長さ、寸法、オーディオの有無、メディアタイプを検査します。
• 既存のプロジェクトを変更する前に、現在のプロジェクトサマリーを読みます。
• 未解決の選択が編集を実質的に変更する場合、例えば希望する出力期間やアスペクト比など、その場合にのみ質問します。
• 自動編集リクエストの場合、references/auto-edit-workflow.md を読んでください。最初に検査し、コンテンツ、目標、および明示的な信頼度レベルを指定して成果物を分類し、カットを変更できる最小限のカテゴリ固有の質問のみをしてください。メディアから発見できる事実については質問しないでください。
• 参照動画を複製、模倣、再作成、またはリバースエンジニアリングするリクエストの場合、references/replication-workflow.md を読んでください。editing-style replication、AI-generation replication、またはハイブリッドとして分類し、フィルター、リピート、ソース分割、スピードカーブ、トランジション、ショット、タイミングを構築する前に再構築し、許可されたオリジナルオーディオトラックを保持する必要があるかどうかを明示的に解決してください。複製分析の完全性ゲートが通過するまで編集を開始しないでください。生成が必要な場合にのみ、現在のウェブ検索を使用してAI動画プラットフォームを比較し、ユーザーが適切な素材を提供していない場合にのみ、合法的なウェブソースのフッテージを使用してください。
• メディア分析のためのモデルをロードまたはダウンロードする前に、references/local-model-routing.md を読んでください。リポジトリの既存のローカルおよび固定ミラーリングされた機能をインベントリし、証拠のギャップに必要な最小のモデルチェーンを選択し、可視のエディタUIを駆動せずにローカルで推論を実行し、正確なモデル/ランタイム/フォールバックの来歴を記録してください。デフォルトですべての利用可能なモデルをロードしたり、重複するキャッシュを作成したりしないでください。
• ユーザーがウェブソースのフッテージを必要とする場合、またはダウンロード可能な素材がどこにあるかを尋ねる場合、references/web-footage-sourcing.md を読んでください。現在のタスク固有のプラットフォーム提案をライブ検索から提供し、ソースの正当性、明示的なダウンロードサポート、使用権、視覚的な適合性、品質、来歴でランク付けしてください。スキルプロバイダーはニュートラルに保ち、単一のプラットフォームやブランドを恒久的なルートとしてハードコードしないでください。
• 完了した自動編集ごとに、references/professional-editing-workflow.md を読んでください。画像は直接分析し、動画は代表的なフレーム、音声/OCR、セマンティクス、およびグローバルおよびサブジェクト領域のオプティカルフローを使用して分析します。追跡や強調の前に安定化してください。生成が実質的に有用であることが検査で証明された後にのみ、画像から動画または画像から画像へのモデルについて質問してください。
• リモート生成が実質的に必要な場合、references/remote-video-generation.md を読んでください。現在の公式ドキュメントを検索し、ショットの設計図に適合するプロバイダーのみを比較し、有料またはプライバシーに関わるジョブの前に承認を得て、非同期タスクと来歴を正規化し、期限切れの出力バイトをダウンロードし、自動的なタイムライン配置なしで検証済みの結果を自分のアセットに追加します。
• 製品、ブランド、marketing-commerce、ウェブサイトプロモーション、またはその他のプロモーション編集については、references/promotion-narrative-workflow.md を読んでください。特長リストやキネティックタイポグラフィモンタージュではなく、野心的で証拠に基づいた包括的なナラティブを積極的に構築します。ユーザーが明示的にティーザーをリクエストしない限り、問題から変革、証明、CTAへの完全なアークを構築し、それぞれ独自のセットアップ、製品アクション、可視結果、最終的なペイオフへの接続を持つ、視覚的に異なる複数のケース（通常、35〜45秒のショートで少なくとも3つ）を積極的に見つけてください。ストーリーを大きく見せるために、顧客、結果、指標、または製品の動作を発明しないでください。
• 強調編集や、強調や劇的なインパクトが重要な参照複製については、references/highlight-tension-workflow.md を読んでください。顕著性を候補証拠として扱い、セットアップ/ライズ/プレインパクト/ピーク/アフターショックの役割を割り当て、平坦でない緊張のエンベロープを設計し、決定的なヒーローフレームを保護し、正確なカットにも支配的なペイオフが欠けている場合に完了を拒否します。
• ウェブサイトのウォークスルーやプロモーション録画の場合は、サポートされているブラウザ制御スキルを使用して、キャプチャ前に承認されたジャーニーを検査しリハーサルします。ブラウザアクションの前にそのブラウザスキルを完全に読み、その後 references/website-promo-workflow.md に従ってください。製品の結論を導き出す前に、ページ/フローカバレッジマニフェストを構築して完了させます。必要なページがゲートされている場合は、選択したブラウザでユーザー自身にサインインするように依頼してください。認証情報を決して要求したり、アクセスできない動作を検証済みとして説明したりしないでください。重要な外部アクションは別途確認し、サインインデータと個人データを保護し、スクリーンショットや静的アセットのみが利用可能だった場合に、実際の画面録画がキャプチャされたと主張しないでください。
• ナレーション付き編集については、references/voiceover-workflow.md を読んでください。インライン英語を含む中国語ナレーションにはMeloTTS ZH を使用し、合成前にその分離された環境と承認済みの固定モデルアーティファクトが準備できていることを確認します。ユーザーが別の配信をリクエストしない限り、利用可能な最も温かみのある自然なストーリーテラーのような所有音声を選択し、意味のあるフレージングで親密で会話的なパフォーマンスを指示します。決してフラットでメタリックな、または機械的なシステム音声効果をデフォルトにしないでください。最終的な自然音声パフォーマンスは、シーンの継続時間やモーションを確定する前にロックします。文章のタイミングとポーズに画像カットを駆動させます。おおよその継続時間はターゲット範囲として扱い、グローバルに音声をタイム圧縮する許可とはみなしません。正確な制限を自然に満たせない場合は、ナレーションを書き換えるか短縮します。

2. サポートされる忠実度での計画

• 自動編集の場合、プロンプトを保持し、推論、確認、デフォルト、未解決の決定を編集可能なブリーフに正規化します。タイムラインを変更する前に、保持/削除/短縮/並べ替えの決定、理由、信頼度、キャプションの期待、オーディオ連続性の制約、保護されたコンテンツを含むソースタイムの決定記録を構築します。
• 説明用の製品、チュートリアル、またはウェブサイトのビートについては、指定された単一のターゲットに対して明示的な注目処理を選択します。小さなまたは密度の高い証拠を拡大する、正確なテキストまたは数字に下線を引く、またはコントロール、カード、結果の正確な境界をフレームに収めます。カメラ移動を伴うサポート処理は最大1つまで使用し、下線またはフレームはカメラが停止した後にのみ適用します。
• コマンドランナーを使用して、編集を安定したID、秒、リビジョン、操作ID、前提条件を持つ宣言型操作として表現します。scripts/validate_edit_plan.mjs <plan.json> を実行してトランスポート形状のエラーをチェックし、次に npm run agent -- project.diff <plan.json> を実行して、サポートされていない操作や無効なプロジェクト固有の編集を適用前に拒否します。
• ブラウザUIのみを使用する場合は、可視のユーザーインテントと期待されるUI結果の短い順序付きチェックリストを記述します。名前付きコントロールとクリップラベルを優先し、現在のスクリーンショットに基づく最後の手段としてのみ座標を使用します。
• メインのビジュアルは連続的に保ちます。キャプション、ステッカー、ソースオーディオ、ナレーション、音楽、オーバーレイをタイムドクリップとして扱います。
• 一方向のキャプション対音声ルールを適用します。プロジェクトがキャプションを設定または有効にしている場合、すべての可視キャプションは可聴音声に対応している必要があります。文字起こしキャプションを既存の話されているソースクリップにリンクし、新しいナレーション、説明、プロモーション、またはテキスト主導のキャプションごとにナレーションを生成します。既存のソース音声はこのルールを満たしており、重複するナレーションを受け取ってはなりません。キャプションが設定されていない場合、ナレーションはオプションのままであり、ブリーフ、コンテンツ、編集目標に従います。設定されたキャプションに許可された音声ルートがない場合は、それを省略するか、編集可能なプロジェクトを保持して停止します。
• 文スコープのナレーション付き編集の場合、ナレーションを物理的に分離されたアーカイブオーディオファイルに分割し、各キャプションを正確に1つの一致する audioClipId にバインドします。編集可能な文クリップを1つのモノリシックナレーションファイル上の範囲として表現しないでください。
• クリップを移動またはトリミングする際は、メディアの同一性とソースタイムマッピングを保持します。

3. 安全に適用

• 破壊的なバッチの前にプロジェクトバージョンを保存するか、.timeline アーカイブをエクスポートします。
• ユーザーから見えるインテントごとに1つのトランザクションを適用します。前提条件が失敗した場合は、トランザクション全体を失敗させます。
• 欠落しているメディア、音声、モデル、フォント、エフェクトを静かに代用しないでください。
• すべての結果を元に戻し可能で、通常のUIで編集可能に保ちます。
• 明確なユーザーリクエストなしに、有料またはリモート生成ジョブを開始しないでください。
• output.render をコマンド計画に入れたり、project.run が動画をレンダリングすると主張したりしないでください。文書化されたポータブルサブセットには別のバージョン管理された project.render リクエストを使用し、AI生成またはサポートされていない合成機能にはブラウザエディタを使用します。
• 完了した動画編集リクエストについては、明示的な絶対出力ディレクトリを解決し、そこにポータブルな .timeline プロジェクトとレンダリングされた結果動画の両方を作成します。計画、診断、および明示的なエディタのみのハンドオフのみが例外です。1つのアーティファクトのみで完了を報告しないでください。

4. 結果の検証

• タイムラインのサマリーを再読み込みし、要求された期間、順序、トラック配置、有効状態と比較します。
• オープニング、すべてのカットまたはトランジション、キャプションの境界、オーバーレイ、および最終フレームをプレビューします。
• すべてのビジュアル、キャプション、オーディオの境界にわたってタイムラインを連続的に再生します。タイムラインクロックは単調に進む必要があり、停滞、後方ジャンプ、クリップテールの繰り返し、または隣接する半開きクリップの両方を同時にアクティブにする境界は拒否します。
• 可視のトラックだけでなく、可聴動作を確認します。埋め込み動画オーディオと明示的に分離されたソースオーディオクリップを区別し、ミュート/リンク状態を検証します。
• FFmpegでステレオまたはマルチチャンネルオーディオを配置する場合、意図したすべてのオフセットをすべてのチャンネルに明示的に適用します。adelay には adelay=<milliseconds>:all=1 を使用するか、チャンネルごとに1つの遅延値を指定します。デフォルトの all=false を持つ単一の値は最初のチャンネルのみを遅延させ、後続のすべてのクリップを時間ゼロで他のチャンネルに積み重ねる可能性があります。配信前に、オープニングウィンドウと予定されたすべての音声境界付近で左右のアクティビティを比較します。チャンネル専用の早期音声、オープニングに積み重ねられた複数のナレーションクリップ、または文書化されていないチャンネル間のオンセットスキューを拒否します。
• すべての可視キャプションが、その完全なアクティブインターバルに対して1つの可聴音声クリップに解決されることを確認します。孤立したキャプション、リンクされたサイレントクリップ、音声を超えて拡張するキャプション、重複するソース音声とナレーション、またはテキストのみのキャプション配信を拒否します。
• 通常の再生速度で完全なナレーションを聴きます。冷たくまたは機械的な音色、平坦なピッチとエネルギー、合成された単語ごとの配信、固く均等なポーズ、急いだリズム、クリップされたポーズ、不自然な発音、文レベルでの速度変更、説明できないラウドネスのジャンプ、または単にターゲット期間に達するためにグローバルに加速されたナレーションを拒否します。温かみのある人間らしいストーリーテリングのパフォーマンスを要求します。