模板档还是手写档?wallstreet-explainer两种出片方案新手选型指南(附场景决策表)

原创2026-11-12 22:41:021,942 阅读

模板档还是手写档?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 秒):

wallstreet-explainer 无人出镜财经解读短片样片:深蓝织物底配金色大数字

完整说明见 SKILL.md,两条样片的文案与画面代码都在 examples/ 里。

模板档:一条片 = 一张镜头表

模板档是默认推荐。它的设计思路是:把"镜头怎么走、东西怎么出现、前后层、运动模糊、字号颜色"全部沉进模板,你只负责决定每一镜"说什么、放什么"。

33 个场景的总览(示例片截图,占位图,正式片里要换成真素材):

wallstreet-explainer 模板档 33 个场景总览:大数字、图表、新闻桌面、人物等场景

镜头表怎么填

每一镜就是 film.js 里的一个对象,核心只有 4 个字段:

{scene:'number', until:'@b03', says:'四家加起来一年砸七千多亿',
 value:'$7250亿', brow:'四家 · 2026 AI 资本开支'}
字段 写什么
scene 场景名,如 number(大数字)、desk(新闻桌面)、chart(图表)
until 这一镜到哪一刻结束,挂在"念到哪个字"上,不写死秒数
says 这一镜让观众多懂了什么——写不出来就说明这一镜没想清楚
enter 可选,这一镜怎么接上一镜('flat' 倒成桌面、'push' 横推换人等)

几个典型场景长这样:

wallstreet-explainer 模板档 number 场景:金色渐变大数字配品牌色圆盘

wallstreet-explainer 模板档 desk 场景:多篇新闻截图摊在织物桌面上

场景怎么选?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 到底有多烧钱》第六版就是用底座 + 手法库重拼的,四个招牌动作的连续帧如下(新闻桌面滑动、人物挪进巨字、横推换人、原文倒成桌面图表立起来):

wallstreet-explainer 手写档连续帧:新闻桌面滑动、人物站在巨字前、横推换人四个动作

代码可以读 examples/ai-burn-money/film_lib.js:14 镜里 10 镜用了手法、4 镜全手写,每处手法都写了 why。注意它是只读参考——学的是"手法怎么嵌进画面",不要照抄镜头。

画风的基准是成片,不是模板

无论哪种方案,交片前的硬步骤都一样:720p 每秒抽一帧,和原版《AI 到底有多烧钱》的每秒一帧并排比(底色、颜色光、真素材比例、小字密度都不突兀)。这张基准图就是 examples/ai-burn-money/frames_1fps.jpg:

wallstreet-explainer 成片基准:《AI到底有多烧钱》每秒一帧抽帧对比图

怎么选?场景决策表 🧭

你的场景 推荐方案 理由
第一次用,做第一条片 模板档 模板管动效 + --check 文字自检,稳定性最高,摔不了大跤
标准财经/科技讲解(大数、图表、新闻证据、人物) 模板档 33 个场景覆盖"数和钱 / 关系结构 / 人 / 真画面证据 / 结构包装"五类表达
有口播视频(真人或数字人) 模板档 + 口播层 kit/host.js 的口播层叠在任何模板场景上(挂墙、圆窗、竖窗),不用改走手写
某一镜对不上任何场景 模板档 + scene:'custom' 其余镜头仍享受模板稳定性,只手写那一镜(也要写 says)
强模型,想要独特运镜和自定义转场 手写档 手法库 + 2.5D 底座自由组合,风格由自己守
赶时间,1 分钟内快速出片 模板档 timeline_stub.mjs 不用配音就能先估时间线跑通流程

有口播视频的场景,样片《打仗了,黄金为什么反而跌》(28 秒,数字人口播)走的就是模板档 + 口播层,效果如下:

wallstreet-explainer 真人口播财经解读短片样片:主持人与证据图形同框

两条补充判断:

  • 默认模板档起步。官方的设计意图写得很直白:"让弱一些的模型也能稳定出片";而且手写档的两件核心资产(底座、手法库)本身就是模板档的接法所用,两者不是对立的。
  • 不要为了"用上模板"硬塞场景。references/thinking.md 的原则是:先想这一镜让观众多懂什么,再找最对得上的场景,对不上就 custom 手写。

两种方案可以混着用

实际项目中更常见的组合是"模板为主、局部手写":

  • 镜头表里某镜写 scene:'custom',在 render(c) 里调用 scripts/moves.js 和 scripts/stage25d.js 的工具手写那一镜;
  • 跑 render.mjs --moves 可以统计全片手法用量,加 --prev 和上一条片对比,避免镜头排布照抄;
  • 手写镜头同样要过 references/motion.md 的三句判断(删掉它观众少懂什么?是镜头在动还是元素自己在演?这一层是真的吗?)和 references/rules.md 的硬规矩。

新手起步路径:三步走

  1. 跑通演示片:node scripts/new_film.mjs demo_dir --demo,建出来就能渲。它能跑通 22 个场景,只用来学镜头表写法(kit/demo/、kit/demo2/);
  2. 照模板档流程做自己的第一片:从 starter/ 起步,script.json 写文案 → timeline_stub 估时间线 → 填镜头表 → --check 改到没错误 → --sheet 看图 → 720p 看动效。每站停下给用户看,点头再往下;
  3. 读案例学"怎么想":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 补一手写,整片想自由再切手写档——风格是同一个,选对路径,出片快一倍。

登录后查看全文
wallstreet-explainer