ysyecust/lecture-to-notes

解決する問題

講義ビデオを見ることは受動的で、後で復習するのが難しい。このプロジェクトは、ビデオ URL を構造化された読みやすい中国語のハンドアウトに自動変換します：LaTeX ソースファイル、コンパイル済み PDF、切り抜かれた図、修正された字幕、検証レポート。話者の話す流れに従うのではなく、読者の質問に基づいてコンテンツを再構成し、各図にはビデオのどの部分から来たかを正確に示す脚注が付き、数値主張はすべて字幕または画面テキストと照合されます。

仕組み

パイプラインは、YouTube、Bilibili（マルチパートプレイリストを含む）、または X/Twitter のビデオリンクを受け取ります。まずプラットフォームを識別し、メタデータを取得します。次に、5 段階のフォールバックで字幕を取得します：手動 CC、プラットフォームの自動字幕、焼き込み字幕からの OCR、ローカル自動音声認識（ASR）、最後に辞書または LLM ベースの修正。並行して、ビデオをダウンロードしてフレームを抽出し、静的ナビゲーションバーと字幕バンドを切り取り、プレゼンターカメラとスライド領域がある場合はスライド部分のみを保持します。字幕とクリーンなフレームを収集した後、読者優先のライティングステップで LaTeX ノートを生成します：章は読者の質問に基づいて構成され、数式には記号表が付き、数値はクロスチェック用に別のテーブルに記録されます。ノートは xelatex で 2 回コンパイルされ、完全性、図の時間一貫性、図が脚注と同じページに留まるかをチェックするゲートキーパースクリプトで検証されます。すべてのチェックが合格した場合のみ、最終 PDF とすべての補助成果物が生成されます。

対象読者

オンライン講義から高品質で復習しやすいノートを得たい人——特に生のビデオよりも構造化されたハンドアウトを好む中国語話者の学生や自習者。既存の講義録画を洗練されたコース教材に変換したい教育者にも役立ちます。このプロジェクトは、Claude Code、Codex、DeepSeek Harness 用のすぐ使えるエージェントスキルを提供しており、これらのツールを持つユーザーは簡単なコマンドでプロセス全体を開始できます。付属のオンラインコースライブラリには、9 コース、100 以上の講義があり、出力例を示し、ウェブ最適化テキストと元の PDF モードの両方で閲覧できます。

ハイライト

• 5 段階の字幕フォールバック – 手動 CC から OCR、ローカル ASR まで、プラットフォームが提供しない場合でもキャプションを確保。
• 読者優先のライティング – 章は話す順序ではなく読者の質問に基づいて再構成され、数式には常に記号の説明が続きます。
• 時間追跡可能な図 – ノート内の各画像には正確なビデオ時間範囲の脚注があり、検証ステップで図と脚注が同じページに留まることが保証されます。
• 数値主張のチェック – 単位付きの数値は別の TSV ファイルに抽出され、トランスクリプトと照合されます。
• デュアルフォーマット読み取り – フォントサイズ調整可能なウェブページとビデオへのクリックジャンプ機能、全文検索とズーム付きの元の PDF リーダー。
• エージェントスキル統合 – Claude Code、Codex、DeepSeek Harness のスキルとしてインストール可能；/lecture-to-notes <URL> と入力するだけ。
• アクティブなコースライブラリ – 9 コース、101 講義、2,451 ページの中国語ハンドアウトがすでにオンラインで利用可能。