vosjs/vos-migrate

録画済みデモを編集可能なテイクに移行する

あなたは完成したビデオファイルをvossoテイクに変換しています。これは、ズーム、トリム、速度、レイヤーがデータとして保存され、バージョン履歴で管理され、スタジオで編集可能なドキュメントです。このファイルが外部から来たことで失われるものは、あなたが責任を持たなければならない正直さです。カーソルトラックがないため、自動ズームはできず、ダイジェストはほとんど情報を得られません。あなたの目がコンタクトシートであり、すべてのズームは目視で配置されます。

2つの方法があります：

• 人間向けの方法: https://vos.so/studio にファイルをドロップすると、ブラウザレコーダー形式で取り込まれ、テイクエディタで直接開きます。人間がいる場合、これが最短ルートです。リンクを渡してください。
• エージェント向けの方法（このスキル）: テイクディレクトリを自分で構築し、通常のパイプラインを実行します。以下にエンドツーエンドの実績のある手順を示します。

1. ソースを調査する

ffprobe -v quiet -print_format json -show_streams -show_format demo.mp4

幅、高さ、長さ、fps、オーディオストリームの有無を保持します。Loom/Screen Studioのエクスポートは通常、1080p H.264で、カメラバブルと編集がベイクインされています。これらはピクセルとして移行され、レイヤーとしては移行されません。引き継ぎ時にその旨を伝えてください。移行によりファイルはここから編集可能になりますが、古い編集が元に戻るわけではありません。

2. テイクディレクトリを構築する

mkdir take
ffmpeg -i demo.mp4 -c:v libvpx-vp9 -crf 34 -b:v 0 -row-mt 1 \
       -c:a libopus take/recording.webm     # オーディオストリームがない場合は -c:a を削除

次に、プローブ結果から take/meta.json を記述します（すべてのフィールド必須、時間はミリ秒、producer: "migrated" で起源を示します）：

{
  "producer": "migrated",
  "dpr": 1, "zoom": 1,
  "t0": 0,
  "durationMs": 36766,
  "width": 1920, "height": 1080,
  "fps": 30,
  "hasAudio": false
}

t0 は任意のエポックミリ秒で構いません。width/height はビデオのピクセル値です（ブラウザのビューポートはありません）。hasAudio は、webmが実際にオーディオトラックを含む場合にのみ true に設定します。

3. 計画を立て、正直に確認する

vos plan take --fresh       # doc.jsonを構築; cursorKeptはfalse、zoomAutoは0
vos frames take --times 0,10%,25%,50%,75%,90%,100%   # コンタクトシートがあなたの目です
vos digest take             # 実行しますが、ほとんど期待しないでください: 頭と尻尾、そして
                            # ハードシーンカットのみ - クリック、タイピング、滞留はありません

自動ズームは不可能であり、偽装してはいけません。静止画を読み取り、重要な2〜4の瞬間を見つけ、目視で手動スパンを記述します：

# doc.json - 追加するすべてのスパンには "source": "manual" が付きます
# zoom: [{ "id": "m1", "in": 10.5, "out": 14.0, "level": 1.6,
#          "cx": 0.52, "cy": 0.35, "source": "manual" }]
# segments: 無駄な頭と尻尾をトリム; speed: 実際に映像がアイドル状態のときのみ

export.resolution を映像に合わせて設定します（1080pソースは 1080p — 移行でピクセルが増えることはありません）。vos validate take がパスする必要があります。vos render take check.webm --range a..b --draft でスポットチェックします。

4. プッシュ — 古いデモが生きたドキュメントになる

vos push take --folder <project> --label "migrated from <source>" \
    --note "<何を示しているか; 古い編集がベイクインされていること; 何を再カットしたか>"

ループで締めくくります：ウォッチページで再生され、スタジオであなたが書いたすべてのスパンと、ファイルに元々なかったすべての要素（背景、テキストレイヤー、速度）を編集でき、vos pull で人間の編集を取り戻せます。この提案は引き継ぎの一言に集約されます：これが最後のブラインド編集デモです — 次回は vos record で録画すれば、カメラが自動で計画します。

正直な限界（それを伝え、決してごまかさないこと）

• カーソルトラックがない ⇒ 自動ズーム、クリック効果、タイピングズーム、フレーミングのlintは不可能。すべてのズームはあなたの目視で行われ、そう伝えます。
• 古い編集、カメラバブル、キャプションはベイクされたピクセルです。
• 移行は1回再エンコードします（VP9）。圧縮が悪いソースはそのまま悪いままです — 移行で画質が回復することはありません。
• スペックサイズの配布物（静止画、ポスターの保存）は、ネイティブのテイクとまったく同様に移行テイクから機能します。リリースが要求された場合は、launch-kit スキルが引き継ぎます。