문제 해결

먼저 앱 버전, 운영 체제, 문제가 발생한 기능 영역, 작업 순서, 오류 메시지를 기록하세요. 다시 시도하기 전에 같은 작업 묶음이 중복 생성되지 않는지 확인합니다.

빠른 검사

설정 → 정보에서 앱 버전을 확인합니다.
설정 → 다운로드에서 yt-dlp, FFmpeg, Bun을 확인합니다.
설정 → 네트워크에서 프록시를 확인합니다.
계정이 필요하면 라이브러리 → 앱 세션에서 로그인을 확인합니다.
문제가 발생한 페이지로 돌아가 새로고침하거나 작업을 다시 만듭니다.

증상별 해결

증상	우선 확인할 항목
다운로드 또는 변환 시작 버튼을 사용할 수 없음	다운로드는 yt-dlp와 FFmpeg, 변환은 FFmpeg를 확인합니다.
링크를 분석할 수 없음	링크 완전성, 계정 권한, yt-dlp, 네트워크를 확인하고 필요하면 스니핑을 사용합니다.
다운로드가 느리거나 자주 실패함	다운로드 동시 실행 수를 낮추고 HLS 또는 m3u8은 세그먼트 동시 실행 수도 낮춥니다.
변환 실패	FFmpeg를 확인하고 입력 파일에 접근할 수 있으며 형식이 지원되는지 확인합니다.
스니핑 브라우저가 열리지 않음	“새 스니핑”을 다시 열어 재감지합니다. Chrome “브라우저 기본값”은 원격 디버깅과 연결 권한도 확인합니다.
스니핑 리소스가 없음	재생을 클릭하고 페이지를 스크롤하며 스니핑 범위를 넓히거나 세션을 다시 엽니다.
YouTube / 음악에서 로그인 요구	YouTube 앱 세션을 확인하거나 다시 연결합니다.
온라인 페이지가 계속 로드됨	프록시, 대상 서비스 상태, 계정 지역을 확인합니다.
RSS가 업데이트되지 않음	구독을 직접 새로고침하고 출처 주소와 네트워크를 확인합니다.
로컬 음악을 재생할 수 없음	파일이 이동, 삭제되었거나 오프라인 디스크에 있는지 확인합니다.
라이브러리 항목이 누락으로 표시됨	디스크를 마운트한 뒤 다시 검사하거나 기존 파일을 다시 가져옵니다.

로그 확인

설정 → 일반에서 로그 폴더를 엽니다. 문제를 한 번 재현한 뒤 해당 시각 근처의 기록을 찾습니다.

로그에는 로컬 경로, 사이트 주소 또는 오류 맥락이 포함될 수 있습니다. 제출 전에 이 정보를 삭제하거나 가리세요. 앱 세션, 페어링 링크, 토큰 또는 전체 라이브러리 데이터베이스를 업로드하지 마세요.

해결되지 않았을 때

GitHub Issues에서 다음 정보를 제공하세요.

XiaDown 버전과 시스템 버전.
문제가 발생한 기능 영역과 페이지.
안정적으로 재현할 수 있는 단계.
민감 정보를 제거한 오류 메시지 또는 로그 일부.
계정, 비공개 콘텐츠, 로컬 경로가 없는 스크린샷.