Khắc phục sự cố

Ghi lại phiên bản ứng dụng, hệ điều hành, khu vực và trang gặp lỗi, các bước đã làm cùng thông báo lỗi. Trước khi thử lại, hãy đảm bảo không tạo trùng cùng một nhóm tác vụ.

Kiểm tra nhanh

Kiểm tra phiên bản trong Cài đặt → Giới thiệu.
Xác minh yt-dlp, FFmpeg và Bun trong Cài đặt → Tải xuống.
Kiểm tra proxy trong Cài đặt → Mạng.
Nếu cần tài khoản, xác minh đăng nhập trong Thư viện → Phiên ứng dụng.
Quay lại trang lỗi rồi làm mới hoặc tạo lại tác vụ.

Xử lý theo triệu chứng

Triệu chứng	Kiểm tra trước
Nút bắt đầu tải hoặc chuyển mã không khả dụng	Với tải xuống, kiểm tra yt-dlp và FFmpeg; với chuyển mã, kiểm tra FFmpeg.
Không phân tích được liên kết	Tính đầy đủ của liên kết, quyền tài khoản, yt-dlp và mạng; dùng Dò tìm nếu cần.
Tải chậm hoặc thường thất bại	Giảm số lượt tải đồng thời; với HLS hoặc m3u8, giảm thêm số phân đoạn đồng thời.
Chuyển mã thất bại	Xác minh FFmpeg, kiểm tra tệp đầu vào truy cập được và định dạng được hỗ trợ.
Trình duyệt Dò tìm không mở	Mở lại “Dò tìm mới” để phát hiện lại; với “Mặc định của trình duyệt” Chrome, kiểm tra gỡ lỗi từ xa và quyền kết nối.
Dò tìm không có tài nguyên	Nhấp phát, cuộn trang, mở rộng phạm vi Dò tìm hoặc mở lại phiên.
YouTube / Âm nhạc yêu cầu đăng nhập	Xác minh hoặc kết nối lại phiên YouTube.
Trang trực tuyến tải mãi	Kiểm tra proxy, trạng thái dịch vụ đích và khu vực tài khoản.
RSS không cập nhật	Làm mới nguồn thủ công, kiểm tra địa chỉ và mạng.
Nhạc cục bộ không phát	Kiểm tra tệp đã bị di chuyển, xóa hoặc nằm trên ổ đĩa ngoại tuyến không.
Mục Thư viện bị đánh dấu thiếu	Kết nối ổ đĩa rồi kiểm tra lại, hoặc nhập lại tệp vẫn còn.

Xem nhật ký

Mở thư mục nhật ký từ Cài đặt → Chung. Tái hiện lỗi một lần rồi tìm bản ghi quanh thời điểm đó.

Nhật ký có thể chứa đường dẫn cục bộ, địa chỉ trang hoặc ngữ cảnh lỗi. Xóa hay che các dữ liệu này trước khi gửi. Không tải lên Phiên ứng dụng, liên kết ghép đôi, token hoặc toàn bộ cơ sở dữ liệu Thư viện.

Nếu vẫn chưa giải quyết được

Mở GitHub Issues và cung cấp:

Phiên bản XiaDown và hệ thống.
Khu vực và trang gặp lỗi.
Các bước có thể tái hiện ổn định.
Thông báo lỗi hoặc đoạn nhật ký đã loại bỏ dữ liệu nhạy cảm.
Ảnh chụp không chứa tài khoản, nội dung riêng tư hay đường dẫn cục bộ.