Files
2026-06-21 14:26:15 +08:00

223 lines
7.9 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""播放列表下载器模块
负责解析 YouTube 播放列表,获取所有视频条目信息,
支持单个或批量下载。
"""
import logging
from pathlib import Path
from typing import List, Optional, Dict, Any
import yt_dlp
from ..models.task import VideoInfo
from ..utils.user_agents import get_random_ua
from .format_parser import (
FormatParser, _is_cookie_error, _parse_browser_list,
)
logger = logging.getLogger(__name__)
class PlaylistDownloader:
"""播放列表下载器
负责解析 YouTube 播放列表 URL,提取所有视频条目的基本信息。
实际下载通过 VideoDownloader 执行。
Cookie 回退机制:当配置的浏览器 Cookie 读取失败时,
自动尝试列表中的下一个浏览器。
"""
def __init__(self, cookies_from_browser: str = "", cookies_file: str = "") -> None:
"""初始化播放列表下载器
Args:
cookies_from_browser: 浏览器名称(或逗号分隔的多个),如 "chrome,firefox"
cookies_file: Cookie 文件路径(Netscape 格式),优先于浏览器 Cookie
"""
self._cookies_file = cookies_file
self._browsers = _parse_browser_list(cookies_from_browser)
self._base_opts: Dict[str, Any] = {
"quiet": True,
"no_warnings": True,
"extract_flat": "in_playlist",
"skip_download": True,
"ignoreerrors": True,
"socket_timeout": 30,
"http_headers": {"User-Agent": get_random_ua()},
}
self._last_error: str = ""
def _build_ydl_opts(self, browser_idx: int = -1) -> Dict[str, Any]:
"""构建 yt-dlp 选项(包含 Cookie 配置)"""
opts = self._base_opts.copy()
opts["http_headers"] = {"User-Agent": get_random_ua()}
if self._cookies_file and Path(self._cookies_file).exists():
opts["cookiefile"] = self._cookies_file
elif 0 <= browser_idx < len(self._browsers):
browser = self._browsers[browser_idx]
opts["cookiesfrombrowser"] = (browser,)
return opts
def _try_extract_info(self, url: str, extra_opts: Dict[str, Any] | None = None):
"""调用 yt-dlp extract_info,Cookie 失败时自动回退
Args:
url: YouTube URL
extra_opts: 额外的 yt-dlp 选项
Returns:
yt-dlp info dict
Raises:
RuntimeError: 所有方式都失败
"""
errors: List[str] = []
def _call_with_opts(opts, use_base=False):
if use_base:
merged = self._base_opts.copy()
merged["http_headers"] = {"User-Agent": get_random_ua()}
else:
merged = opts.copy()
if extra_opts:
merged.update(extra_opts)
with yt_dlp.YoutubeDL(merged) as ydl:
return ydl.extract_info(url, download=False)
# 第一步:cookies_file
if self._cookies_file and Path(self._cookies_file).exists():
try:
return _call_with_opts(self._build_ydl_opts(browser_idx=-1))
except Exception as e:
msg = str(e)
logger.warning(f"Cookie 文件模式失败: {msg[:100]}")
errors.append(f"cookies_file: {msg[:120]}")
# 非 Cookie 错误也不 raise,继续回退
# 第二步:依次尝试每个浏览器
for idx, browser in enumerate(self._browsers):
try:
info = _call_with_opts(self._build_ydl_opts(browser_idx=idx))
if info is not None:
logger.info(f"播放列表 Cookie 来源: {browser}")
return info
except Exception as e:
msg = str(e)
logger.warning(
f"浏览器 {browser} Cookie 失败: {msg[:100]}"
)
errors.append(f"{browser}: {msg[:120]}")
if not _is_cookie_error(msg) or idx + 1 >= len(self._browsers):
break # 非 Cookie 错误或已是最后一个浏览器
# 第三步(最终回退):不使用任何 Cookie 直接请求
logger.warning(
"Cookie 来源均失败或有错误,尝试无 Cookie 模式"
)
try:
return _call_with_opts(None, use_base=True)
except Exception as e:
msg = str(e)
errors.append(f"no_cookies: {msg[:120]}")
error_summary = "; ".join(errors)
raise RuntimeError(f"所有方式均失败: {error_summary}")
def fetch_playlist_info(
self, url: str, max_videos: int = 0
) -> List[VideoInfo]:
"""获取播放列表中的所有视频信息
Args:
url: 播放列表 URL
max_videos: 最大获取视频数,0 表示不限制
Returns:
VideoInfo 列表,包含播放列表中每个视频的基本信息
"""
videos: List[VideoInfo] = []
try:
extra = {}
if max_videos > 0:
extra["playlist_items"] = f"1-{max_videos}"
info = self._try_extract_info(url, extra_opts=extra)
if info is None:
logger.error(f"无法获取播放列表信息: {url}")
return videos
# 获取播放列表标题
playlist_title = info.get("title", "未命名播放列表")
logger.info(f"播放列表: {playlist_title}")
# 提取所有视频条目
entries = info.get("entries") or []
# 如果 flat 提取为空,尝试完整提取
if not entries:
logger.info("flat 提取为空,尝试完整提取...")
extra["extract_flat"] = False
info2 = self._try_extract_info(url, extra_opts=extra)
if info2:
entries = info2.get("entries") or []
for entry in entries:
if entry is None:
continue
video_url = entry.get("webpage_url") or entry.get("url") or ""
if not video_url and entry.get("id"):
video_url = f"https://www.youtube.com/watch?v={entry['id']}"
video_info = VideoInfo(
title=entry.get("title", "未知标题"),
author=entry.get("uploader", entry.get("channel", "未知作者")),
duration=entry.get("duration", 0) or 0,
upload_date=str(entry.get("upload_date", "")) if entry.get("upload_date") else "",
thumbnail_url=entry.get("thumbnail") or entry.get("thumbnails", [{}])[0].get("url", ""),
description=entry.get("description", "") or "",
webpage_url=video_url,
)
videos.append(video_info)
logger.info(f"播放列表解析完成,共 {len(videos)} 个视频")
return videos
except yt_dlp.utils.DownloadError as e:
msg = str(e)
logger.error(f"yt-dlp 播放列表解析错误: {msg}")
self._last_error = FormatParser._format_error(msg)
return videos
except Exception as e:
msg = str(e)
logger.error(f"播放列表解析异常: {msg}")
self._last_error = FormatParser._format_error(msg)
return videos
@property
def last_error(self) -> str:
"""获取最后一次错误的详细信息"""
return self._last_error
def fetch_playlist_title(self, url: str) -> str:
"""仅获取播放列表标题
Args:
url: 播放列表 URL
Returns:
播放列表标题,失败返回空字符串
"""
try:
info = self._try_extract_info(url)
return info.get("title", "未命名播放列表") if info else ""
except Exception as e:
logger.error(f"获取播放列表标题失败: {e}")
return ""