yt-dlp项目：手动处理下载中断的.part和.ytdl文件技术指南

在视频下载过程中，特别是使用yt-dlp下载大型视频或直播内容时，可能会遇到下载中断的情况。这时系统会生成.part（部分下载文件）和.ytdl（下载状态记录）两种临时文件。本文将详细介绍如何手动处理这些文件，完成视频的完整恢复。

文件类型解析

1. .part文件
   这是实际下载的视频数据片段，可能包含：

• 单个视频流（如video.f248.mkv.part）
• 单个音频流（如audio.f140.mkv.part）
• 多段分片（如video.part001、video.part002等）

2. .ytdl文件
   这是yt-dlp内部使用的下载状态记录文件，包含：

• 已下载分片的索引信息
• 下载进度元数据
• 对于恢复下载无直接用途

处理流程

情况一：单文件多分片

当存在多个连续编号的.part分片时：

# Linux/macOS系统
cat video.part* > complete_video.mp4

# Windows系统
type video.part* > complete_video.mp4

情况二：分离的音视频流

当存在独立的视频和音频.part文件时：

1. 首先确认文件完整性：

   • 检查文件大小是否合理
   • 尝试播放单个流测试

2. 使用FFmpeg合并：

ffmpeg -i "video.f248.mkv.part" -i "audio.f140.mkv.part" -c copy "final_output.mkv"

高级处理技巧

1. 格式转换
   合并时可同时转换格式：

ffmpeg -i video.part -i audio.part -c:v libx264 -crf 23 -c:a aac -b:a 192k output.mp4

2. 元数据恢复
   若存在原始信息文件（如.json或.webp），可通过以下方式添加：

ffmpeg -i final_output.mkv -i thumbnail.webp -map 0 -map 1 -c copy -disposition:1 attached_pic metadata.mkv

注意事项

1. 文件处理前建议先备份原始.part文件
2. 合并前检查各分片的MD5校验值（如有）
3. 对于直播流文件，注意检查时间戳连续性
4. .ytdl文件可安全删除，不影响媒体文件处理

故障排查

若合并后出现播放问题：

• 尝试使用-fflags +genpts参数重建时间戳
• 检查编解码器是否匹配（特别是从MKV转到MP4时）
• 使用ffprobe分析文件结构

通过以上方法，即使下载意外中断，用户也能最大限度地恢复视频内容。对于技术小白，建议优先尝试简单的文件合并操作，再逐步进阶到音视频流合并等复杂处理。