Skip to content

JimLiu/baocut / skills/baocut/built-in-skills/history-video

history-video

Verified

把历史录音、演讲、访谈、广播或档案影像做成观众看得懂的成片:先用几分钟讲清这个人、那个时代、这次讲话为什么要紧,再放完整的原声(原文与译文字幕、分章节)。讲法与画面由手上的材料定(只有录音还是有影像、照片多少、单语还是双语),不套模板;当时的照片、新闻片、报刊、地图与当事人的原声优先,生成的图只画没有真人的示意。只给录音配字幕、排版面走 subtitle-workflow;讲一个历史话题、没有一段要完整放的原声时走 explainer-video 或 clip-montage。

FileKindSize
.baocut-meta.jsonconfig2.5 KB
SKILL.mdskill md19.7 KB
references/brief.mdmarkdown4.9 KB
references/forms.mdmarkdown11.0 KB
references/old-recordings.mdmarkdown12.2 KB
references/self-check.mdmarkdown5.0 KB
references/sources.mdmarkdown5.7 KB

references/forms.md

View on GitHub
# 片头的表现手法

`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 节(用 `skills_read` 读 `video-production`,再按它「画面设计」一条读)。楷体、手写体留给大字,小字换笔画匀的黑体或宋体。
- **节奏跟着风格走**:新闻片风格的切得快、推得急;手稿与访谈的几乎只有淡入与慢推;报纸风格的像翻页。写在风格说明里,每段照它。
- **先出样帧**:每段写完先用 `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 里没有缺省的「历史风」。
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall