Skip to content

JimLiu/baocut / skills/baocut

baocut

Flagged

用 BaoCut 处理视频与音频:转录、字幕、翻译、配音、剪口播、切短视频、分章、总结写稿、从链接下载、压缩转码、导出成片,或从零做一条成片。有媒体文件、视频链接、字幕文件或 BaoCut 视频时用;只翻译纯文本、与视频无关的写作或作图、别的剪辑器与 FFmpeg 的用法、BaoCut 源码开发不用。

FileKindSize
SKILL.mdskill md46.5 KB
built-in-skills/README.mdmarkdown9.6 KB
references/catalog/editing.mdmarkdown24.4 KB
references/catalog/export.mdmarkdown6.6 KB
references/catalog/media.mdmarkdown45.1 KB
references/catalog/models.mdmarkdown7.9 KB
references/catalog/music.mdmarkdown17.1 KB
references/catalog/subtitles.mdmarkdown20.8 KB
references/catalog/system.mdmarkdown9.6 KB
references/catalog/voice-gemini-tts.mdmarkdown2.6 KB
references/catalog/voice-language-rates.mdmarkdown6.5 KB
references/catalog/voice.mdmarkdown12.3 KB
references/catalog/web.mdmarkdown10.9 KB
references/conventions.mdmarkdown16.1 KB
references/craft/.gitkeepother0 B
references/craft/README.mdmarkdown480 B
references/craft/character-animation.mdmarkdown6.8 KB
references/craft/character-animation/examples/mini-film/art.example.jsonconfig918 B
references/craft/character-animation/examples/mini-film/index.htmlother628 B
references/craft/character-animation/examples/mini-film/scene.jsscript2.1 KB
references/craft/character-animation/references/art.mdmarkdown4.6 KB
references/craft/character-animation/references/checks.mdmarkdown2.6 KB
references/craft/character-animation/references/rig.mdmarkdown5.3 KB
references/craft/character-animation/references/style-and-story.mdmarkdown5.0 KB
references/craft/character-animation/references/timing-and-sound.mdmarkdown3.1 KB
references/craft/character-animation/rig-kit/rig-kit.jsscript33.0 KB
references/craft/character-animation/scripts/cutout.mjsscript26.9 KB
references/craft/character-animation/scripts/jump-scan.mjsscript3.2 KB
references/craft/character-animation/scripts/place-sfx.mjsscript5.1 KB
references/craft/character-animation/scripts/rig-check.mjsscript8.9 KB
references/craft/clip-montage.mdmarkdown11.5 KB
references/craft/clip-montage/references/assembly.mdmarkdown5.0 KB
references/craft/clip-montage/references/sourcing.mdmarkdown6.3 KB
references/craft/clip-montage/references/structure.mdmarkdown3.8 KB
references/craft/cover-and-title.mdmarkdown5.6 KB
references/craft/cross-video-qa.mdmarkdown5.8 KB
references/craft/design-system.mdmarkdown18.5 KB
references/craft/design-system/references/cover.mdmarkdown6.9 KB
references/craft/design-system/references/craft.mdmarkdown8.8 KB
references/craft/design-system/references/demo.jsonconfig161.1 KB
references/craft/design-system/references/format.mdmarkdown18.6 KB
references/craft/design-system/references/from-code.mdmarkdown11.5 KB
references/craft/design-system/references/from-design-tool.mdmarkdown16.2 KB
references/craft/design-system/references/sample-seazar-tokens.jsonconfig11.0 KB
references/craft/design.mdmarkdown19.3 KB
references/craft/design/references/brand-colors.mdmarkdown2.4 KB
references/craft/design/references/brand-typography.mdmarkdown1.7 KB
references/craft/design/references/craft.mdmarkdown15.4 KB
references/craft/design/references/design-system-components.mdmarkdown11.8 KB
references/craft/design/references/diagrams.mdmarkdown10.1 KB
references/craft/design/references/format.mdmarkdown11.8 KB
references/craft/design/references/print.mdmarkdown5.6 KB
references/craft/design/references/questions.mdmarkdown4.7 KB
references/craft/design/references/view-state.mdmarkdown5.7 KB
references/craft/docs.mdmarkdown19.9 KB
references/craft/docs/references/comments.mdmarkdown4.4 KB
references/craft/docs/references/editing.mdmarkdown12.9 KB
references/craft/docs/references/tabs.mdmarkdown4.7 KB
references/craft/docs/references/uploads.mdmarkdown1.7 KB
references/craft/explainer-video.mdmarkdown23.4 KB
references/craft/explainer-video/references/3d.mdmarkdown5.9 KB
references/craft/explainer-video/references/footage.mdmarkdown9.6 KB
references/craft/explainer-video/references/length-and-pace.mdmarkdown6.7 KB
references/craft/explainer-video/references/script.mdmarkdown14.7 KB
references/craft/explainer-video/references/subject.mdmarkdown12.5 KB
references/craft/history-video.mdmarkdown20.6 KB
references/craft/history-video/references/brief.mdmarkdown5.1 KB
references/craft/history-video/references/forms.mdmarkdown11.2 KB
references/craft/history-video/references/old-recordings.mdmarkdown12.4 KB
references/craft/history-video/references/self-check.mdmarkdown5.3 KB
references/craft/history-video/references/sources.mdmarkdown5.9 KB
references/craft/motion-graphics.mdmarkdown17.3 KB
references/craft/motion-graphics/exemplars/big-number/16x9.htmlother11.4 KB
references/craft/motion-graphics/exemplars/big-number/9x16.htmlother11.5 KB
references/craft/motion-graphics/exemplars/callout-pin/16x9.htmlother11.6 KB
references/craft/motion-graphics/exemplars/callout-pin/9x16.htmlother11.6 KB
references/craft/motion-graphics/exemplars/keyword-caption/16x9.htmlother11.3 KB
references/craft/motion-graphics/exemplars/keyword-caption/9x16.htmlother11.3 KB
references/craft/motion-graphics/exemplars/logo-sting/16x9.htmlother12.1 KB
references/craft/motion-graphics/exemplars/logo-sting/9x16.htmlother12.1 KB
references/craft/motion-graphics/exemplars/lower-third/16x9.htmlother11.2 KB
references/craft/motion-graphics/exemplars/lower-third/9x16.htmlother11.2 KB
references/craft/motion-graphics/references/audio-backdrop.mdmarkdown22.9 KB
references/craft/motion-graphics/references/grammar.mdmarkdown11.1 KB
references/craft/motion-graphics/scaffold.htmlother9.0 KB
references/craft/motion-graphics/scripts/build-bundle.mjsscript25.2 KB
references/craft/narration.mdmarkdown11.1 KB
references/craft/polish-transcript.mdmarkdown13.8 KB
references/craft/production-scripts.mdmarkdown15.7 KB
references/craft/production-scripts/references/pipeline.mdmarkdown37.8 KB
references/craft/production-scripts/scene-kit/geo110.jsscript27.3 KB
references/craft/production-scripts/scene-kit/scene-kit.jsscript38.3 KB
references/craft/production-scripts/scripts/align.mjsscript11.6 KB
references/craft/production-scripts/scripts/assemble.mjsscript26.4 KB
references/craft/production-scripts/scripts/build.mjsscript18.1 KB
references/craft/production-scripts/scripts/captions.mjsscript18.6 KB
references/craft/production-scripts/scripts/clips.example.jsonconfig3.2 KB
references/craft/production-scripts/scripts/coverage.mjsscript10.0 KB
references/craft/production-scripts/scripts/envelope.mjsscript2.9 KB
references/craft/production-scripts/scripts/explainer.example.jsonconfig2.2 KB
references/craft/production-scripts/scripts/fonts.mjsscript7.0 KB
references/craft/production-scripts/scripts/frames.mjsscript7.7 KB
references/craft/production-scripts/scripts/gaps.mjsscript11.3 KB
references/craft/production-scripts/scripts/host.mjsscript14.8 KB
references/craft/production-scripts/scripts/legibility.mjsscript5.7 KB
references/craft/production-scripts/scripts/level.mjsscript9.2 KB
references/craft/production-scripts/scripts/lib.mjsscript19.3 KB
references/craft/production-scripts/scripts/overlay.mjsscript34.7 KB
references/craft/production-scripts/scripts/preview.mjsscript4.6 KB
references/craft/production-scripts/scripts/quotes.mjsscript7.4 KB
references/craft/production-scripts/scripts/sources.mjsscript6.2 KB
references/craft/production-scripts/scripts/srt.mjsscript5.8 KB
references/craft/production-scripts/scripts/voice.mjsscript7.7 KB
references/craft/shorts-segments.mdmarkdown30.8 KB
references/craft/slides.mdmarkdown13.8 KB
references/craft/slides/references/design-system.mdmarkdown6.3 KB
references/craft/slides/references/design.mdmarkdown9.3 KB
references/craft/slides/references/format.mdmarkdown12.2 KB
references/craft/slides/references/images.mdmarkdown4.2 KB
references/craft/speaker-labeling.mdmarkdown6.6 KB
references/craft/subtitle-workflow.mdmarkdown13.1 KB
references/craft/talking-head-cut.mdmarkdown9.3 KB
references/craft/talking-head-cut/references/picture-and-sound.mdmarkdown10.1 KB
references/craft/titles-and-description.mdmarkdown5.2 KB
references/craft/titles-and-description/references/description.mdmarkdown5.1 KB
references/craft/titles-and-description/references/titles.mdmarkdown5.5 KB
references/craft/titles-and-description/references/writing-baseline.mdmarkdown11.9 KB
references/craft/translate-subtitles.mdmarkdown13.4 KB
references/craft/video-blog.mdmarkdown17.1 KB
references/craft/video-blog/references/writing-baseline.mdmarkdown11.9 KB
references/craft/video-chapters.mdmarkdown9.7 KB
references/craft/video-production.mdmarkdown31.9 KB
references/craft/video-production/examples/bundle-preview.htmlother17.7 KB
references/craft/video-production/examples/post-fx.jsscript7.5 KB
references/craft/video-production/references/code-scenes.mdmarkdown31.9 KB
references/craft/video-production/references/shot-plan.mdmarkdown5.1 KB
references/craft/video-production/references/sound-design.mdmarkdown4.4 KB
references/craft/video-production/references/visuals.mdmarkdown19.7 KB
references/craft/video-summary.mdmarkdown22.8 KB
references/craft/video-summary/references/writing-baseline.mdmarkdown11.9 KB
references/craft/virtual-host.mdmarkdown14.9 KB
references/craft/virtual-host/examples/character-partmap.example.jsonconfig600 B
references/craft/virtual-host/examples/character.example.jsonconfig336 B
references/craft/virtual-host/references/art.mdmarkdown22.1 KB
references/craft/virtual-host/references/hosts.mdmarkdown4.4 KB
references/craft/virtual-host/references/lipsync.mdmarkdown10.1 KB
references/craft/virtual-host/scripts/lipsync.mjsscript39.8 KB
references/craft/virtual-host/scripts/pinyin-table.mjsscript83.2 KB
references/craft/virtual-host/scripts/puppet-build.mjsscript48.6 KB
references/craft/virtual-host/scripts/puppet-mask.mjsscript3.0 KB
references/craft/virtual-host/scripts/puppet/align.mjsscript4.1 KB
references/craft/virtual-host/scripts/puppet/brows.mjsscript17.2 KB
references/craft/virtual-host/scripts/puppet/edits.mjsscript4.3 KB
references/craft/virtual-host/scripts/puppet/expression-labels.jsonconfig1.1 KB
references/craft/virtual-host/scripts/puppet/expreyes.mjsscript35.9 KB
references/craft/virtual-host/scripts/puppet/eyes.mjsscript8.6 KB
references/craft/virtual-host/scripts/puppet/fill.mjsscript10.5 KB
references/craft/virtual-host/scripts/puppet/layers.mjsscript5.7 KB
references/craft/virtual-host/scripts/puppet/mapbuild.mjsscript50.4 KB
references/craft/virtual-host/scripts/puppet/ops.mjsscript7.4 KB
references/craft/virtual-host/scripts/puppet/pack.mjsscript10.2 KB
references/craft/virtual-host/scripts/puppet/partmap.mjsscript8.5 KB
references/craft/virtual-host/scripts/puppet/parts.mjsscript7.0 KB
references/craft/virtual-host/scripts/puppet/png.mjsscript5.8 KB
references/craft/virtual-host/scripts/puppet/seg.mjsscript21.6 KB
references/craft/virtual-host/scripts/puppet/segment.mjsscript26.6 KB
references/craft/virtual-host/scripts/puppet/zip.mjsscript2.0 KB
references/craft/virtual-host/scripts/visemes.mjsscript21.4 KB
references/craft/vlog-from-clips.mdmarkdown13.2 KB
references/craft/vlog-from-clips/references/footage-log.mdmarkdown3.3 KB
references/mcp.mdmarkdown8.9 KB
references/start.mdmarkdown6.3 KB
references/workflows.mdmarkdown29.8 KB

