| name | carocut-builder-pipeline |
| description | Remotion 资产管道。调用 project_migrate tool 将 raws/ 素材迁移到 template-project/public/ 并生成 resourceMap.ts、constants.ts、timing.ts。Agent 只需 edit constants.ts 中的 COLORS 和 FONTS。 |
Asset Pipeline
素材迁移 + TypeScript 文件生成。连接策划产出物和 Remotion 实现代码。
Incremental Mode
增量模式下素材只增不删。resourceMap.ts 全量重新生成以反映完整素材集。constants.ts 仅在风格/配色变更时修改。
Inputs
| Source | Content |
|---|
raws/images/ | All visual assets |
raws/audio/ | VO, BGM, SFX files |
raws/videos/ | Video clips (mp4, webm, mov) |
manifests/resources.yaml | Resource definitions |
raws/audio/vo/durations.json | VO timing data |
manifests/memo.md | Color and style preferences |
Outputs
| Target | Content |
|---|
template-project/public/ | Copied image/audio/video assets |
template-project/src/lib/resourceMap.ts | Asset path constants, VO_DURATIONS |
template-project/src/lib/constants.ts | VIDEO_CONFIG, COLORS, FONTS, PACING, TENSION_CONFIG |
template-project/src/lib/timing.ts | Frame calculation + pacing/tension/audio-offset utilities |
Step 6 流程
6.1 调用 project_migrate tool
脚本自动完成：
- 复制
raws/ → template-project/public/（跳过 .json/.yaml/.md 等非素材文件）
- 生成
resourceMap.ts（扫描实际文件 + durations.json）
- 生成
constants.ts（含默认 COLORS/FONTS，需 Agent 替换）
- 生成
timing.ts（完整工具函数，无需修改）
6.2 Agent edit constants.ts
脚本生成的 constants.ts 中 COLORS 和 FONTS 是默认值。Agent 必须：
- 读取
manifests/memo.md 中的视觉风格决策
- Edit
constants.ts 中的 COLORS 对象 — 替换为 memo.md 指定的配色
- Edit
constants.ts 中的 FONTS 对象 — 替换为 memo.md 指定的字体
- 如
decisions_summary 指定了非默认分辨率/FPS，edit VIDEO_CONFIG
其他常量（FONT_SIZES、PACING、TENSION_CONFIG）为固定值，无需修改。
6.3 验证
cd template-project
npx tsc --noEmit
Verification Checks
Manual Asset Copy (if project_migrate tool fails)
cp -r raws/images/existing/* template-project/public/images/existing/
cp -r raws/images/retrieved/* template-project/public/images/retrieved/
cp -r raws/images/generated/* template-project/public/images/generated/
cp -r raws/audio/* template-project/public/audio/
[ -d raws/videos ] && cp -r raws/videos/* template-project/public/videos/
[ -d raws/video ] && cp -r raws/video/* template-project/public/video/
Common Issues
| Issue | Cause | Solution |
|---|
| Missing VO file | TTS generation incomplete | Re-run TTS generation |
| Path mismatch | resources.yaml path wrong | Update path in resources.yaml |
| Type error in resourceMap | Invalid character in key | Use valid TypeScript identifier |
| durations.json missing | extract_durations not run | Run extract_durations.py |
