トラブルシューティング

まず、アプリのバージョン、OS、問題が起きた機能エリア、操作手順、エラーメッセージを記録してください。再試行する前に、同じ一連のタスクを重複して作成しないことを確認します。

クイックチェック

設定 → バージョン情報 でアプリのバージョンを確認します。
設定 → ダウンロード で yt-dlp、FFmpeg、Bun を検証します。
設定 → ネットワーク でプロキシを確認します。
アカウントが必要な場合は、ライブラリ → App Sessions でログインを検証します。
問題が起きたページに戻り、更新するかタスクを作り直します。

症状別の対処

症状	最初に確認する項目
ダウンロードまたは変換の開始ボタンを使用できない	ダウンロードでは yt-dlp と FFmpeg、変換では FFmpeg を確認します。
リンクを解析できない	リンクが完全か、アカウント権限、yt-dlp、ネットワークを確認し、必要に応じてスニッフィングを使用します。
ダウンロードが遅い、または頻繁に失敗する	ダウンロードの同時実行数を減らします。HLS または m3u8 では、セグメントの同時実行数も減らします。
変換に失敗する	FFmpeg を検証し、入力ファイルへアクセスでき、形式が対応しているか確認します。
スニッフィング用ブラウザが開かない	「新規スニッフィング」を開き直してブラウザを再検出します。Chrome の「ブラウザのデフォルト」では、リモートデバッグと接続許可も確認します。
スニッフィングにリソースがない	再生をクリックし、ページをスクロールし、スニッフィング範囲を広げるかセッションを開き直します。
YouTube／音楽でログインを求められる	YouTube App Session を検証または再接続します。
オンラインページの読み込みが終わらない	プロキシ、対象サービスの状態、アカウントの地域を確認します。
RSS が更新されない	購読を手動で更新し、ソースアドレスとネットワークを確認します。
ローカル音楽を再生できない	ファイルが移動または削除されたか、オフラインのドライブにあるか確認します。
ライブラリの項目が見つからないと表示される	ドライブをマウントしてから再確認するか、存在するファイルをもう一度インポートします。

ログを確認する

設定 → 一般 でログディレクトリを開きます。問題を一度再現してから、その時刻付近の記録を探します。

ログにはローカルパス、サイトアドレス、エラーの前後関係が含まれる場合があります。送信前にこれらの情報を削除または隠してください。App Sessions、ペアリングリンク、トークン、完全なライブラリデータベースはアップロードしないでください。

解決しない場合

GitHub Issues を開き、次の情報を添えてください。

XiaDown と OS のバージョン。
問題が起きた機能エリアとページ。
安定して再現できる手順。
機密情報を除いたエラーメッセージまたはログの抜粋。
アカウント、非公開コンテンツ、ローカルパスを含まないスクリーンショット。