YTSage YouTube下载器详解

今天给大家介绍一款非常实用的YTSage YouTube下载器。

认识YTSage的批量下载能力
YTSage是一款采用PySide6构建界面的资源下载工具，支持资源质量选择、音频提取、字幕获取（包括自动生成字幕）和资源元数据查看等核心功能。其批量下载系统通过直观的可视化界面，解决了传统命令行工具操作复杂的痛点。

核心批量下载组件位于src/gui/ytsage_gui_main.py，通过PlaylistSelectionDialog类实现优先级管理，该类定义在src/gui/ytsage_gui_dialogs/ytsage_dialogs_selection.py文件中，支持通过索引范围选择实现下载顺序控制。

优先级设置的3种实用场景
场景1：工作学习资料优先下载
当你需要从资源频道下载系列教程时，可通过选择功能将最新课程设为优先。例如在"Python全栈开发"播放列表中，先下载"项目实战"章节（第15-20集），再下载基础理论部分（第1-14集）。

场景2：高价值内容优先获取
面对包含多种类型内容的混合播放列表，可通过手动勾选将高清教学资源设为优先，而将低分辨率的背景音乐设为次要。系统会严格按照选择顺序进行下载队列排序。

场景3：网络带宽自适应分配
在网络不稳定时，可先选择体积较小的关键片段（如资源的第3-5分钟精华部分）进行优先下载，待网络恢复后再获取完整内容。YTSage的src/core/ytsage_downloader.py模块会动态调整下载策略。

分步实现优先级设置
步骤1：导入播放列表URL
在YTSage主界面的URL输入框中粘贴播放列表链接，点击"Analyze"按钮进行解析。系统会自动识别播放列表类型，并在界面下方显示资源总数和基本信息。

解析完成后，"Select Resources..."按钮将从隐藏状态变为可用，该按钮对应src/gui/ytsage_gui_main.py中的playlist_select_btn组件，点击后将打开优先级设置对话框。

步骤2：打开优先级选择界面
点击"Select Resources..."按钮后，系统会加载PlaylistSelectionDialog对话框，显示所有资源条目。对话框顶部提供"Select All"和"Deselect All"快捷操作按钮，中部为资源列表区域，底部为确认按钮组。

该对话框采用复选框+索引标识的直观设计，每个资源条目显示格式为"[索引]. [标题]"，如"3. Python装饰器高级用法"，便于快速定位目标内容。

步骤3：设置优先级顺序
YTSage通过索引范围选择实现优先级控制，支持3种选择方式：

连续范围选择：按住Shift键点击起始和结束资源，选中如"1-5"表示优先下载前5个资源
离散选择：按住Ctrl键点击多个不连续资源，如"1,3,5"实现跳跃式优先级设置
混合选择：组合使用范围和离散选择，如"1-3,5,7-9"表示优先下载1-3集、第5集和7-9集
选择完成后，点击"OK"按钮，系统会自动将选择结果转换为yt-dlp支持的格式字符串（如"1-5,7,9-12"），并按照选择顺序排列下载队列。

# 选择逻辑核心代码（源自ytsage_dialogs_selection.py）
def _condense_indices(self, indices: list[int]) -> str:
indices = sorted(set(indices)) # 去重并排序
ranges = []
start = end = indices[0]

for num in indices[1:]:
if num == end + 1:
end = num
else:
ranges.append(f"{start}-{end}" if start != end else str(start))
start = end = num

ranges.append(f"{start}-{end}" if start != end else str(start))
return ",".join(ranges)

高级技巧：实现精准优先级控制
自定义下载顺序
通过手动调整选择的索引顺序，可实现完全自定义的下载队列。例如选择"5,3,1-2,4"将强制系统按5→3→1→2→4的顺序下载资源，这在需要按逻辑顺序而非发布时间下载时特别有用。

部分范围优先级设置
对于特别长的播放列表，可使用"排除法"选择。先点击"Select All"全选，再手动取消低优先级资源的勾选。系统会自动记录反选结果，并优先下载剩余选中项。

下载进度监控
优先级设置完成后，主界面的进度条区域会实时显示当前下载位置和剩余时间。通过src/gui/ytsage_gui_main.py中的update_progress_bar方法，可精确跟踪每个资源的下载状态。

常见问题解决方案
问题1：选择后下载顺序仍混乱
这通常是由于未正确应用选择结果导致。请检查是否在点击"OK"前确认了选择范围，正确的操作流程是：选择资源→点击"OK"→点击"Download"。系统会在src/core/ytsage_downloader.py中创建有序下载线程。

问题2：播放列表解析不完整
当遇到大型播放列表（超过100个资源）时，YTSage可能需要更长解析时间。此时请不要重复点击"Analyze"按钮，可通过查看日志文件（位于程序根目录）确认解析进度。

问题3：优先级设置频繁失效
这可能是由于yt-dlp核心需要更新。点击主界面的"Update yt-dlp"按钮（对应src/gui/ytsage_gui_main.py中的update_ytdlp_btn组件），完成更新后重启程序即可解决。

总结与最佳实践
YTSage的批量下载优先级系统通过直观的可视化界面，将复杂的命令行参数转换为简单的勾选操作。核心优势在于：

可视化操作：无需记忆复杂的命令行参数，通过鼠标点击即可完成优先级设置
灵活的选择模式：支持连续范围、离散选择和混合模式三种优先级定义方式
与下载核心深度整合：选择结果直接转换为yt-dlp的--playlist-items参数，确保执行效率
最佳实践建议：

对于重要内容，建议单独创建"优先下载"播放列表
定期通过"Download Settings"按钮（src/gui/ytsage_gui_main.py中的settings_button）清理下载缓存
网络不稳定时，优先选择720p及以下分辨率的资源以提高下载成功率

原文：https://www.ruanxiangshe.com/#/article/005c2388-8488-4c77-95c7-d2a0eecaf2e2