LoL の解説動画やプレイ動画を分析し、学習レポートを生成する。YouTube の URL を渡されたとき、LoL の動画分析・VOD レビュー・コーチング動画の要約を頼まれたとき、「この動画から学びたい」「プロの動画を分析して」といった依頼があったときに使う。
LoL の解説動画・コーチング動画・プレイ動画を AI で分析し、構造化されたHTMLレポートを生成する。
packages/lol_vod_analyzer/ にある.env に GOOGLE_API_KEY が設定済みであること--match-data を使うと lol-review の試合データと結合できる--adaptive で動きの多い場面のスクリーンショット密度を自動調整できる--speed でリプレイの再生速度を指定し、タイムスタンプを正規化できる（例: 2倍速なら --speed 2.0）--game-start で動画上の試合開始時刻（秒）を指定し、match-data のタイムスタンプとのずれを補正できるfindings.json があればそれを使うlol-tools review を実行している場合は packages/lol_review/output/latest_findings.json を候補にしてよいuv run lol-tools vod analyze '<YouTube URL>' --mode <mode> --no-open
uv run lol-tools vod analyze '<YouTube URL>' --download --mode gameplay --no-open
uv run lol-tools vod analyze /path/to/video.mp4 --mode gameplay --interval 5 --no-open
uv run lol-tools vod analyze /path/to/video.mp4 --mode gameplay --match-data packages/lol_review/output/latest_findings.json --no-open
uv run lol-tools vod analyze /path/to/replay.mov --mode gameplay --match-data match.json --speed 2.0 --game-start 90 --no-open
レポートは packages/lol_vod_analyzer/output/vod_analysis_YYYYMMDD_HHMMSS.html に保存される。
HTMLの中に以下のセクションがある:
レポート生成後、以下の構成で要約を伝える:
match-data を併用した場合は対象チャンピオン/ロールも添える最後にHTMLレポートのパスを伝え、必要なら --match-data 付きで再分析できることも案内する。
ユーザーが自分の試合データと照らし合わせたい場合は、/lol-advice で最新の試合分析を出し、動画の教えと自分のプレイの差分を議論できる。例えば:
| 状況 | 追加オプション |
|---|---|
| リプレイを2倍速で録画した | --speed 2.0 |
| 動画の先頭がロード画面や待機時間で試合開始と一致しない | --game-start <秒> |
| 重要なシーンのスクリーンショットが足りない/多すぎる | --adaptive |
| YouTube 動画の字幕がなく画像分析したい | --download --mode gameplay |
--speed と --game-start は併用可能。--speed は動画全体のタイムスケール補正、--game-start は開始位置のオフセット補正 |
--download --mode gameplay かローカル動画分析に切り替える.env に API キーが設定されているか確認packages/lol_review/output/latest_findings.json を使えるか確認uv pip install --upgrade yt-dlp で更新を試す