references/craft/history-video/references/forms.md

View on GitHub
<!-- 由 tools/sync-agent-skill.ts 从 skills/baocut/built-in-skills/history-video/references/forms.md 生成,不要手改:改源文件后运行 npm run build:agent-skill -->

# 片头的表现手法

`SKILL.md` 第 4、6 节的细则:每种手法适合什么、在代码场景里怎么做、哪些写法会让烘焙退回逐帧截图。这是一张菜单,不是清单:一期挑几种和材料相称的,主干一种,穿插两三种,不要每种都用。

目录:1 手法 2 串起来 3 scene-kit

## 1. 手法

每一条:**适合**什么时候用;**做法**是代码场景里的画法;**烘焙**是会让指令烘焙退回截图、或画面与浏览器对不上的写法(通用规则在 `video-production` 的代码场景细则,这里只写这些手法特有的)。

通用的烘焙规则在代码场景细则第 2.1 节,每个场景都要守。这类片子最常撞上其中两条:照片上叠了几层半透明层(压暗、暗角、颗粒、淡入),和中文字体保留 `locl` 时排年份、数字(用 `production-scripts` 的 `fonts.mjs` 裁字体,缺省去掉 `locl`)。

### 封面

- **适合**:每期都要。第 0 帧就是它。
- **做法**:人物的照片占半屏或铺满,名字用最大的字,下面一行写场合与日期(公历),也是要读的字;照片角落写出处(不小于 28 px)。第 0 帧已经完整,不从黑场淡入;原声若立刻开始,封面停两三秒再动。
- **烘焙**:封面最容易叠多层(照片、压暗、颗粒、标题的淡入):照片之上现画的只留一层,暗角与颗粒预先画好再贴。

