JimLiu/baocut / skills/baocut/built-in-skills/production-scripts
production-scripts
Unverified有命令行环境、旁白按段配、画面按段上时间线的片子(讲解、解说混剪、旁白片、歌词视频……)要跑脚本时用:配音、对齐字时间、把场景代码打成代码包、按段摆上时间线并处理变长变短的波纹、按稿子建字幕、剪实拍与水印叠上去或垫在底下、量画面占比。脚本是一条省事的路,不规定片子的形态;形态和它不合时用 baocut CLI 自己写。只是加一段动效图形或配一句旁白时不用。
制作脚本
一条旁白片做到后半程,重复的活都长一个样:每段旁白合成一次、转写拿字时间、把这一段的画面打成代码包、按整帧排到时间线上、按稿子建字幕、把实拍片段剪好放上去、改一段时把后面的东西一起挪。本 skill 的 scripts/ 把这些写成了脚本,只调 baocut CLI(配音、转写、导入、修改都走它),不碰 API Key;内容相关的设定都在一份配置里,有命令行环境时拷进工程就能用。
它是工具,不是形态。 脚本假定的只有一件事:旁白按段配,每段配一个代码包,首尾相接排在一条视觉轨与一条音频轨上;代码包可以是整段的画面(动画打底,实拍叠在上面),也可以是透明的叠层(实拍铺在下面一条轨上当底,包里只画卡片、标注)。这期片子的底是什么、讲法是什么,由组合入口(用 skills_read 读 video-production)与相应的手艺页定;定下的形态和脚本不合(整片一条旁白不分段、画面是一条长录屏、你有更顺手的做法)时,照 video-production 用 BaoCut 的工具或 CLI 自己做,不为了用脚本把片子做成脚本的形状。没有命令行环境,或者段落、实拍片段与卡片都定好了只差摆上时间线时,也不用脚本:edits_assemble 按一份计划一次放好,重跑只动变了的;计划的格式用 skills_read 读 baocut-catalog-editing「一次放好制作计划」。
目录:1 计划文件 2 按顺序跑 3 改一段 4 量一遍 5 自检
1. 计划文件
脚本读的东西合起来就是这部片子的制作计划,先把它写全,再跑脚本:
| 文件 | 写什么 |
|---|---|
explainer.json(也认 production.json) | 视频 id、CLI 命令、语言、帧率与画幅、段落顺序、旁白稿的位置、配音与转写的模型、打包规则、轨道与名字、实拍与水印的设定。字段表用 skills_read 读本 skill 的 references/pipeline.md 第 2 节 |
| 旁白稿(Markdown) | ## <段落 id> 标题 开一段,段内每个非空行是一句旁白,一句一个画面节拍;@、括号、>、<!-- 开头的行是备注(画面意图写在这里,不配音) |
scenes/<id>.js + shared/ | 每段的场景代码与共用的引擎、字体、图片;场景从 window.TIMING 读这一段的时长与逐句、逐字时间 |
clips.json(可选) | 实拍片段与照片:来源文件与原片起止,放在哪一段的哪一句、从哪几个字起(cue),保留原声、旁白留白(gap)、背靠背(follow)、双语字幕、单侧转场、裁边与取景(crop、focus)、放法、画中画;只有声音的原声引用(逐词点亮用 words) |
watermark(配置里,可选) | 水印图片或一行文字、每次出现的位置与时刻 |
sources.json(可选) | 用到的图片、影像、录音与生成图的出处与许可,一条一行;画面上的出处行与交付的 sources.csv 都从它来 |
host(配置里,可选) | 虚拟主播出镜:角色包、位置、哪几段不出镜、表情与读音表;角色与口型的做法用 skills_read 读 virtual-host |
prepend、fonts(配置里,可选) | 片头补在已有视频前面(正片与章节一起后移);要裁子集的字体 |
计划定下后,剩下的就是把它摆上时间线:assemble.mjs 摆旁白与代码包,captions.mjs 建字幕,overlay.mjs 摆实拍、来源标签、原声字幕与水印(都写在时间线上,不剪文件、不烧字)。改计划只重做受影响的段(第 3 节)。摆的这一步也可以交给 Runtime:把段落(代码包、旁白、对齐结果)、实拍片段、卡片与水印改写成 edits_assemble 的计划,一次放好,重跑只动变了的;来源标签与原声的双语字幕仍由 overlay.mjs 放。
2. 按顺序跑
- 把本 skill 的
scripts/整个拷进工程(例如<工程>/tools/):能直接读到文件时拷目录,读不到时用skills_read读本 skill 的scripts/下每个文件原样写进去。脚本都 import 同目录的lib.mjs,要拷全;*.example.json是配置样例。依赖 Node 18 以上与 baocut CLI;切段转写、留白压停顿、量原声响度、拉平老录音、拼小屏样张要本机有 ffmpeg。 要画代码场景时,本 skill 的scene-kit/可以拷进工程的shared/当起点(读不到文件时用skills_read读本 skill 的scene-kit/下的文件)。它在浏览器里跑,不和scripts/放在一起。scene-kit.js只有机制、没有配色:颜色与字体由场景调用K.style()给,拷过去照这期的需要改、删掉不用的;它读build.mjs、quotes.mjs、sources.mjs写进window.TIMING的数据(lines[].chars、clips、words、credits、ambient),另有相机、对数缩放、阻尼弹簧与环境时钟(K.cam、K.lens、K.zlerp、K.spring、K.ambient),默认手感见video-production代码场景细则第 4.1 节。geo110.js是 Natural Earth 1:110m 的陆地轮廓(公有领域)。 - 照
scripts/explainer.example.json在工程根目录写配置(脚本从当前目录往上找它,也可以--config <文件>),有实拍时照scripts/clips.example.json写clips.json。 - 按顺序跑,每个脚本都能重跑,做完、没变化的段跳过:
| 步骤 | 命令 | 做什么 |
|---|---|---|
| 配音 | voice.mjs <id …> 或 --missing;--check 只量不配 | 一段一次合成,记稿子原文,--missing 只配没配过或稿子改过的段。每段量中位音高,和其他段差 5% 以上就重配(--takes,缺省 3 次)留最接近的;配完报出全片离群的段 |
| 对齐 | align.mjs <id …> | 转写后用编辑距离把字时间对到稿子原文,打印语速、停顿与读错:字母、数字写的词(品牌名、缩写、型号)听成别的,单列成 check by ear,带时间与听到的内容,这几处要听;单个字的 differs 多半是同音字 |
| 留白与压停顿 | gaps.mjs [id …] | 有 gap 片段、稿子里有 @beat 或给了 voice.maxPause 时:在旁白里插静音给原声让位、把过长的句间停顿压短、把揭晓前那一拍留足 |
| 字体、原声、出处 | fonts.mjs、quotes.mjs、envelope.mjs、sources.mjs | 用到时在打包前跑:裁字体子集(缺省去掉会让字宽对不上的 locl);给 words: true 的原声片段对出逐词时间;把录音量成波形条写进 shared/;查出处表漏了什么并写 sources.csv |
| 老录音 | level.mjs | 用到时:把忽大忽小的老录音拉平(不改时间),量降噪、滤波带来的时间差;修录音的整套做法在 history-video |
| 看得清没有 | legibility.mjs --bg <底色> 名=<色> …;--frames <图或视频> --at <秒,…> | 不读配置、不连 Runtime:算色板里每个颜色在每个底色上的对比度(@0.6 先叠再算);从视频几个时刻取帧缩到三分之一拼成一张,看要读的字认不认得出、几级分不分得出轻重。下限在 video-production 画面设计细则的第 4.1 节(用 skills_read 读 video-production,再按它「画面设计」一条读) |
| 打包 | build.mjs [id …] | 打成代码包,时长 = 对齐出的时长 + hold,对到整帧;这一段的片段时间、画中画框、原声逐词与出处行写进 TIMING;配置里 continues 写了接着前一段演的段,再写上环境时钟的偏移(TIMING.ambient),打包前一段时它们一起重打 |
| 排时间线 | assemble.mjs --dry,再 assemble.mjs --live | --dry 不连 Runtime 只打印;--live 把代码包放上去、先不烘焙,编辑器的实时层现画(footage.layer 为 under 时眼下画不出来,见 pipeline.md 第 3 节) |
| 字幕 | captions.mjs --dry,再 captions.mjs | 用稿子原文加对齐时间建字幕层,专名照稿子上屏;不逐字高亮,要 KTV(念过的部分颜色变深)时配置 sungColor,颜色从这期色板取 |
| 实拍与水印 | overlay.mjs --dry,再 --place | 每个原片链接导入一次,每个镜头一个视频片段(原片区间、裁剪、取景、原声音量与淡变都是片段字段,响度按实测换成音量),转场是时间线转场;来源标签是标签轨上的文字片段,原声字幕是单独样式的双语字幕层(带说话人);footage.layer 为 under 时实拍轨挪到代码包轨下面当底 |
| 主播出镜 | host.mjs --dry,再 host.mjs | 配置了 host 时:按各段的逐字时间与配音算口型,连着出镜的几段拼成一条动作轨、放一个角色贴纸,不出镜的段(host.skip)前后各自成段;口型算法在 virtual-host 的 scripts/,拷到 tools/virtual-host/。重跑只动变了的贴纸 |
| 看合成后的画面 | frames.mjs <秒或段 …>、--cuts、--every <秒>;--still | 取帧只有素材画面,这里走导出预览:贴纸、文字、字幕、主播与还没烘焙的代码画面都在,几个时刻拼成一张图;--cuts 看每段的第一帧与最后一帧;--still 报出画面连续几秒不动的地方,对着旁白看是停下来让人读、还是该动却空着 |
| 给用户看 | baocut web review --video <videoId> | 在宿主的浏览器面板里打开链接、整条给用户(见 baocut 说明书 web 页「请用户审片」);用户说可以之前不烘焙、不导出,用户说过自检后直接导出时,照这期手艺页的自检清单查过再往下做,链接照给;改了哪段照第 3 节重做,再 assemble.mjs --live,请用户刷新 |
| 定稿烘焙 | assemble.mjs --bake ops,再 assemble.mjs(不带 --live) | 用户说可以之后(用户要自检后直接导出的,自检过之后):live 的段原地换成烘焙过的包。先 --bake ops 只走指令(几秒一段),画不出的段列出原因、视频不动;改不了的再不带它退回截图。之后再导出 |
| 交付字幕 | srt.mjs --dry,再 srt.mjs | 片头旁白、正片、原声片段的字幕是几份文档,导出一次只取一份:逐份导出,按语言合并成一个 SRT |
每一步的参数、配置字段、烘焙走指令还是截图、WebGL 的段、产物被清掉怎么办,以及还没建视频时的备选预览页(preview.mjs):用 skills_read 读本 skill 的 references/pipeline.md。
3. 改一段
改了稿子或画面只重做那几段:改旁白是 voice.mjs <id> → align.mjs <id> --fresh →(有留白时)gaps.mjs <id> → build.mjs <id>;只改画面是 build.mjs <id>;插一段是加进 order 与稿子后照常做这一段;给已有的视频补片头时配置写 prepend,第一次排时间线时正片与章节一起后移。然后 assemble.mjs --dry 看它打算怎么挪:帧数变了带 replace.ripple 换包,后面各轨一起挪;插入的段先 insertRange 腾位置;旁白换了先删旧的再放新的;之后 captions.mjs 重建变过的段的字幕,overlay.mjs --check 核对实拍位置;有主播时再跑 host.mjs,时长或口型变了的贴纸重放。细则在 references/pipeline.md 第 4 节。
4. 量一遍
node tools/coverage.mjs(在工程里,自动读配置判断哪些代码包是透明叠层;也可以 node coverage.mjs <videoId> 不带配置,透明包用 --alpha 告诉它;--from <videos inspect --limit 1000 --json 存下的文件> 不连 Runtime;--json 出机器可读结果)。它报每一帧最上面铺满的是实拍、代码画面还是空的各占多少、画中画占多少,镜头数与中位长度、最长一个镜头、最长一段没有实拍,实拍片段数、带原声的几段、同一素材用了几次,再按分钟列一条实拍占比。它只报数不判对错:对不对看这期定的形态要的是什么(实拍打底的片子通常实拍八九成、中位镜头 3–6 秒;代码画面打底的讲解片代码画面八成以上是设计使然)。
5. 自检
- 定稿烘焙时第一段导入后先看
bake.renderer:该走指令的包回退成browser-pixels时按video-production代码场景细则第 2.1 节改好再烘其余各段;烘全片前先算时间与磁盘。 - 排完用
videos inspect核对各段首尾相接、总长等于各段帧数之和;assemble.mjs --verify补后台烘焙的结果并核对。 - 请用户审之前
frames.mjs --cuts看一遍每段的首尾帧(第 0 帧是不是封面、段与段相接处有没有空帧),frames.mjs --still报出的每一处对着旁白看过。 - 自己调 CLI 读 JSON 时只读标准输出,任务进度在标准错误。
- 试烘焙、试导出用的临时视频,交付前列给用户,删除要用户同意。
- 报告里写明跑了哪些脚本、哪些段重做过、量出来的数字;没听过的旁白接缝写「没听过」。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |