JimLiu/baocut / skills/baocut
baocut
Flagged用 BaoCut 处理视频与音频:转录、字幕、翻译、配音、剪口播、切短视频、分章、总结写稿、从链接下载、压缩转码、导出成片,或从零做一条成片。有媒体文件、视频链接、字幕文件或 BaoCut 视频时用;只翻译纯文本、与视频无关的写作或作图、别的剪辑器与 FFmpeg 的用法、BaoCut 源码开发不用。
references/craft/production-scripts.md
View on GitHub<!-- 由 tools/sync-agent-skill.ts 从 skills/baocut/built-in-skills/production-scripts/ 生成,不要手改:改源文件后运行 npm run build:agent-skill -->
# 制作脚本
> 有命令行环境、旁白按段配、画面按段上时间线的片子(讲解、解说混剪、旁白片、歌词视频……)要跑脚本时用:配音、对齐字时间、把场景代码打成代码包、按段摆上时间线并处理变长变短的波纹、按稿子建字幕、剪实拍与水印叠上去或垫在底下、量画面占比。脚本是一条省事的路,不规定片子的形态;形态和它不合时用 baocut CLI 自己写。只是加一段动效图形或配一句旁白时不用。
一条旁白片做到后半程,重复的活都长一个样:每段旁白合成一次、转写拿字时间、把这一段的画面打成代码包、按整帧排到时间线上、按稿子建字幕、把实拍片段剪好放上去、改一段时把后面的东西一起挪。本 skill 的 `scripts/` 把这些写成了脚本,只调 baocut CLI(配音、转写、导入、修改都走它),不碰 API Key;内容相关的设定都在一份配置里,有命令行环境时拷进工程就能用。
**它是工具,不是形态。** 脚本假定的只有一件事:旁白按段配,每段配一个代码包,首尾相接排在一条视觉轨与一条音频轨上;代码包可以是整段的画面(动画打底,实拍叠在上面),也可以是透明的叠层(实拍铺在下面一条轨上当底,包里只画卡片、标注)。这期片子的底是什么、讲法是什么,由组合入口(读 [`references/craft/video-production.md`](video-production.md))与相应的手艺页定;定下的形态和脚本不合(整片一条旁白不分段、画面是一条长录屏、你有更顺手的做法)时,照 `video-production` 用 BaoCut 的工具或 CLI 自己做,不为了用脚本把片子做成脚本的形状。没有命令行环境,或者段落、实拍片段与卡片都定好了只差摆上时间线时,也不用脚本:`baocut edits assemble` 按一份计划一次放好,重跑只动变了的;计划的格式读 [baocut-catalog-editing](../catalog/editing.md)「一次放好制作计划」。
目录:1 计划文件 2 按顺序跑 3 改一段 4 量一遍 5 自检
## 1. 计划文件
脚本读的东西合起来就是这部片子的**制作计划**,先把它写全,再跑脚本:
| 文件 | 写什么 |
| --- | --- |
| `explainer.json`(也认 `production.json`) | 视频 id、CLI 命令、语言、帧率与画幅、段落顺序、旁白稿的位置、配音与转写的模型、打包规则、轨道与名字、实拍与水印的设定。字段表读 [制作脚本:配音、对齐、打包、预览、摆上时间线、建字幕、叠实拍](production-scripts/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`(配置里,可选) | 虚拟主播出镜:角色包、位置、哪几段不出镜、表情与读音表;角色与口型的做法读 [`references/craft/virtual-host.md`](virtual-host.md) |
| `prepend`、`fonts`(配置里,可选) | 片头补在已有视频前面(正片与章节一起后移);要裁子集的字体 |
计划定下后,剩下的就是把它摆上时间线:`assemble.mjs` 摆旁白与代码包,`captions.mjs` 建字幕,`overlay.mjs` 摆实拍、来源标签、原声字幕与水印(都写在时间线上,不剪文件、不烧字)。改计划只重做受影响的段(第 3 节)。摆的这一步也可以交给 Runtime:把段落(代码包、旁白、对齐结果)、实拍片段、卡片与水印改写成 `baocut edits assemble` 的计划,一次放好,重跑只动变了的;来源标签与原声的双语字幕仍由 `overlay.mjs` 放。
## 2. 按顺序跑
1. 把本 skill 的 `scripts/` 整个拷进工程(例如 `<工程>/tools/`):能直接读到文件时拷目录,读不到时读 `scripts/` 下每个文件原样写进去。脚本都 import 同目录的 `lib.mjs`,要拷全;`*.example.json` 是配置样例。依赖 Node 18 以上与 baocut CLI;切段转写、留白压停顿、量原声响度、拉平老录音、拼小屏样张要本机有 ffmpeg。
要画代码场景时,本 skill 的 `scene-kit/` 可以拷进工程的 `shared/` 当起点(读不到文件时读 `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 的陆地轮廓(公有领域)。
2. 照 [`scripts/explainer.example.json`](production-scripts/scripts/explainer.example.json) 在工程根目录写配置(脚本从当前目录往上找它,也可以 `--config <文件>`),有实拍时照 [`scripts/clips.example.json`](production-scripts/scripts/clips.example.json) 写 `clips.json`。
3. 按顺序跑,每个脚本都能重跑,做完、没变化的段跳过:
| 步骤 | 命令 | 做什么 |
| --- | --- | --- |
| 配音 | `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 节(读 [`references/craft/video-production.md`](video-production.md),再按它「画面设计」一条读) |
| 打包 | `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`):读 [制作脚本:配音、对齐、打包、预览、摆上时间线、建字幕、叠实拍](production-scripts/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`,时长或口型变了的贴纸重放。细则在 [制作脚本:配音、对齐、打包、预览、摆上时间线、建字幕、叠实拍](production-scripts/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 时只读标准输出,任务进度在标准错误。
- 试烘焙、试导出用的临时视频,交付前列给用户,删除要用户同意。
- 报告里写明跑了哪些脚本、哪些段重做过、量出来的数字;没听过的旁白接缝写「没听过」。
## 同目录的文件
在 `references/craft/production-scripts/` 下,用到时再打开;代码与样例原样复制,按正文说的用法取用。
- [制作脚本:配音、对齐、打包、预览、摆上时间线、建字幕、叠实拍](production-scripts/references/pipeline.md)
- [`scene-kit/geo110.js`](production-scripts/scene-kit/geo110.js)
- [`scene-kit/scene-kit.js`](production-scripts/scene-kit/scene-kit.js)
- [`scripts/align.mjs`](production-scripts/scripts/align.mjs)
- [`scripts/assemble.mjs`](production-scripts/scripts/assemble.mjs)
- [`scripts/build.mjs`](production-scripts/scripts/build.mjs)
- [`scripts/captions.mjs`](production-scripts/scripts/captions.mjs)
- [`scripts/clips.example.json`](production-scripts/scripts/clips.example.json)
- [`scripts/coverage.mjs`](production-scripts/scripts/coverage.mjs)
- [`scripts/envelope.mjs`](production-scripts/scripts/envelope.mjs)
- [`scripts/explainer.example.json`](production-scripts/scripts/explainer.example.json)
- [`scripts/fonts.mjs`](production-scripts/scripts/fonts.mjs)
- [`scripts/frames.mjs`](production-scripts/scripts/frames.mjs)
- [`scripts/gaps.mjs`](production-scripts/scripts/gaps.mjs)
- [`scripts/host.mjs`](production-scripts/scripts/host.mjs)
- [`scripts/legibility.mjs`](production-scripts/scripts/legibility.mjs)
- [`scripts/level.mjs`](production-scripts/scripts/level.mjs)
- [`scripts/lib.mjs`](production-scripts/scripts/lib.mjs)
- [`scripts/overlay.mjs`](production-scripts/scripts/overlay.mjs)
- [`scripts/preview.mjs`](production-scripts/scripts/preview.mjs)
- [`scripts/quotes.mjs`](production-scripts/scripts/quotes.mjs)
- [`scripts/sources.mjs`](production-scripts/scripts/sources.mjs)
- [`scripts/srt.mjs`](production-scripts/scripts/srt.mjs)
- [`scripts/voice.mjs`](production-scripts/scripts/voice.mjs)
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: 198k | 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: 194k | 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: 194k | 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: 194k | Updated | Claude CodeCodex | Verified | Install |