### 原话逐词点亮

- **适合**:开头的钩子;背景里讲到某件事时让当事人自己说出来。
- **做法**:`clips.json` 的只有声音的片段带 `words: true`,`TIMING.clips[i].words` 给每个词相对段首的 `s` / `e`。词按行排好(拉丁文按空格断行,中文按字),没念到的词压暗、念到的变亮,可以加一道随词长出的下划线;压暗的词仍要和底色有 4.5:1,观众会往前读。译文在下面整句淡入,比原话小一级,不小于 40 px。原话是成片语言时只点亮原话。也可以把整段录音画成一排波形条(`production-scripts` 的 `envelope.mjs` 量、scene-kit 的 `K.bars()` 画),正在放的那几秒标成强调色、带播放头:观众一眼看出这句话在整场讲话的哪里。要强调的一句话可以写在一张纸条上落到画面里(`K.slip()`)。
- **烘焙**:字距靠逐字 `fillText` 加偏移,不用 `letterSpacing`;断行用 `measureText` 算,每帧算法相同、结果才稳定。

### 照片推拉、局部放大

- **适合**:照片是主干时的基本动作;讲到照片里某个人、某个细节时。
- **做法**:`drawImage` 的源矩形随时间缩小、朝焦点移(缓入缓出),放大不超过原图分辨率的一点几倍;局部放大用一个圆或方框 `clip`,框里画放大的那块,框外压暗。
- **烘焙**:源矩形可以是小数、随时间变;推到头停住时(1:1、不再缩放)落在整数坐标上。局部放大的框只用 `clip()` 的默认填充规则。

