维护 Pragma 启动影片
确保 README 启动影片能够从仓库自有的源代码和资产中可复现。
项目布局
launch-video/index.ts注册 Remotion 根组件。launch-video/Root.tsx定义PragmaLaunch合成,分辨率为 1920x1080,帧率为 30 fps。launch-video/PragmaLaunch.tsx拥有时间线、场景持续时间和呈现逻辑。remotion.config.ts使用apps/www/public作为 Remotion 的公共目录。通过staticFile()从该目录解析剪辑、音频和代理标记;不要在launch-video下重复资产。.github/assets/pragma-launch.mp4是渲染后的 README 制品。
包含组件的 .tsx 文件使用 PascalCase。确保合成 id PragmaLaunch 与根渲染命令保持一致,并根据场景持续时间推导总合成持续时间,这样时间线编辑不会使注册信息过时。
工作流程
在仓库根目录下运行命令:
bun run video:studio
bun run video:typecheck
bun run video:render
在更改场景、时间、排版或资产后,使用 Studio 审查整个时间线。在渲染之前运行专门的类型检查。渲染命令使用 remotion.config.ts 中的编解码器和质量设置,将跟踪的 README 影片写入 .github/assets/pragma-launch.mp4。
音轨由 launch-video/generate-lofi.ts 确定性地生成。更改该生成器后,运行 bun run video:music;它会替换 apps/www/public/media/pragma-lofi.wav。不要为无关的视频编辑重新生成音轨。
产品录制资产位于 apps/www/public/media 中。替换录制资产时,在 Studio 中验证其完整播放,并更新 PragmaLaunch.tsx 中相应的场景持续时间,确保既不会被截断,也不会出现冻结的尾部。最后,对所有更改的源文件运行仓库常规的格式和质量检查。