流复制、重封装与媒体打包

目标与适用范围

检查媒体流，重封装容器，按时间直通剪切，合并音轨，软封装字幕，嵌入封面，并在保持源质量的前提下批量 rewrap。
本指南将当前任务范围转化为可复核的交付结果。请保留源文件、中间产物和关键判断，让后续协作者能够理解检查了什么以及为什么这样处理。

准备证据并作出选择

• 准备源媒体文件、外部音轨、SRT 字幕、封面图片和目标交付容器。

• 确认任务是否接受关键帧对齐剪切，以及 MP4、MOV、MKV、WebM、MP3 或 M4A 的兼容性限制。

• 决策点: 当前编码质量是否已经可用？. 当视频和音频质量已经满足要求，任务只是容器、轨道布局、元数据或兼容性调整时，使用这个流程，而不是重新转码。

• 决策点: 你需要 MP4 式交付，还是更稳妥的归档容器？. 只有在 codec 与字幕兼容时选择 MP4 或 MOV；如果有特殊音频、字幕、附件或多轨布局，优先选择限制更少的 MKV。

按步骤完成工作流

1. 先探测源文件再打包

生成可读的媒体流报告，并把 ffprobe 元数据导出为 JSON，先确认容器、codec、码率、时长、章节、语言、字幕和附件信息。 使用 stream-probe-report, media-metadata-to-json.

2. 选择最轻量的安全流复制操作

在目标容器兼容时执行重封装；如果可以接受关键帧附近的切点，就用直通剪切，避免高 CPU 转码并保留原始编码质量。 使用 stream-smart-remux, stream-passthrough-trimmer.

3. 处理单文件或批量交付

单个视频需要外部音轨时使用智能 mux；多份成品需要同样的容器切换和 ZIP 交付时，使用批量 rewrap。 使用 video-smart-mux, batch-rewrap.

4. 补齐交付轨道和展示元数据

创建双音轨包，软封装可选择的 SRT 字幕，并把封面写入兼容音视频容器，同时保持主体音视频流不变。 使用 video-dual-audio-merger, video-srt-softmux, cover-art-embed.

交付前验收结果

• 探测报告确认了 codec、流数量、时长、语言、字幕、附件和目标容器兼容性。
• 重封装、剪切、合流、字幕、封面或批量输出尽可能通过流复制完成，没有不必要的重新编码。
• 最终文件能在目标播放器或下游系统中正确显示音轨、字幕、封面、时间戳和元数据。

常见问题

• 什么时候应该用流复制而不是转换工具？ 当现有视频或音频 codec 已经可接受，只需要换容器、调整轨道、附加字幕、写入封面或按时间剪切时，用流复制。只有 codec 本身需要改变时才使用转换工具。
• 为什么重封装或合流之前要先探测？ 探测报告能显示 codec、时长、语言、字幕类型、附件和容器信息，避免选择不兼容的目标容器或遗漏重要轨道。
• 直通剪切能精确到帧吗？ 不一定。流复制剪切通常落在关键帧或关键帧附近，速度快且保留质量，但未必是精确帧切点。需要精确到帧时应使用转码流程。
• 为什么多轨打包经常推荐 MKV？ MKV 对音频、字幕、附件和元数据组合的支持更宽松，做双音轨、软字幕和归档包时通常比 MP4 或 MOV 更安全。