模板档还是手写档?wallstreet-explainer两种出片方案新手选型指南(附场景决策表)
模板档还是手写档?wallstreet-explainer两种出片方案新手选型指南(附场景决策表)
wallstreet-explainer 是一个做「华尔街式」财经/科技解读短片的开源 skill:给它一个选题,它会写文案、找素材、配音、出片。工具最大的特点,是提供模板档和手写档两种出片方案——画风完全一样,但写法和工作量差别很大。新手如果一开始选错方案,最容易在"画面动效"上反复返工。本文用一张决策表,帮你按自己的场景快速定档。
先对齐概念:同一个画风,两条出片路径
wallstreet-explainer 的成品风格是固定的:真实的新闻截图和实拍作证据、金色大数字、深蓝织物底、镜头一直在走。两种方案只是"用多少代码来描述每一镜画面"的区别:
| 模板档 | 手写档 | |
|---|---|---|
| 一句话解释 | 一条片 = 一张镜头表,每镜选一个现成场景 | 逐镜手写,每帧画面自己搭 |
| 依赖 | kit/ 里 33 个场景模板 | 底座 scripts/film_base.js + 手法库 scripts/moves.js + 2.5D 工具 scripts/stage25d.js |
| 谁管镜头、运动模糊、字号颜色 | 模板全管 | 你自己管 |
| 出片稳定性 | 高(设计目标就是"弱一点的模型也能稳定出片") | 取决于写代码的一方水平 |
| 自由度 | 33 个场景的词汇表 | 无上限,但要自己守住风格 |
样片效果参考(无人出镜版《AI 到底有多烧钱》,77 秒,GIF 为前 29 秒):
完整说明见 SKILL.md,两条样片的文案与画面代码都在 examples/ 里。
模板档:一条片 = 一张镜头表
模板档是默认推荐。它的设计思路是:把"镜头怎么走、东西怎么出现、前后层、运动模糊、字号颜色"全部沉进模板,你只负责决定每一镜"说什么、放什么"。
33 个场景的总览(示例片截图,占位图,正式片里要换成真素材):
镜头表怎么填
每一镜就是 film.js 里的一个对象,核心只有 4 个字段:
{scene:'number', until:'@b03', says:'四家加起来一年砸七千多亿',
value:'$7250亿', brow:'四家 · 2026 AI 资本开支'}
| 字段 | 写什么 |
|---|---|
scene |
场景名,如 number(大数字)、desk(新闻桌面)、chart(图表) |
until |
这一镜到哪一刻结束,挂在"念到哪个字"上,不写死秒数 |
says |
这一镜让观众多懂了什么——写不出来就说明这一镜没想清楚 |
enter |
可选,这一镜怎么接上一镜('flat' 倒成桌面、'push' 横推换人等) |
几个典型场景长这样:
场景怎么选?kit/README.md 最前面有一张"这句话在说什么 → 场景"的决策表:先写 says,再找意思对得上的那一行;"只是差不多"就换一个,或改用 custom 手写。
模板档的出片流程
node scripts/new_film.mjs my_film # 建片子目录(脚本清单见 scripts/)
node scripts/timeline_stub.mjs my_film/script.json # 还没配音?按字数估时间线
node scripts/render.mjs --dir my_film --check # 几秒钟自检:报错+提醒
node scripts/render.mjs --dir my_film --sheet # 每镜三帧拼一张图,先看静态
node scripts/render.mjs --dir my_film --video --h 720 # 渲 720p 看动起来
关键点是 scripts/render.mjs 的 --check:它用文字报出镜头表里的错误和节奏问题(词找不到、没写 says、还在用占位素材、开口太晚……),改到没有错误再往下走。这意味着即使执行方"看不了图",也能靠这份自检把质量守住——这是模板档对新手最友好的地方。
手写档:在底座上逐镜手写
手写档给两类人:强模型自由发挥,或模板对不上的镜头。它的"骨架"是:
- 底座 scripts/film_base.js:读时间线、
shot(t0, t1, fn)一镜一镜登记、seek(t)按时刻取帧。同一个t永远画出同一帧,不依赖播放时钟; - 手法库 scripts/moves.js:磨过、逐帧查过的现成动作——横推换人、巨字随话翻、原文倒成桌面、推过镜头……只管动作,画面由片子传,调用时要写清
why; - 2.5D 小工具 scripts/stage25d.js:分层相机、运动模糊、景深、巨字等工具函数。
写法上的核心差异:模板档是"填表",手写档是"编程"。每一镜要自己写机位路径、每一层的 z 值、状态随时间怎么变。代价是自由度更高,收益是要自己守住风格规矩。
《AI 到底有多烧钱》第六版就是用底座 + 手法库重拼的,四个招牌动作的连续帧如下(新闻桌面滑动、人物挪进巨字、横推换人、原文倒成桌面图表立起来):
代码可以读 examples/ai-burn-money/film_lib.js:14 镜里 10 镜用了手法、4 镜全手写,每处手法都写了 why。注意它是只读参考——学的是"手法怎么嵌进画面",不要照抄镜头。
画风的基准是成片,不是模板
无论哪种方案,交片前的硬步骤都一样:720p 每秒抽一帧,和原版《AI 到底有多烧钱》的每秒一帧并排比(底色、颜色光、真素材比例、小字密度都不突兀)。这张基准图就是 examples/ai-burn-money/frames_1fps.jpg:
怎么选?场景决策表 🧭
| 你的场景 | 推荐方案 | 理由 |
|---|---|---|
| 第一次用,做第一条片 | 模板档 | 模板管动效 + --check 文字自检,稳定性最高,摔不了大跤 |
| 标准财经/科技讲解(大数、图表、新闻证据、人物) | 模板档 | 33 个场景覆盖"数和钱 / 关系结构 / 人 / 真画面证据 / 结构包装"五类表达 |
| 有口播视频(真人或数字人) | 模板档 + 口播层 | kit/host.js 的口播层叠在任何模板场景上(挂墙、圆窗、竖窗),不用改走手写 |
| 某一镜对不上任何场景 | 模板档 + scene:'custom' |
其余镜头仍享受模板稳定性,只手写那一镜(也要写 says) |
| 强模型,想要独特运镜和自定义转场 | 手写档 | 手法库 + 2.5D 底座自由组合,风格由自己守 |
| 赶时间,1 分钟内快速出片 | 模板档 | timeline_stub.mjs 不用配音就能先估时间线跑通流程 |
有口播视频的场景,样片《打仗了,黄金为什么反而跌》(28 秒,数字人口播)走的就是模板档 + 口播层,效果如下:
两条补充判断:
- 默认模板档起步。官方的设计意图写得很直白:"让弱一些的模型也能稳定出片";而且手写档的两件核心资产(底座、手法库)本身就是模板档的接法所用,两者不是对立的。
- 不要为了"用上模板"硬塞场景。references/thinking.md 的原则是:先想这一镜让观众多懂什么,再找最对得上的场景,对不上就
custom手写。
两种方案可以混着用
实际项目中更常见的组合是"模板为主、局部手写":
- 镜头表里某镜写
scene:'custom',在render(c)里调用 scripts/moves.js 和 scripts/stage25d.js 的工具手写那一镜; - 跑
render.mjs --moves可以统计全片手法用量,加--prev和上一条片对比,避免镜头排布照抄; - 手写镜头同样要过 references/motion.md 的三句判断(删掉它观众少懂什么?是镜头在动还是元素自己在演?这一层是真的吗?)和 references/rules.md 的硬规矩。
新手起步路径:三步走
- 跑通演示片:
node scripts/new_film.mjs demo_dir --demo,建出来就能渲。它能跑通 22 个场景,只用来学镜头表写法(kit/demo/、kit/demo2/); - 照模板档流程做自己的第一片:从 starter/ 起步,
script.json写文案 →timeline_stub估时间线 → 填镜头表 →--check改到没错误 →--sheet看图 → 720p 看动效。每站停下给用户看,点头再往下; - 读案例学"怎么想":examples/ai-burn-money/(77 秒,六个版本的完整记录)、examples/google-apple-20b/(28 秒,真素材手写)、examples/gold-rates/(28 秒,真人口播)。重点看各自的导演表和"摔过的跤",不要照搬镜头顺序。
常见问题 FAQ
Q:模板档会不会显得"模板化"、像 PPT?
模板管的是"怎么动"的下限,says 和真素材是你自己控的。它的默认画风本来就是照着两条成片返工的:细斜纹深蓝织物底、真素材镜头不少于四成、图形只演钱和关系。PPT 感来自"元素自己演入场",模板的默认动效(东西朴素出现、镜头去找它)恰好排除了这类写法。
Q:新手需要学手写档吗?
先把模板档跑通一条完整片子,再打开 film_lib.js 读一遍。等真的遇到模板对不上的镜头,再按需看底座三件套——这正是 scene:'custom' 存在的意义。
Q:怎么判断成片质量过不过关?
三步:--check 无错误且每条提醒都答得上"为什么";--sheet 看过每镜的头中尾三帧;720p 每秒一帧与 frames_1fps.jpg 并排比。做法细则在 references/review.md。
Q:换了配音,时间线要全部重排吗?
不用。时刻一律写成 '@句id:词' 挂在字上,换配音后重新对齐时间线即可,全片自动顺延——两种方案共享这套写法。
一句话总结:先用模板档把第一条片做出来,遇到对不上的镜头用 custom 补一手写,整片想自由再切手写档——风格是同一个,选对路径,出片快一倍。






