從原始影片製作 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進行檢查。掛鉤會阻止未設定RENDER_OK=1的remotion render。 - 未經使用者同意,不要下載任何東西(模型、字型、音樂、音效包)。
- 在除錯之前,請先閱讀
reference/known-problems.md。 - 在 OpenCode 中,外掛
~/.config/opencode/plugins/reel-from-raw的功能與 Claude 掛鉤相同(渲染阻止、類型檢查、靜止幀提醒)。使用讀取工具開啟圖表影像。如果你的模型無法看到影像,請要求使用者檢查圖表。
範圍規則(嚴格遵循)
- 只做使用者要求的事。僅更改請求所需的檔案和數值。
- 檢查(類型檢查、靜止幀檢查、來自掛鉤或外掛的提醒)就只是檢查。僅修正違反此檔案或
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>)。它會複製庫、音效檔案和掛鉤,並安裝 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 | 類型檢查 | 自動:掛鉤會在每次編輯後執行 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 的 at 影格播放一個音效。
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 產生) | 否 |
庫元件已經會播放這些音效。你不需要手動添加。
| 時機 | 檔案(在專案中) | 音效 | 音量 |
|---|---|---|---|
| 鉤子標題 / 子晶片 | 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。將其用作結構範例。 |
更改文字時,保持大小、顏色和動畫效果。