### 冲印照片、照片墙、照片落桌

- **适合**:照片多、要讲一段经历或一群人时。
- **做法**:照片加白边与阴影(`shadowBlur`),带一点旋转,依次落下或排成一面墙;每张下方一行说明。最后一张出现时把这一拍的出处写全。
- **烘焙**:阴影用 `shadowBlur` 与 `shadowOffsetY`,不用 `filter: drop-shadow`;同一帧里几十张大阴影会慢,墙上的远景照片可以不带阴影。

### 新闻片画中画

- **适合**:有当事人的影像、但画面质量差或比例不对时;要在影像旁边加说明时。
- **做法**:影像作为视频片段放在场景上面一层,位置是 `TIMING.clips[i].box`;场景在框下画一块底板(比框大一圈、带阴影),框旁写日期、地点、出处。片段的 `at` / `end` 定底板何时出现、何时撤走。铺满的新闻片不需要场景,旁白直接压在上面,下横栏写人名。
- **烘焙**:场景里不画视频帧(视频由时间线放);底板与说明是普通图形。

### 地图与路线

- **适合**:讲位置、行程、战线、航线;材料少的早年演讲常以它为骨。
- **做法**:只画陆地轮廓(Natural Earth 公有领域数据,`production-scripts` 的 `scene-kit/geo110.js` 是简化的一份),海与陆两种颜色,不画国界;城市是点加名字,第一次出现时写原文;地名是要读的字(不小于 40 px),和陆地、海的颜色都有 4.5:1,淡出的地名不停在半透明上;路线是一条按进度画出的折线或贝塞尔曲线,线头带箭头或一个小图标;镜头按关键帧推拉(中心经纬度与横跨的经度,跨度在对数空间插值)。占领区、战线画成半透明的斜线区并标「示意」。
- **烘焙**:陆地在初始化时一次画进离屏画布,之后每帧 `drawImage` 它(画进主画布时按位图记,便宜);不要每帧重画上千个多边形。离屏画布按镜头最近时需要的清晰度画,放大太多会糊。从远景推到近景时,1:110m 与 1:50m 两层交叉淡变,海岸线只描在上面那一层(下面一层 `coastW: 0`),否则两条线错开成一圈光晕。

