7. 第 6 模块:后处理器流水线与媒体重构 (06_postprocessor_and_ffmpeg)¶
本模块深入剖析 yt-dlp 在下载完成后的多媒体重构、转码、流封装与元数据注入体系。
本模块章节导航
- 7.1. 06.01 PostProcessor 插件链结构、POSTPROCESS_WHEN 多生命周期切入点
- 7.2. 06.02 FFmpeg 子进程封装、音视频流多路复用 (FFmpegMergerPP) 与流故障自愈 (Fixup 修复链)
- 7.2.1. 1. 二进制路径解析与特性探针 (_get_ffmpeg_version)
- 7.2.2. 2. 命令安全加固与文件名协议注入防御 (real_run_ffmpeg)
- 7.2.3. 3. 多级参数作用域路由 (_configuration_args)
- 7.2.4. 流映射与无损直通 (-c copy)
- 7.2.5. M3U8 AAC 比特流过滤器自适应修正 (aac_adtstoasc)
- 7.2.6. 1. 非等比像素修复 (FFmpegFixupStretchedPP)
- 7.2.7. 2. 重复 MOOV 修复与 FastStart 优化 (FFmpegFixupDuplicateMoovPP)
- 7.2.8. 3. 时间戳重对齐算法 (FFmpegFixupTimestampPP)
- 7.2.9. 核心源码行级对照表
- 7.3. 06.03 字幕多格式转换与原子级流内嵌 (EmbedSubtitlePP)、封面图裁剪与元数据注入
- 7.3.1. 1. DFXP / TTML 语法树解析与 SRT 降级生成 (dfxp2srt)
- 7.3.2. 2. 字幕格式动态转码 (FFmpegSubtitlesConvertorPP.run)
- 7.3.3. 多语言 ISO-639-2/T 编码标准化
- 7.3.4. 1. WebP 签名真伪嗅探与格式自适应修复 (fixup_webp)
- 7.3.5. 2. MP4 / M4A 容器的三级降级嵌入流水线
- 7.3.6. 3. FLAC / Ogg / Opus 的 VorbisComment 结构体封装
- 7.3.7. FFMETADATA1 文本生成与章节切分对齐
- 7.3.8. 核心源码行级对照表
- 7.4. 06.04 章节切分 (SplitChaptersPP)、SponsorBlock 片段智能剔除与文件系统扩展属性写入
7.5. 模块核心要点¶
PostProcessor 插件架构与阶段分发:解剖 PostProcessor 基类、POSTPROCESS_WHEN 生命周期切入点(before_dl, post_process, after_move, playlist)与状态同步。
FFmpeg 封装器与流故障自愈 (Fixup):音视频流物理合成 (FFmpegMergerPP)、非等比像素修复 (FFmpegFixupStretchedPP)、AAC 时间戳断裂修复 (FFmpegFixupM3u8PP) 与 MP4 重复 MOOV 修复 (FFmpegFixupDuplicateMoovPP)。
字幕转换与封面图原子注入:VTT/SRT/ASS 格式转换、软字幕流封装 (FFmpegEmbedSubtitlePP) 与原子写入。
元数据、章节与 SponsorBlock 处理:精确时间范围视频裁剪 (FFmpegSplitChaptersPP)、SponsorBlock API 对接与文件系统扩展属性 (XAttr) 写入。