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

想让 Codex 或 Claude Code 制作产品宣传片时，真正难的通常不是写出一段 Remotion 代码，而是挑选镜头、采集真实页面、安排节奏、设计声音，并让交付后的成片还能继续修改。video-shotcraft 把这些工作整理成可安装的 Agent Skill、157 张镜头配方卡、214 条在线动态样片、完整成片模板和浏览器动效工作台，适合愿意用代码迭代产品视频的开发者与设计团队；它不是输入一句话就自动交付商业成片的视频生成模型。

它不是生成模型

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

这也决定了它与 OpenMontage 的差异：OpenMontage 更接近覆盖研究、脚本、素材生成和合成的广义视频生产系统；video-shotcraft 集中处理 Web 或桌面产品宣传片的镜头语言、真实页面运镜、节拍和声音设计。前者重在编排整条管线，后者重在把产品 UI 做成可修改、可进入版本控制的发布视频。

先从画廊挑镜头

截至 2026 年 9 月 20 日核对，官方 README 列出 157 张镜头配方卡和 214 条动态样片。在线 Gallery 支持搜索、筛选、切换样式和多选复制镜头卡名称。每张卡不仅给出“淡入”或“缩放”这类效果名，还记录用途、能量、建议时长、参数、实现要点和已知陷阱，并配有 Remotion TSX 参考实现。

例如 deck-deal-flyin 用发牌式加速度展开卡片，spotlight-hero-card 用聚光与推近突出主角，before-after-slider-scrub 用滑杆展示处理前后差异。镜头卡是可复用的运动语言，不是必须照搬的视觉皮肤；目标产品自己的字体、配色、材质和信息密度仍应优先。

三条制作路线

如果用户已经点名 Ink Press 或某张镜头卡，Skill 会将其视为硬约束；如果只提供项目路径或网址，流程会先检查产品，再解释可用路线。对第一次尝试的团队，更稳妥的入口不是立即制作完整宣传片，而是在 Gallery 选 2–3 张卡，先做一段 5–10 秒短片，确认真实页面采集、品牌适配、渲染速度和审片方式都能接受。

从页面到成片

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

项目强调“一个镜头只讲一个主要动效”，并为信息落定后的停留时间预留帧数；面对强节奏音乐，还会先分析 BPM 与相位，再把转场放到拍点上。这些规则不能自动保证审美质量，但能把“成片不像产品发布视频”拆成运镜、节奏、光影、声音和数据等可检查问题。

交付后还能继续改

2026 年 9 月加入的 Motion Workbench 改变了项目的交付方式。Skill 完成影片后，可以执行 node workbench/scripts/open.mjs <成片工程目录>，在本机浏览器打开类似剪辑软件的工作台。成片会按镜头、转场、字幕和音效拆成多轨；用户可移动、裁切、分割或变速片段，也能修改开放出来的文案、字号、颜色与图层属性。

工作台文档列出 216 张可拖入时间线的 demo 动效；这里的 216 是工作台素材库口径，在线 Gallery 的公开动态样片仍为 214 条，不应把两组数字当成同一计数。工程修改默认保存在浏览器 localStorage，也可导出 JSON；最终仍由 Remotion 渲染。它降低了交付后改字、调时长和换动效的门槛，但不是通用 NLE，也不等同于 Premiere 或剪映的完整功能。

安装与渲染

最快的安装方式是让 Agent 处理仓库链接，或在适合的 Node.js 环境中运行：

npx skills add Vincentwei1021/video-shotcraft

手动方式是克隆仓库，再链接到 ~/.claude/skills/video-shotcraft 或 ~/.codex/skills/video-shotcraft。随附模板当前固定使用 Remotion 4.0.484、React 19.2.7 和 TypeScript 6.0.3。版本固定有助于复现仓库已有成片，但接入现有工程时仍要检查依赖冲突。

无头 Linux 环境并非完全开箱即用。README 记录了三类限制：低核心机器可能需要把并发降为 1；新版 Chromium 移除了旧 Headless 模式，可能要使用 chrome-headless-shell；无法访问 Remotion 下载地址时，需要通过 --browser-executable 指定本地浏览器。团队应先固定仓库 commit 与依赖锁文件，跑通短片后再接入 CI。

剪映导出有平台边界

成片还可以导出为剪映工程草稿：视频按镜头切段，字幕重建为原生文本轨，SFX 与 BGM 放到独立音轨，方便继续变速、重排和改文字。官方说明已在 macOS 的剪映专业版 11.2 验证；仓库目录明确标注 Windows 路径尚未验证。因此，Windows 用户不应把该功能视为已经确认可用，正式项目前应先用副本测试安装与打开结果。

许可需要分层核对

仓库自身采用 Apache-2.0，但这不代表所有依赖、音频和演示素材都自动采用同一许可证。Remotion 有独立许可，个人与小团队和公司场景的条件不同，商业使用前应按使用时的官方条款确认。仓库的产品截图只是演示资产，发布成片前必须换成目标产品自己的截图，并检查客户信息、账号、个人数据和实时业务数据是否需要脱敏。

音频目录包含 5 首 BGM 和 149 个 SFX，主要来源为 Mixkit，并在 ATTRIBUTION 文件中记录对应来源。不过其中首批沿用的 bgm-tech-house.mp3 无法逐曲反查，仓库也明确提示商用前复核。商业交付不能只查看根目录 LICENSE，就默认音乐、音效、商标、截图和第三方框架全部可以按 Apache-2.0 使用。

当前维护状态

截至 2026 年 9 月 20 日，video-shotcraft 约有 9,053 Stars、814 Forks 和 6 个 open issues；仓库创建于 7 月 19 日，最近一次推送为 9 月 9 日。最新 Release 为 9 月 1 日发布的 showcase-media，用途是承载展示素材，不是语义化稳定版本。快速增长和近期提交说明项目仍在变化，但 Stars 不能替代长期维护、兼容性或交付质量判断。

它适合会使用 Codex 或 Claude Code、能够运行 Node.js 工程并愿意逐帧审片的前端团队、独立开发者和产品营销人员。若需求是上传一句文案就获得稳定商业成片，它不是直接替代品；若目标是把真实产品 UI 做成可修改、可复用、能进入版本控制并可在交付后继续编辑的宣传视频，它提供了较完整的镜头语言与生产检查路径。

项目入口

• video-shotcraft GitHub 仓库
• 动态样片画廊：https://vincentwei1021.github.io/video-shotcraft/
• Skill 使用说明
• Motion Workbench 图文指南
• 剪映工程导出说明