用途:用 Remotion(React + TypeScript)生成随仓库提交的视频内容,如 README 主视觉、案例研究短片、落地页演示和推文戏剧化片段。参考实现位于 desplega-ai/agent-swarm 的 assets/video-source/。
主要能力:一个 Remotion 项目承载多个 Composition,在 src/Root.tsx 注册,并为每个视频添加 build:<slug> 脚本;字体在 src/fonts.ts 模块作用域加载;主题令牌从产品自身 globals.css 提取,不自行发明颜色字体;音频按 Composition 挂载,可部分静音。
使用方式:初始化时执行 mkdir -p assets/video-source && cd assets/video-source、npm init -y、npm install remotion @remotion/cli @remotion/google-fonts react@^18.3.1 react-dom@^18.3.1、npm install -D @types/react typescript,再用 npx remotion studio 预览。渲染命令:npx remotion render src/index.ts <CompositionId> out/<name>.mp4 --browser-executable=/opt/playwright/chromium --color-space=bt709。
限制与注意:音乐需由团队人员选择并注明艺术家、来源 URL 与许可(如 CC0 或 CC BY 4.0),不得自行抓取;视频项目需从根 tsconfig 排除并单独配置 linter;out/ 与 node_modules/ 应 gitignore;README 嵌入用 raw/main 的 <video> 标签,目标小于 3 MB;不加 --color-space=bt709 会输出全范围 yuvj420p,社交平台期望有限范围 yuv420p。首次渲染后需做“诚实阅读”调整节奏,压缩铺垫、扩展核心场景。非仓库场景的设计型一次性剪辑应改用 open-prompt-showreel,音频优先资产应使用文本转语音服务。