### 时间线

- **适合**:要把几件事的先后、相隔多少年讲清楚时。
- **做法**:一条横轴,年份刻度,事件依次弹出;一个标记随旁白走到当前年份;跨度大时先看全局再推到这几年。
- **烘焙**:普通图形,无特别要求。

### 报刊标题

- **适合**:讲「当时的人怎么看」「消息传开」;没有照片的年代。
- **做法**:有许可的版面原图就用原图推拉;没有时由代码排:报头、粗大的标题一行行显出来,正文用灰色细线条示意,角落标「示意」。字体照年代选(铅字宋体、粗黑体、衬线体),标题照当时的写法(原文或忠实的译文),不编造。
- **烘焙**:报纸的纹理同样用整幅离屏画布 1:1 贴。

### 文件、电报、手稿

- **适合**:讲一封电报、一份文件、作家的一页手稿。
- **做法**:纸张(离屏画布)上逐字打出(`typeOn`),带一个光标;电报用等宽字与纸条;手稿用真实的扫描,没有就只引文字。
- **烘焙**:等宽字体要带进包;逐字的透明度渐变走指令没问题。

### 数字

- **适合**:规模、伤亡、距离、金额这类一句话说不清分量的。
- **做法**:数字从 0 长到目标值(等宽数字),旁边一个对比(「相当于……」)或一根条;单位与出处写清。
- **烘焙**:每帧的数字字符串不同,字体要覆盖所有数字与分隔符,并且不带 `locl`。

### 人物卡、下横栏

- **适合**:一个人第一次出现时;同时讲几个人时。
- **做法**:压在画面上的一层,不是底:名字(原文)、生卒年、一句身份;小照片可有可无。几个人的关系用连线与位置表示,不排成表格。
- **烘焙**:无特别要求。

