offline-remotion-render

在本机（Windows + Clash TUN，TCP 回环被阻断）环境下，使用免端口方案渲染 Remotion 视频，并完成成片后处理（离线合成音轨 + ffmpeg 烧录硬字幕）。由于 Remotion 官方的 render/still 功能依赖 Chrome DevTools Protocol（CDP）端口通信，在此类网络受限环境中 100% 失败（常见报错如：Remotion 渲染失败、ErrorEvent、Bundling 24% 崩溃、#<ErrorEvent>、CDP 连不上、remotion 出不了片等），本技能提供一种可实际出片的替代渲染管线： 1. **生成自包含 offline.html**：通过 Remotion 的 bundle 功能生成完全离线的 HTML 文件，确保所有资源（JS、CSS、字体、静态素材）内嵌或本地引用，不依赖外部网络或端口通信。 2. **Chrome 一次性 --screenshot 逐帧渲染**：使用 Chrome 命令行启动无头浏览器，加载 offline.html，通过 --screenshot 参数配合时间轴控制，实现逐帧截图（如每秒 30 帧，则每 33.33ms 截一帧），规避 CDP 端口依赖问题，实现“免端口渲染”。 3. **ffmpeg 编码视频**：将逐帧生成的 PNG 序列通过 ffmpeg 编码为 MP4 视频（支持 H.264/H.265），可指定码率、分辨率、帧率等参数，确保输出质量。 4. **离线合成音轨**：若原视频“没声音”，可单独准备 BGM 或配音音频文件，使用 ffmpeg 将音频与视频合并，实现“加音轨”功能。 5. **烧录硬字幕**：针对“没字幕”需求，使用 ffmpeg 的 subtitles 或 drawtext 滤镜，将 SRT/ASS 字幕文件“烧录”到视频画面中，生成“加硬字幕”的最终成片（即“烧录字幕”），确保字幕不可关闭且兼容所有播放平台。 适用场景：Remotion 项目在受限网络环境下无法正常渲染、需快速出片、要求音画同步、字幕内嵌、无需依赖 CDP 端口的完整离线渲染流程。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本