[Github] video-shotcraft – Codex 的 AI 产品视频镜头库

想让 Codex 或 Claude Code 制作产品宣传片时，难点通常不在“能不能写 Remotion 代码”，而在镜头怎么选、页面如何采集、节奏怎样安排、声音钉在哪一帧，以及怎样避免成片像一组会动的幻灯片。video-shotcraft 把这些判断整理成可安装的 Agent Skill、镜头配方库、动态样片画廊和完整模板，适合愿意用代码迭代产品视频的开发者与设计团队；它不是无需素材、无需审片的一键视频生成器。

它不是生成模型

普通文字生成视频工具把主要能力放在模型采样：用户描述画面，服务返回一段新生成的像素。video-shotcraft 的路线不同。它让编码代理读取制作规则与镜头卡，再用真实产品截图、React 组件、Remotion 时间线、2.5D 运镜和音频资产拼出可重复渲染的成片。视觉内容仍需要产品页面、文案、品牌规范与人工判断，优势则是每个镜头都可以继续修改代码和帧级参数。

这也决定了它与 OpenMontage 的差异：OpenMontage 更像覆盖研究、脚本、素材生成和合成的广义视频生产系统，video-shotcraft 则集中处理 Web 或桌面产品宣传片的镜头语言、页面运镜、节拍和声音设计。前者重在编排整条管线，后者重在把产品 UI 拍得更像一支经过设计的发布视频。

先从画廊选镜头

官方 Gallery 可以搜索、筛选和预览镜头效果，再复制镜头卡名称交给 Agent。镜头不是只有“淡入、缩放”这类模糊标签，而是被拆成用途、能量、建议时长、参数、参考实现与已知陷阱。例如 deck-deal-flyin 用发牌式加速度展开卡片，spotlight-hero-card 用聚光与推近突出主角，before-after-slider-scrub 用滑杆展示处理前后差异。

这里有一处版本口径需要保留：当前递归文件树在 references/shots/ 下实际找到 104 个 Markdown 镜头卡文件，README、SKILL.md 和 Gallery 首页也写 104 卡、161 样式或预览；但仓库描述与上面的 OG 图已经写成 106 卡，OG 图还显示 162 Styles。合理推测是页面、描述和源码正处于更新交接期，但在对应文件公开前，不能把 106 张全部当作已经可读取的卡片。

三条制作路线

如果用户已经点名 Ink Press 或某张镜头卡，Skill 会把它当成硬约束；如果只给了项目路径或网址，规则要求先做最小只读检查，再解释三种路线并推荐。这个设计比“默认套模板”更稳妥，因为同一种纸墨风格并不适合所有产品，模板应继承镜头结构和运动参数，而不是覆盖目标产品原有的字体、配色与材质。

从页面到成片

1. 理解产品：只读检查功能、页面状态、品牌 tokens、启动方式和数据风险，明确哪些内容必须展示。
2. 确定视觉：从产品自身提取字体、色板、间距和信息密度，先用静态 styleframe 锁定方向。
3. 映射镜头：按照叙事和能量曲线挑选镜头卡，读取卡片全文与对应 TSX 实现，而不是只凭名称重新编一个近似动画。
4. 采集素材：真实产品页面优先使用浏览器截图、元素抠图和坐标表；客户、个人、内部或实时数据需要先虚构或脱敏。
5. 实现与声音：逐镜头制作 Remotion 场景，给转场、点击、撞击和节奏点配置 SFX，并持续输出静帧检查。
6. 渲染终检：整片渲染后检查抽帧、音频、卡点、确定性和数据安全，再由独立上下文复核成片。

项目强调“一个镜头只讲一个动效”，并为信息落定后的停留时间预留帧数。对于强节奏音乐，还会先分析 BPM 与相位，再把转场写到拍点上。这些规则不会自动保证审美质量，但它们能把“感觉不够电影感”拆成可检查的运镜、节奏、光影、声音和数据问题。

安装与渲染

最快的安装方法是让 Agent 处理仓库链接，或执行 npx skills add Vincentwei1021/video-shotcraft。手动方式是克隆仓库，再链接到 ~/.claude/skills/video-shotcraft 或 ~/.codex/skills/video-shotcraft。如果只想运行随附模板，需要进入 template 安装 npm 依赖，再执行 Remotion render；当前模板固定了 Remotion 4.0.484、React 19.2.7 和 TypeScript 6 系列依赖。

无头 Linux 环境不是开箱即用。README 记录了三类已知限制：低核心机器需要把并发降为 1；新版 Chromium 移除了旧 Headless 模式，可能需要 chrome-headless-shell；如果机器无法访问 Remotion 的下载地址，则要手动指定本地浏览器可执行文件。团队最好先固定仓库 commit 和 Node/npm 锁定结果，跑通一段短片后再接入 CI。

许可分三层看

仓库代码采用 Apache-2.0，但这不代表所有依赖与素材都自动继承同一许可。第一层是 video-shotcraft 自身的代码和文档；第二层是 Remotion，它使用自己的许可证。Remotion 当前允许个人、非营利组织以及不超过 3 名员工的营利组织免费使用，其他营利组织通常需要 Company License，具体仍应以使用时的官方条款为准。

第三层是音频与演示素材。仓库整理了 5 个 BGM 和 149 个 SFX，并在 ATTRIBUTION 中逐项记录来源；但文件中仍有若干基础音效被作者标为“来源待考”或“商用前须确认”。项目自带的产品截图也只是演示资产，发布前应替换成目标产品素材。商业交付不能只看根目录 LICENSE，就默认音乐、音效、商标和截图全部可自由使用。

现在是否适合用

截至 2026-07-28，仓库创建仅 9 天，约有 2,300 Stars、201 Forks，最近一次推送就在当天，说明它获得了快速关注并仍在密集调整。当前唯一 Release/Tag 名为 gallery-media，用途是存放 Gallery 的 MP4 样片，并不是稳定的语义化产品版本；公开 Issue 也不足以形成可靠的长期故障统计。

它适合已经会用 Codex 或 Claude Code、能运行 Node.js 工程、愿意逐帧审片的前端团队、独立开发者和产品营销人员。若需求是“上传一句文案就获得稳定商业成片”，它不是直接替代品；若目标是把真实产品 UI 做成可修改、可复用、能进入版本控制的宣传视频，它提供了一套相当具体的镜头词汇与制作检查方法。更稳妥的试用顺序是先在 Gallery 选 2–3 张卡，做 5–10 秒短片，再决定是否使用完整模板或八阶段自由创作。

官方资料：

• video-shotcraft GitHub 仓库
• 动态样片画廊：https://vincentwei1021.github.io/video-shotcraft/
• Skill 使用说明
• 八阶段制作流水线
• Remotion 许可证：https://github.com/remotion-dev/remotion/blob/main/LICENSE.md