### 生成的示意图

- **适合**:某一拍找不到任何照片、又不是地图与图形能讲的(一段山路、一片海、一件物品)。
- **做法**:只画没有真人的场景,照风格说明写提示词;当底图慢推,角落标「AI 生成示意」(用成片语言)。
- **烘焙**:和照片相同。

### 交给正片

- **适合**:片头的最后一拍,每期都要。
- **做法**:旁白最后一句把观众交给原声(「下面是这次讲话的完整录音」),画面在几秒里变成正片第一帧的样子(同样的底色、照片或声波的位置),在句末切过去;正片开头的章节标题接着出现。
- **烘焙**:先导出或截下正片第一帧看清它长什么样,再定最后一拍的终点。正片开头若有写成文字的章节序号,加了片头一章后它会多一(`production-scripts` 的 `prepend`),交接前看一眼。

## 2. 串起来

- **一拍一个动作**:一句旁白三到八秒,换一句就换一个画面动作(推到下一个细节、地图上走下一段、下一行标题显出来)。一个画面停十秒以上不动,就是幻灯片了。
- **三层**:底层是照片、影像、地图;中层是标注、卡片、引文;上层只有出处行(不小于 28 px)。水印与角标由 `overlay.mjs` 放,场景不画。
- **段与段相接**:每段是一个代码包,段首与上一段的段尾要接得上(同一张底图,或在一句话的结尾硬切)。段首不要从黑场淡入,除非上一段就收在黑场。
- **强调色只给「看这里」**:色板里留一种颜色专给点题的词、路线、圈出的人,别处不用它;它要比中间调明显更重,写字时和底色有 4.5:1。要分开两类信息(原话与译文、对立的两方)时再给第二个色相。
- **字分几级**:一屏上的字按「此刻在说的、现在在哪、补充、出处」分级,相邻两级在字号之外还要差一样(字重、颜色或字体),细则在 `video-production` 画面设计细则的第 4.1–4.3 节(读 [`references/craft/video-production.md`](../../video-production.md),再按它「画面设计」一条读)。楷体、手写体留给大字,小字换笔画匀的黑体或宋体。
- **节奏跟着风格走**:新闻片风格的切得快、推得急;手稿与访谈的几乎只有淡入与慢推;报纸风格的像翻页。写在风格说明里,每段照它。
- **先出样帧**:每段写完先用 `baocut compositions preview <视频> --path bundles/<id> --at … --sheet` 抽一排帧拼成接触表看(浏览器面板打开本地 `file://` 的包只是静态快照),再配音、对齐、摆上时间线;整条串起来以后在编辑器里从头看一遍,听旁白与画面的动作是否同步。

## 3. scene-kit

`production-scripts` 的 `scene-kit/` 里有两份文件,可以拷进项目的 `shared/` 当起点:

- `scene-kit.js`:只有机制、没有风格的绘图工具。场景调用 `K.style({ … })` 给出这期的颜色与字体族名,`K.scene(draw)` 注册画面(单个画布、每帧清屏、等字体与图片就绪),`draw(ctx, t)` 拿到段内秒数。里面有:时间(缓动、按旁白的第几个字取时刻、`TIMING.clips` 与 `TIMING.credits` 的取用)、图片(铺满与推拉、冲印照片、局部放大、一侧压暗好放字)、文字(手动字距、中英文断行、逐字打出、带描边的标注、纸条引语;西文字体角色碰到中文时自动换正文字体,免得浏览器替换字体让烘焙退回截图)、标注(下划线、印章、点、箭头、路线的部分折线)、画中画底板、出处行、整幅颗粒纹理、地图(陆地离屏光栅、镜头关键帧、城市点)、原话逐词点亮、录音的波形条。
- `geo110.js`:Natural Earth 1:110m 陆地轮廓(公有领域),约 28 KB,`window.GEO110`。要更细的海岸线时从 Natural Earth 下 1:50m 自己转一份(格式写在文件开头)。

拷过去以后照这期的需要改,删掉不用的;颜色、字体、版式都由这期的风格说明定,scene-kit 里没有缺省的「历史风」。
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall