維護 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 中更新對應的場景時長,確保既不會被截斷,也不會在後面跟著一段凍結的尾巴。最後,對所有更改過的原始碼檔案執行倉庫常規的格式化和品質檢查。