原始视频转Reel 是做什么的?
已在两个Reel上验证:Linux Day 2 和 Linux Day 1(带音效)。library/Reel.tsx 是 Day 1 的Reel示例。请复制其模式,不要发明新风格。
适用于 macOS 以及 Linux / Windows WSL。设置方法见仓库中的 README.md。
硬性规则
- 每个覆盖元素的时间均以
work/words.txt中的秒数为准。绝不猜测时间。 - 仅使用
src/(library)中的组件。仅当库中没有组件能匹配某个节拍时,才添加新组件。 - 保持面部清晰。安全区域(1080x1920):
- 顶部标签和标题:y 90 至 400。
- 面部和颈部:y 约 450 至 1350。此处除全屏标题卡片(最长3秒)外,不放其他内容。
- 其他所有内容放在颈部以下(衬衫第一颗纽扣):y 1360 至 1880。
Panel从BELOW_NECK(1360)处开始。使用fit缩放较高的面板,使其在1880处结束。 - 为每个新视频找到颈线:抓取一帧并观察y轴网格。在
ui.tsx中更新BELOW_NECK。
- 除非用户在聊天中要求,否则不要渲染完整视频。使用
scripts/stills.sh进行检查。Hook会阻止没有RENDER_OK=1的remotion render命令。 - 未经用户同意,不要下载任何内容(模型、字体、音乐、音效包)。
- 在调试之前,先阅读
reference/known-problems.md。 - 在 OpenCode 中,插件
~/.config/opencode/plugins/reel-from-raw执行与 Claude hooks 相同的工作(渲染阻止、类型检查、静帧提醒)。使用读取工具打开图表图像。如果您的模型无法看到图像,请让用户检查图表。
范围规则(严格遵守)
- 只做用户要求的事情。只修改请求所需的文件和值。
- 检查(类型检查、静帧检查、来自hook或插件的提醒)仅仅是检查。只修复违反此文件或
reference/style-spec.md中规则的问题。绝不要因为检查而重新设计样式、添加组件、添加场景、或更改文本、时间或音量。 - 如果您认为还有其他内容需要更改,请用一行告知用户。不要擅自更改。
- 在处理视频时,不要编辑
~/.claude/skills/reel-from-raw/(此技能目录)。只编辑视频项目。 - 您创建的测试文件(例如
src/__probe.ts)必须在完成前删除。
工作流程(新视频)
执行每个步骤。每个脚本在成功时会打印 OK:。如果出现 ERROR,则停止并修复。
| # | 步骤 | 命令 / 操作 |
|---|---|---|
| 1 | 创建项目 | bash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4>(例如 ~/Coding/motion-videos/<name>)。它将复制库、声音文件和hooks,并安装npm包(或从 $REEL_SEED 克隆)。 |
| 2 | 转录 | bash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi(仅英文则使用 en)。然后使用 reference/glossary.md 修正听错的内容。 |
| 3 | 静音裁剪 | python3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>。使用 --start/--end 去除错误的开头或结尾。 |
| 4 | 节拍表 | 遵循 reference/beat-sheet-prompt.md。编写 work/beats.md。如果用户希望批准计划,则向其展示。 |
| 5 | 构建 | src/Reel.tsx 是 Day 1 的Reel。根据节拍表重写它。在 Root.tsx 中,设置 id(例如 LinuxDay3)和真实的 handle。删除Reel不使用的场景组件。保留 At 和 r() 辅助函数。 |
| 6 | 类型检查 | 自动:hook在每次编辑后运行 tsc --noEmit。修复它报告的每个错误。 |
| 7 | 视觉检查 | bash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto,然后读取 out/stills/sheet*.jpg 中的每个文件。还要检查节拍帧:stills.sh <dir> 120,450,...。对照 reference/style-spec.md 进行检查。修复并重复。 |
| 8 | 音效检查 | 音效随组件提供(见“音效”)。检查 public/sfx/typing.wav 和 public/sfx/pop.wav 是否存在。除非用户要求,否则不要添加表格之外的声音。 |
| 9 | 预览 | 在项目中添加一个 launch.json 条目,运行 npx remotion studio --no-open --port <free>。向用户提供 URL http://localhost:<port>。用户可以在那里听声音。 |
| 10 | 渲染(仅按需) | RENDER_OK=1 npx remotion render <Id> out/<name>.mp4 --gl=angle(后台运行,90秒视频约需3-5分钟)。 |
音效
src/sfx.tsx 保存所有声音。SFX 列出所有声音。<Sfx src at volume frames name> 在当前 Sequence 的指定帧播放一个声音。
SFX 中的键 | 来源 | 是否需要网络 |
|---|---|---|
whoosh、ding、click、switch、whip | @remotion/sfx(remotion.media 上的文件) | 是,Studio和渲染都需要 |
pop | public/sfx/pop.wav(由代码生成) | 否 |
typing | public/sfx/typing.wav(由 scripts/make-typing-sound.py 生成) | 否 |
库组件已播放这些声音。您不需要手动添加。
| 时刻 | 文件(在项目中) | 声音 | 音量 |
|---|---|---|---|
| Hook标题 / 子芯片 | scenes/Intro.tsx(Hook) | whoosh / whip | 0.54 / 0.48 |
| 白天标题卡片 | scenes/Intro.tsx(DayTitle) | whoosh / ding | 0.6 / 0.36 |
| 命令列表芯片 | scenes/Intro.tsx(CommandList) | 每个芯片 pop | 0.36 |
| 命令标签 / 命令名称 | scenes/Commands.tsx(CommandTag) | whoosh / switch | 0.54 / 0.48 |
| 记事本行 | scenes/Commands.tsx(NoteCard) | 每行 typing | 0.6 |
| 下方面板出现 | ui.tsx(Panel) | pop | 0.48 |
| 终端命令输入 | ui.tsx(Terminal) | 每行命令 typing | 0.6 |
| 漏光 | Reel.tsx | whoosh | 0.48 |
| 完成徽章 / 关注点击 | scenes/Outro.tsx(DayDone、FollowCard) | ding / click | 0.48 / 0.72 |
任何未指定 volume 的 <Sfx> | sfx.tsx(默认) | - | 0.42 |
音量范围从0(无声)到1(最大)。保持所有声音低于人声。
常见请求(精确配方)
| 用户要求 | 请精确执行此操作 |
|---|---|
| “将所有音效增加/减少N%” | 将 <Sfx 行中的每个 volume={x} 以及 sfx.tsx 中的默认值,乘以 (1 ± N/100)。四舍五入到两位小数。不要触碰 CutVideo.tsx(那是人声)。在修改前后运行 grep -rn "<Sfx" src,并显示更改后的值。 |
| “仅更改键盘/打字声音音量” | 仅更改包含 src={SFX.typing} 的行(ui.tsx 中的 Terminal 和 scenes/Commands.tsx 中的 NoteCard)。 |
| “仅更改声音 X” | 在上表中找到其所在行。仅更改该 volume。 |
| “键盘声音太弱/制作一个新的” | python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <project>/public/sfx/typing.wav。首先保留旧文件的副本。仅当用户要求不同的感觉时,才编辑脚本中的数字。 |
| “移除一个声音” | 删除那一行 <Sfx .../>。 |
| “渲染前在哪里能听到?” | Studio(步骤9)。按播放或空格键。Studio每次保存编辑后会自动重新加载。 |
| “如何自己渲染?” | 终端:cd <project> && npx remotion render <Id> out/<name>.mp4 --gl=angle。Studio UI:渲染按钮(时间轴上方栏的右端)→ 视频选项卡 → 设置输出名称 → 渲染视频。进度显示在作业选项卡中。OpenGL 设置已设置为 angle。 |
| “进行渲染” | 步骤10,带上 RENDER_OK=1。然后给出输出文件的完整路径。 |
| “更改 handle” | Root.tsx 中的 defaultProps.handle。 |
时间运作方式
src/timeline.ts:CUTS(已移除的原始秒数),out(sec)将原始秒映射到输出帧。<At from={rawSec} to={rawSec} name="...">显示该口语时间段的块。r(t0, t)给出块内的帧延迟,用于“当单词t被说出时弹出此内容”。CutVideo在每个片段上交替缩放 1.0 / 1.14(每次裁剪时推入)。不要添加更多缩放。
库映射
| 文件 | 导出 | 用途 |
|---|---|---|
theme.ts | DISPLAY(Anton)、SANS(Inter)、MONO、颜色 C、extrude() | 所有文本和颜色。没有新字体或颜色。 |
sfx.tsx | SFX、Sfx | 音效(见上文) |
ui.tsx | Pop、useIn、useOut、BELOW_NECK、Panel、TermFrame、Terminal | 弹簧弹入、下半部分面板、打字终端 |
scenes/Intro.tsx | Hook({title, sub, subAt})、DailyStep({children})、DayTitle({day})、CommandList({commands, line, lineAt})、LightLeak | 开场、段落过渡 |
scenes/Commands.tsx | CommandTag({n, total, name, nameAt, meaning, meaningAt, color})、FolderPath、FileGrid、MoveSwap、NoteCard | 每个段落一个主题:顶部的标签,Panel 中的可视化内容 |
scenes/Commands.tsx(Day 2,硬编码文本) | IdCard、OwnerSwap、PhoneApps、Snapshot、TopView、PdfSearch | 在重用前为文本添加 props |
scenes/Outro.tsx | DayDone({day})、NextDay({day, commands, at})、FollowCard({handle}) | 结尾(NextDay 可选) |
Reel.tsx | Reel | 完整的 Day 1 Reel。将其作为结构示例。 |
更改文本时保持尺寸、颜色和动画。