recovering-from-errors

エラーからの復旧

失敗には安定したエラーコードが使用され、実行可能な fix が含まれます。その情報を保持し、 一般的な説明に置き換えないでください。

まず診断する

watch-skill doctor --json

失敗したチェックを読み、記載された修正のみを適用してください。doctor は、管理対象の ffmpeg および yt-dlp バイナリ、古いロック、破損したキャッシュ、欠落しているフレーム ディレクトリ、既知のローカルモデルのヘルスチェック失敗を修復できます。修復後に一度だけ再実行してください。

元の操作を一度だけ再試行する

doctor のチェックがすべて正常になったら、失敗したコマンドを再実行してください。別の構造化された エラーが返された場合は、そのコード、メッセージ、修正方法を報告してください。無期限に ループしたり、黙ってクラウドプロバイダーを切り替えたり、クラウド STT を有効にしたり、 インデックス済みの動画を再処理したりしないでください。

よくある対処方法：

• 取得または抽出の失敗：watch-skill doctor --json を実行してから、ウォッチを再試行します；
• プロバイダーの認証：該当する WATCHSKILL_*_API_KEY をローカルで確認します；
• プロバイダーでモデルが見つからない：有効なビジョンモデルを指定して watch-skill setup-vision を実行します；
• メモリ不足またはローカルサーバーの失敗：ローカルモデルやコンテキストを小さくするか、ユーザーがすでに利用できるクラウド プロバイダーを選択します；
• 不明な動画 ID：watch-skill list を実行し、一覧にある ID または元のソースを使用します。

セキュリティとコストに関するポリシーは、復旧中も必ず守ってください。エラーを解消するためだけに、 動画ファイルをアップロードしたり、有料プロバイダーを有効にしたり、コスト上限を引き上げたりしてはいけません。