YTDLnis 字幕下载功能问题分析与解决方案

问题背景

在 YTDLnis 1.7.2 版本中，用户报告了两个关于字幕下载功能的重要问题：

1. 当仅启用"保存字幕"选项时，某些视频无法下载到字幕文件
2. 当同时启用"保存字幕"和"保存自动生成字幕"选项时，系统会下载两份字幕文件，导致播放器显示混乱

技术分析

字幕来源机制

YTDLnis 通过 yt-dlp 后端处理字幕下载，主要涉及两种字幕来源：

1. 人工上传字幕：由视频上传者提供的专业字幕文件，通常质量较高
2. 自动生成字幕：YouTube 自动生成的转录文本，可能包含识别错误

问题根源

1. 单一字幕选项失效问题：当仅选择"保存字幕"时，系统未能正确处理某些视频的字幕元数据，导致字幕下载被跳过
2. 双重字幕问题：同时启用两个选项会触发 yt-dlp 的 --write-subs 和 --write-auto-subs 参数，强制下载两种字幕
3. 文件打开错误：系统在存在多个输出文件时，错误地选择了字幕文件而非视频文件作为默认打开对象

解决方案

开发团队在 YTDLnis 1.7.3 版本中实施了以下改进：

1. 优化字幕选择逻辑：系统现在会优先选择人工上传的字幕，仅在无可用人工字幕时回退到自动生成字幕
2. 改进文件处理流程：确保在多文件下载场景中正确识别视频文件作为主要打开对象
3. 增强参数处理：更智能地处理 yt-dlp 的字幕相关参数，避免不必要的重复下载

用户建议配置

对于希望获得最佳字幕体验的用户，建议采用以下设置：

1. 仅启用"保存字幕"选项
2. 字幕语言设置为"en.*"（或其他目标语言）
3. 禁用"保存自动生成字幕"选项
4. 确保"嵌入字幕"选项处于关闭状态（如需单独字幕文件）

技术实现细节

在修复版本中，系统现在会：

1. 首先检查视频是否包含人工上传的字幕
2. 若无人工字幕，则检查自动生成字幕的可用性
3. 根据用户设置选择最优字幕来源
4. 确保视频文件始终作为主下载项处理

这一改进显著提升了字幕下载功能的可靠性和用户体验，解决了播放器显示混乱和文件选择错误的问题。