kb-yt-channel

KB YouTube チャンネル

チャンネルの解決、文字起こし、重複排除と再開、再試行、ペーシングには、ネイティブの kb ingest channel を使用します。同梱の scripts/ingest-channel.py は、yt-channels/ 内でのトピック整理、メタデータ、インデックス、検証、実行レポートを追加します。

1. リクエストから、Vault、チャンネル／プレイリストの URL、トピックのスラッグ／タイトル／ドメイン、動画の選択（--limit N または --all）、文字起こしポリシー（captions、auto、stt）を特定します。合理的に推測できない選択肢についてのみ質問します。
2. 必須ツールを一度だけ確認し、現在の証拠を再利用します。対象は kb、yt-dlp、インデックス作成時の qmd、STT がリクエストされた場合の ffmpeg と設定済みプロバイダーです。標準の事前確認として、任意のネットワーク依存関係をインストールしないでください。
3. --vault、--channel-url、--topic-slug、--title、--domain、選択内容、--transcribe を指定して、python3 <kb-yt-channel-dir>/scripts/ingest-channel.py を実行します。このスキルディレクトリからヘルパーを解決します。デフォルトでは対象言語の字幕を使用します。必要な場合のみ --sub-langs を上書きします。--no-index はインデックス作成を延期し、--embed は埋め込みをリクエストします。
4. プレビューは任意です。既存の --dry-run はトピックのひな形とメタデータを作成／更新し、その後、文字起こしを行わずに取り込み計画を一覧表示します。読み取り専用のプレビューではありません。許可されたトピックの作成／更新に限って使用してください。プレビューの後に完全な事前確認を再度行う必要はありません。
5. ヘルパーの JSON サマリーと失敗内容を確認します。完了したトピック情報／lint／インデックス検証は再利用し、証拠が不足している場合にのみ追加確認を実行します。検索可能性がタスクに含まれる場合は、インデックス作成後にトピック／コレクション内で代表的な kb search を 1 回実行して確認します。
6. 実際に取り込んだ件数、スキップした件数、失敗した件数、レポートのパスを報告します。タスクに統合が含まれる場合にのみ Wiki 記事を作成します。文字起こしの取り込みだけで記事作成が必要になるわけではありません。

失敗時の対応と参考資料

既存のネットワーク設定と、ネイティブの上限付き再試行／バックオフから開始します。レート制限が発生した場合は、サーバーの指示に従い、並行数を減らすか、ペーシングを増やします。認証済み Cookie や許可されたプロキシを設定するのは、実際にアクセス／ネットワークの問題が確認された場合に限ります。大規模なチャンネルに対して、認証情報を公開したり、住宅用プロキシを必須にしたりしないでください。

メタデータ／出力の詳細については references/channel-topic-contract.md を、実際の失敗事例については references/troubleshooting.md を参照します。修復後は同じリクエストを再開してください。ネイティブの重複排除により、正常に取り込まれたデータは保持されます。字幕がない場合は、その範囲とプロバイダーの費用が承認されていれば、auto／STT を使用できます。部分的な出力を保持し、デフォルトでユーザーデータを削除するのではなく、特定の文字起こしにはサポート対象の更新方法を使用してください。