video-shotcraft：124 张镜头卡配一支 36 秒模板，模型费 0 美元、本机渲 139 秒，要付的钱在 Remotion 和音效授权上
今天拆的是 video-shotcraft：把产品宣传片拆成 124 张镜头配方卡的编码 Agent 技能包，模型费 0 美元、36 秒模板在本机 139 秒渲完；文章给出它在链条上的位置、五步上手路、十六处已知阻塞，以及三层许可里真正要付钱的那两层。
给 Claude Code 或 Codex 装上一个技能包，说一句「用 video-shotcraft 给我的产品做一支宣传片」。它会先把你的页面在本地跑起来，按 2 倍像素整页截图、按元素抠图、记下每个元素的坐标1。
然后它从 124 张镜头配方卡里挑镜头、排分镜，用 Remotion 逐帧画成一支 1920×1080、30fps 的 MP42。
这条路按秒计费的视频模型插不进来。每一帧都是代码从你自己的截图和文案里画出来的，所以画面里的字是清楚的，配色是你产品的配色，改起来改的是源码。
今天要回答四件事：它在链条上站在哪一层，最短几步能出片，装进去会在哪一步卡住，许可与真实花销怎么算。
先把今天实测的四个数摆出来（2026-10-27，2 核容器，Node 22.13.1，ffmpeg 7.1.5）：
- 仓库 clone 下来 120 MB；
- 模板
npm install装 184 个包，2.7 秒，node_modules290 MB； - 模板整片 1085 帧，
--concurrency=1渲完 139 秒； - 成片 1920×1080、30fps、36.224 秒、20.5 MB，h264 加 aac。
项目自己的数字有三套，得先对齐。仓库简介写的是「152 shot recipe cards, 209 motion previews」1；站内首屏写 124 张卡、150 个镜头、150 条样片、36.2 秒模板3；工作台的总览图里写「动效 220 卡（4 张可调）」4。
以仓库里的文件为准：
references/shots/ 下有 124 个 *.md，分 10 类，这就是那 124 张卡；gallery/api/library.json 里 cardCount 是 124、styleCount 和 previewCount 都是 1505。
仓库首页：13.8k star、Apache-2.0、10 个开放 issue、2 个 tag；右侧 About 栏那句「152 shot recipe cards, 209 motion previews」就是上面那套对不上的数字之一；2026-10-27 截图。
项目站内首屏自报的四个数字：124 张配方卡、150 种样式、150 条动态样片、36.2 秒的现成模板；2026-10-27 截图。
它在链条上站在哪一层
这一层最容易看混。做 Agent 视频的仓库现在分三类，混在一起看就会拿错工具。
第一类是渲染底座，负责把代码变成视频文件。Remotion 在这一层，第 23 期拆过；HyperFrames 也在这层，把 HTML 渲成片，第 14 期拆过。
第二类是工作流描述语言，负责说清片子里有哪些镜头、每一拍讲什么。hypit 的 SVML 在这个位置，VibeFrame 的
scenes/*.md 加十六个 cue 词也在这个位置，第 41 期拆过。第三类是方法论与资产：没有自己的引擎，也没有自己的时间线，价值全在「镜头怎么写」和「素材从哪来」。
video-shotcraft 站第三层，而且站得很彻底。它把像素交给 Remotion，把时间线交给工作台与剪映。模板里钉的是
remotion 4.0.484、@remotion/cli 4.0.484、React 19.2.76。把同一天翻到的几个项目摆在一起，这一层的边界就清楚了：Concat、BaoCut、WeftCut 给的是可编辑时间线，第 16、19、38、30 期分别拆过；OpenMontage 自带引擎和一整条流水线，第 22 期拆过。
你要问的问题因此很具体：我缺的是引擎，是描述语言，还是「镜头到底怎么调」这套手艺。只有第三种人，今天这篇才有用。
它在这一层怎么做事
仓库里真正被 Agent 读的是
SKILL.md，20,853 字节，第一件事是让你选模式。模式选错会白跑一遍，三条路各读一份文档：- 套模板：读
template/TEMPLATE.md，把截图、文案、品牌换进已有的 36.2 秒结构； - 自主创作：读
references/pipeline.md，Agent 一路做到终检，中途不停下来问； - 共同创作：读
references/guided-free-creation.md，在产品简报、视觉方向、镜头映射、最终分镜四处让你签字
脚本开头写着三条硬前提，第三条是红线：截图前页面必须填好「虚构但真实感」的演示数据。空库截出来的图直接废片，真实客户数据则不能出片。
镜头卡是这套东西的主体。随手打开一张
spotlight-hero-card，里面是满满一份施工图8：- 时长写 172 帧，锁定在第 34 帧、触地第 142 帧、末尾 30 帧真静止；
- 相机从整页 zoom 0.8 推到 2.6，
rotY34° 主导、rotX只 8°、persp1200，推完锁死； - 光池半径 400 收到 300、锁定瞬间加 6% 脉冲，关灯时整页压到 6–14% 亮度；
- 参数表逐条写「调节手感」，比如「<0.8 读作调暗的页面，>0.96 邻卡完全消失」；
- 末尾列「已知坑」，包括逐卡闪烁被两次否决、注记必须单独画在灯光层之上。
一张卡还配一份 demo 源码，路径写在卡尾。SKILL 要求 Agent 先按卡名校验，再读卡全文，再按路径读 demo 全文，最后把
assets/lib/ 里对应组件 copy 进项目，理由是「demo 源码才是调校过的参数真相」2。
spotlight-hero-card.md 的文件页，能看到卡头、动效核心、参数表三段。页面顶上的红条是 GitHub 的 YAML 预览报错，因为卡头用的是「一句话 / 适用 / 时长 / 能量 / 标签」这些中文键；2026-10-27 截图。自主创作模式下跑的是八阶段流水线，从阶段 0 的产品理解到阶段 7 的独立终检9。SKILL.md 开篇却写着「六阶段工作流」，两处对不上，排工期按 pipeline 的八段算。
有两处约束很硬，值得单独记。一是确定性渲染，全库禁用
Date.now() 和 Math.random()，伪随机一律固定种子。二是终检要交给一个「干净上下文的 subagent」，理由写在 SKILL 里：制作者对自己的产出有确认偏差2。
你要给什么，它交回什么
你要给的东西比预想的多一项。产品能在本地跑起来是前提，另外三项是素材、文案和设计令牌。
| 你给 | 具体是什么 |
|---|---|
| 能跑的产品 | 本地 dev server 可访问；桌面端产品用窗口截图 |
| 可截的页面状态 | 截图前填好虚构演示数据，客户与个人信息先脱敏冻结 |
| 文案与品牌 | 一句话用途、受众、核心卖点、标志与配色 |
| 设计令牌 | 字体、字号层级、行高、栅格、圆角、背景与强调色 |
它交回来的东西有五件，前四件随片交付：
| 产出 | 规格与说明 |
|---|---|
| 成片 | MP4，1920×1080、30fps、h264，含音效；配 BGM 的片子交带 BGM 与无 BGM 两版 |
| Remotion 工程 | 每个镜头一个 React 组件，你和 Agent 都能改 |
| 动效工作台 | 浏览器里打开，成片拆成镜头、转场、字幕、音效多轨，改完导出 |
| 剪映工程 | 可选，底片按镜头切段、字幕重建为原生文本轨、音效独立音轨 |
| 社交发布 | 可选，需要你自己的 Upload-Post key，先 dry-run 再发 |
仓库自带的
workbench/docs/overview.png：左边是成片单元库，中间是预览，底部把 37 秒的片子拆成转场、字幕、镜头、音效四类轨道，右侧是选中镜头的字标、字号、字色与变速属性。它的边界也清楚。真实拍摄的素材、生成式的人物与场景，这条路都没有；它画的是你页面截图的运动。
片子超过一分钟、镜头要全新写时，卡库只帮你选运动语法。创意和叙事仍然得你自己出。
最短上手路径
五步，前四步今天都在这台 2 核机器上走通了。
第一步，装。文档给了两条路：把仓库链接丢给 Agent，或者
npx skills add Vincentwei1021/video-shotcraft。后一条实测能跑，它会列出支持的 73 个 Agent，然后停下问你装到项目还是全局，脚本化环境里需要人点一下。非交互的路子是 clone 加软链：
git clone https://github.com/Vincentwei1021/video-shotcraft.git
cd video-shotcraft
ln -s "$(pwd)" ~/.claude/skills/video-shotcraft # Claude Code
ln -s "$(pwd)" ~/.codex/skills/video-shotcraft # Codex第二步，跑模板，确认渲染链通。
cd template && npm install 实测 184 个包、2.7 秒；然后渲一帧静帧：npx remotion still src/index.ts AiflPromo out/qa/f120.png --frame=120 --concurrency=1第一次渲会从
remotion.media 下 91.9 MB 的 chrome-headless-shell，本机实测能下完，随后才因为并发上限报错。国内网络这一段经常失败，README 的 Linux 一节给了绕法。第三步，机器核数少就加
--concurrency=1。不加的那一次，实测直接报 Maximum for --concurrency is 2，一帧都没渲出来。第四步，整片渲染。
npx remotion render src/index.ts AiflPromo out/promo.mp4 --concurrency=1，1085 帧、139 秒，出 36.2 秒的片。第五步，交付后打开工作台：
node workbench/scripts/open.mjs <成片工程目录>它起 5198 端口的 dev server 并自动导入成片。工程里要先有
src/workbench.ts 清单，模板自带。真正做自己的片子，中间还要加一步：改
capture-template.mjs 顶部的 BASE、路由和选择器，跑采集，再进流水线。模板路线省下的是这一步之外的全部设计与调参。
模板自带的 Ink Press 片第 120 帧，2026-10-27 在本机实渲。画面里的研究管理界面是模板的虚构演示数据，
TEMPLATE.md 与 README 都要求对外发片前整套替换成自己的截图并脱敏。会卡住的地方
下面 16 条按「症状 → 触发条件 → 现状 → 你能怎么办」写，每条都标了出处与日期。
1. 三个数字对不上
症状：按仓库简介估算产能，装完发现少了三成。
触发：拿「152 张卡、209 条样片」当基数。
现状：仓库简介写 152 / 209（2026-10-27 截图）；站内写 124 / 150 / 150（同期）；工作台写「动效 220 卡」（同期）。
你能怎么办：以
references/shots/ 下的 124 个 md 文件为准，一条命令就数得出来。2. 卡片页在 GitHub 上带红条
症状：每张卡的文件页顶部一条
Error in user YAML。
触发：在网页上读卡。
现状：卡头用中文键，GitHub 的 YAML 预览解析不了（2026-10-27 实见）。
你能怎么办：读 raw 或本地文件，内容本身完整。3. 低核机器上一帧都渲不出
症状：
Maximum for --concurrency is 2。
触发：在 2 核或更少的机器上跑 remotion still / render。
现状：实测复现；README 的 Linux 注意事项第 1 条也写了。
你能怎么办：加 --concurrency=1。4. 首渲卡在下载
症状：headless shell 下载失败，渲染起不来。
触发：访问不到
remotion.media。
现状：实测要下 91.9 MB；README 明写国内常见失败。
你能怎么办：预先放好 chrome-headless-shell，用 --browser-executable=<路径> 指过去。5. Windows 上工作台打不开
症状：Vite 报语法错，或点「导出成片」后浏览器显示无法连接。
触发：在 Windows 10/11 上跑
workbench。
现状：issue #102（2026-10-13 开，未合并）列出四处，最要命的一处是反斜杠 import 让 esbuild 挂、导出时 spawn("rsync") 不存在并把 dev server 进程打死10。
你能怎么办：先在 Mac 或 Linux 上用工作台。6. 剪映导出只在 Mac 验过
症状：Windows 上导出的草稿打不开。
触发：在 Windows 上导出剪映工程。
现状：
jianying-export.md 写明 Mac 剪映专业版 11.2 实测通过，Windows 按上游支持路径实现、未真机验证11。
你能怎么办：先跑 jianying-export/smoke_test.py。7. 剪映草稿是单向的
症状：在剪映里改完，想回脚本里再导一次，改动没了。
触发：把剪映当工作区用。
现状：文档写明剪映打开明文草稿后会加密保存，要改就改脚本重装（幂等覆盖）。
你能怎么办：把导出脚本当唯一真源，剪映只当审片窗。
8. 首批音效有几个查不到来源
症状：商用成片里用了这批老音效，来源无法举证。
触发：用了首批 11 个音效里的
keyboard、pop、riser-cine、sparkle、whoosh-big 等。
现状：ATTRIBUTION.md 的正文写「剩余 6 个仍无法反查」，表里逐条标出的是 5 个（2026-10-27 读）12。
你能怎么办：换用有 Mixkit 原始 URL 的那些，两批扩充的 138 个都带曲目页。9. 一首 BGM 同样无法反查
症状：配乐用在对外成片里，说不清授权。
触发：选了
bgm-tech-house.mp3。
现状：表里写「首批沿用，无法逐曲反查」；另外四首都带 Mixkit 曲目页。
你能怎么办：只用有 URL 的四首。10. Remotion 授权在 4 人以上的公司不再免费
症状：片子做完，法务问渲染引擎的授权。
触发：公司超过 3 人且对外商用。
现状：Remotion 定价页（2026-10-27 读）：个人与 3 人以内公司免费、含商用；超出后「Automators」每次渲染 0.01 美元、每月最低 100 美元，或「Creators」每席位每月 25 美元13。
你能怎么办：按渲染次数或按席位二选一，问清楚再开工。
11. 模板里的数据是别人的
症状：片里出现了不该出现的客户名与数字。
触发：直接拿模板渲染对外发。
现状：
TEMPLATE.md 注明截图来自一个内部研究管理工具、数据为虚构演示；README 要求发布前整套替换并确认脱敏。
你能怎么办：先换素材，再谈渲不渲。12. 产品跑不起来就截不了图
症状：采集脚本连不上页面。
触发：产品只有线上 SaaS 版，或只有移动端。
现状：脚本硬前提是
BASE 可访问；桌面端要用窗口截图，移动端没有现成方案。
你能怎么办：先在本地搭一个可截的演示环境。13. 安装是交互式的
症状：
npx skills add 跑到一半停下等选择。
触发：在 CI 或脚本里装。
现状：实测它会先列出支持的 73 个 Agent，再让你选装到项目还是全局。
你能怎么办：用 clone 加软链那条路。14. 没有版本号可钉
症状：想固定一次可复现的版本，找不到 release。
触发：把技能当依赖管理。
现状：2 个 release 都是媒体资产（
showcase-media、gallery-media）14；plugin.json 的 version 固定写 1.0.015；主分支 106 次提交。
你能怎么办：按 commit 钉 clone。15. 社交发布要自己的 key，两处口径还不一致
症状：想一句话发到 TikTok，脚本报没配置。
触发：用
publish/upload_post.py。
现状：项目文档写免费版每月 10 次、不含 TikTok16；Upload-Post 自己的价格页把 TikTok 列在免费档里，2 个 profile、每月 10 次上传17。
你能怎么办：按你自己后台实际能连上的平台为准，先 dry-run。16. 阶段数写得不一致
症状：按 SKILL 的「六阶段」排工期，做到第四步发现还有一半。
触发：只读了 SKILL.md 开篇。
现状：
references/pipeline.md 是八阶段（0–7），且阶段 0–3 的判断在自主模式下由 Agent 自己记录。
你能怎么办：按 pipeline 排，把阶段 7 的终检算进去。许可与真实成本
许可分三层，要分开看。
音频另算。
ATTRIBUTION.md 逐条记了来源：两批扩充音效共 138 个全部来自 Mixkit，标明「Mixkit Sound Effects Free License（免署名可商用）」；5 首 BGM 走 Mixkit 的 Stock Music Free License12。首批那 11 个音效里，有 5 到 6 个连原始条目都查不到，文档自己标了「商用前须确认」。Mixkit 的许可页也写明，它的视频、音乐、音效、模板各有一套许可，用之前要对上手里那一个18。
渲染引擎的授权跟项目无关，是 Remotion 自己的：个人与 3 人以内公司免费，超出按渲染次数或席位付费13。
把这些折成一张你今天真要付的账：
| 项 | 价格 | 说明 |
|---|---|---|
| video-shotcraft | 0 美元 | Apache-2.0，无付费档 |
| 视频模型 | 0 美元 | 这条路不调用按秒计费的模型 |
| Remotion（≤3 人） | 0 美元 | 含商用 |
| Remotion（4 人以上） | 0.01 美元/次渲染，每月最低 100 美元；或 25 美元/席/月 | 二选一 |
| 编码 Agent | Claude Pro 17 美元/月（年付，月付 20）；Max 自 100 美元/月，含 100–200 美元 API 额度 | 干活的其实是它19 |
| 社交发布（可选） | 免费 10 次/月，付费自 16 美元/月 | 要自己的 key17 |
| 磁盘 | 仓库 120 MB + 依赖 290 MB + 浏览器 92 MB | 还没算工程素材 |
对比上一期那条路：VibeFrame 给一支 30 秒片的 dry-run 报价是 10.63 美元，全是模型费。video-shotcraft 的模型费是 0，代价换成三样——你的 Agent 订阅、Remotion 的授权门槛，以及在本机等渲染的时间。
时间这笔账可以按实测折算：2 核机器、
--concurrency=1，1085 帧 139 秒，约每秒成片 3.8 秒渲染。60 秒的片子单次渲染约 4 分钟；改一版重渲一版，稿子多改五轮就是一个下午。和之前几期放在一起看
星标数全部是 2026-10-27 当天重取的，同一天的数字才能横向比。
| 方案 | 你给它什么 | 它给你什么 | 它在这一层 | 许可与公开体量 |
|---|---|---|---|---|
| video-shotcraft | 能本地跑的页面、文案、设计令牌 | 1080p 成片 + Remotion 工程 + 工作台 | 方法论与资产 | Apache-2.0，13,817 star |
| Remotion | React 组件与时间线 | 逐帧渲染出的视频文件 | 渲染底座 | 两层授权，67,886 star |
| HyperFrames | HTML 页面 | 渲出来的视频 | 渲染底座 | Apache-2.0，73,026 star |
| OpenMontage | 一句话与素材 | 自带引擎跑完整条流水线 | 全流程应用 | AGPL-3.0，72,168 star |
| hypit | SVML 源码 | 本地渲染 + 可换模型供应商 | 描述语言 + 渲染 | 改过的 Apache-2.0，25,869 star |
| lemo-opuscar | 选题与画风 | 51 种画风各一支纯代码片 | 方法论与资产 | MIT，8,054 star |
| claude-code-video-toolkit | Claude Code | 13 个技能、15 条命令、4 套模板 | 方法论与资产 | MIT，2,351 star |
| vox-director | 一句选题 | Vox 风拼贴解说片 | 技能包 + 付费生成 | MIT，2,470 star |
| Frametell | 想法与素材 | 导演 Agent 先出分镜等你签字 | 桌面应用 | AGPL-3.0，410 star |
把它放进这张表，位置就清楚了：它和 claude-code-video-toolkit、lemo-opuscar 是同一层的三种做法。claude-code-video-toolkit 把工序拆成 13 个技能，lemo-opuscar 把画风做成 51 套皮肤，video-shotcraft 把镜头做成 124 张卡加一支可以照着换皮的模板。
它还有同作者的第二个库
video-talkcraft，1,788 star，做口播视频，109 张动效卡，节拍全部钉在人声上20。两条产品线的资产各管各的，装一个不会顺带得到另一个。今天该不该动手
今天就动手，如果这三条同时成立：你手里的产品能在本地跑起来；你要的是一支 30 到 60 秒的发布片或介绍片；团队在 3 人以内，或者已经愿意为 Remotion 付授权。
它省掉的那一段最难自己写：一个镜头从相机第几帧推到几倍、光池从多大收到多大、卡落回原位要几帧。这些数字今天在 124 个 md 文件里摊开摆着，Agent 直接读。
先收藏，如果这几种情况里你占了一条：你在 Windows 上工作，且一定要用工作台；你的片子要在剪映里反复改（导出是单向的）；你还没定自己的视觉方向，只想先看看别人怎么做。这三条都属于装上了也用不起来的情况。
跳过，如果有下面任一条：你需要生成式画面，比如人物、实拍感、不存在的场景，这条路一帧也给不了。你手里的素材已经是拍好的片子，要的只是把它剪出来，那该看 Concat、BaoCut、WeftCut 那一类可编辑时间线。你的片子是短剧或动画短片，卡库给的是镜头之间的运动语法，长叙事它管不到。
最后一句判断留给读者自己：这套东西的门槛在你能不能讲清楚「我这支片要讲哪几件事」。
讲清楚了，124 张卡是加速器；讲不清楚，它会认真地帮你把一支没有重点的片子做得很好看。
References
- 1video-shotcraft 仓库
github.com
- 2SKILL.md
github.com
- 3video-shotcraft 画廊
vincentwei1021.github.io
- 4workbench/docs/overview.png
github.com
- 5画廊索引 library.json
vincentwei1021.github.io
- 6template/package.json
github.com
- 7assets/scripts/capture-template.mjs
github.com
- 8
- 9references/pipeline.md
github.com
- 10issue #102
github.com
- 11references/jianying-export.md
github.com
- 12assets/audio/ATTRIBUTION.md
github.com
- 13Remotion License & Pricing
remotion.dev
- 14Releases
github.com
- 15.claude-plugin/plugin.json
github.com
- 16references/publish-upload-post.md
github.com
- 17Upload-Post 价格页
upload-post.com
- 18Mixkit License
mixkit.co
- 19Claude 价格页
claude.com
- 20video-talkcraft
github.com
This story was produced automatically by a channel. One sentence is all it takes for Neodrop to keep producing for you.