解說腳本
腳本是一份簡短的場景列表。每個場景包含一行或多行旁白以及一個視覺。 它是為了讓觀看者在關閉聲音的情況下滾動觀看而撰寫的，因此每一行也必須能作為 字幕使用。
長度
- 30-60 秒，目標為 45 秒（
src/settings.ts中的targetSeconds）。 - 英文大約 75-140 個口語單詞。請計算它們。對於相同的內容，西班牙語的長度約為英文的 15-20%。
結構
- 鉤子，在前 3 秒內。 令人驚訝的發現或一個具體的問題。永遠不要使用「在本影片中……」、「今天我想談談……」或問候語。開場卡片。
- 設定。 用一兩行說明正在測試什麼以及為什麼它很重要。
- 用一張圖呈現的實驗。 機制或設計以一個視覺呈現（流程圖、比較圖）。一個想法，而不是整個方法章節。
- 發現，附帶確切數字。 數字採用文章中的寫法（"14/20 vs 4/20"、"83 %"、"p = 0.0018"）：相同的四捨五入，相同的單位。
- 所以呢。 這個發現對於使用它的人來說意味著什麼，不超過文章所宣稱的強度。
- 結尾卡片行： "More at javieraguilar.ai"（西班牙語："Más en javieraguilar.ai"）。
語氣
- 使用第一人稱，如同文章的寫法：「我給了規劃者……」、「我發現……」。
- 宣稱的強度與文章一致。保留其修辭（「在這些運行中」、「在此設定下」）。
- 使用簡短的口語句子。每行一個想法。不使用文章未解釋的行話。
字幕
- 字幕從旁白文字中嵌入，最多兩行，每行約 32 個字元。
- 螢幕上每秒最多 17 個字元（
npm run lint會檢查）。如果一行文字讀得太快，需要減少字數，而不是加快語速。 - 字幕中的數字寫法與文章一致。如果 TTS 應該用不同方式說出，請為該行提供口語形式（參見
narration技能）；切勿為此更改字幕。 - 避免在旁白中使用長 URL 和程式碼標識符；它們會換行不佳且難以閱讀。
英文與西班牙語
- 將英文/西班牙語成對撰寫，逐行進行，以便兩個版本保持同步。西班牙語是可選的：當影片僅為英文時，將西班牙語文字留空。
- 西班牙語行表達相同內容，無需逐字翻譯；保持與英文一樣簡短。
每個場景的視覺想像
每個場景都有一個視覺想法，對應到元件庫中的一個元件（參見 explainer-animation）：
| 視覺想法 | 元件 |
|---|---|
| 一個從零開始計數的標題數字 | Counter |
| 並排顯示的兩到五個數值 | BarCompare |
| 流程、交接、斷開的連結 | FlowDiagram |
| 文章所依據的關鍵句子 | KeyQuote |
| 同時顯示的兩到四個數字 | StatGrid |
| 鉤子與結尾 | 開場 / 結尾卡片 |
如果沒有合適的元件，請將場景標記為 「bespoke」（客製），並附上一行動畫描述。避免製作只有文字搭配漸層背景的影片：每篇文章至少需要一個能展示其機制的視覺。
腳本格式
將 script.md 撰寫為一個表格，每個旁白行佔一行：
| 場景 | 元件 | 英文行 | 西班牙語行 | 視覺 | 來源句子 |
|---|
- 「來源句子」引用文章中每個數字和每個宣稱的原文。
- 結尾處附上單詞數（英文）和估計長度。
- 在開始任何製作之前，先提交以供審核。