Remotion 數學解說影片產生器 (remotion-math-explainer)
概述
將任何數學推導、定理、證明或投影片,轉換為沉浸式、影格同步的 1920×1080 30fps MP4 Remotion 解說影片,採用單面板 Log2Base2 Studio 格式。
絕不將畫面分割成相互競爭的並排面板或堆疊的文字卡片牆。每部影片均使用一個統一的視覺舞台 (<SinglePaneStage>),讓觀眾的注意力完全鎖定在視覺敘事上:
- 極簡頂部列(內建於
SinglePaneStage中的 44px):- 左側顯示主題標題 + 目前活躍章節膠囊;右側顯示細微的步驟計數器 + 細長的進度條。
- 一個統一的 Log2Base2 舞台(
SinglePaneStage— 100% 寬度):- 聚焦的單行 Spotlight 標題: 僅顯示目前步驟標題和單一活躍方程式行(使用
borderBottom: "2px solid #FACC15"原地高亮顯示正在朗讀的術語,從不添加水平內距),外加一個在triggerFrame彈入的緊湊活躍術語標註膠囊(符號→白話文意思)。 - 全寬度沉浸式 SVG 畫布(
viewBox="0 0 1600 680"): 寬敞的連續動畫圖形——包含彩色資料點且會伸縮的即時座標網格、從矩陣中物理滑出到次要區塊的數字、掃掠的雷射劃線、帶符號的量值條,以及解開回歸單位矩陣的 3D 單位立方體——直接整合在同一開放的畫布上。
- 聚焦的單行 Spotlight 標題: 僅顯示目前步驟標題和單一活躍方程式行(使用
- 極簡底部字幕列(
VoiceoverCaptionBar—68px):- 乾淨的置中卡拉 OK 逐字高亮字幕,由精確的 TTS
WordBoundary毫秒時間戳驅動。
- 乾淨的置中卡拉 OK 逐字高亮字幕,由精確的 TTS
相依性
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md): 必須遵循所有 Remotion 動畫規則(useCurrentFrame()、interpolate()、spring()、<Sequence premountFor>、<Audio>、@remotion/google-fonts以及零 CSS 過渡效果)。uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md): 需要執行uv run --with edge-tts以進行神經語音合成。
快速開始
# 1. 建立 Remotion 數學解說影片專案
uv run python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/path/to/project" \
--output "/path/to/project/scaffold-status.json"
# 2. 合成自然神經語音 + 精確的 WordBoundary 與術語時間戳
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
synthesize-voiceover \
--project-dir "/path/to/project" \
--beats-json "/path/to/project/beats.json" \
--voice "en-US-AndrewNeural" \
--rate "+2%" \
--pause-sec 0.40 \
--output "/path/to/project/public/voiceover/manifest.json"
# 3. 透過快速 8-worker 關鍵影格去重複渲染器輸出最終 1080p 30fps MP4
uv run python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/path/to/project" \
--composition-id "MathExplainer" \
--out-name "MathExplainer.mp4" \
--concurrency 8 \
--output "/path/to/project/render-report.json"
沉浸式敘事與工作流程
- 設計充滿活力的節拍(
beats.json):- 撰寫口語化、以鉤子開場的旁白(避免乾燥的教科書措辭),讓即使缺乏動機的學生也能保持參與。
- 保持
snippet在 2–4 行精簡內容,其中每個token逐字出現在一行中,並與text中一個乾淨的單一小寫triggerWord匹配。 - 在具有連續曲線、向量、網格或飛行動畫的節拍上設定
"motionStepFrames": 2。
- 建構專案與合成語音:
- 透過
scripts/explainer_cli.py執行scaffold(複製SinglePaneStage.tsx、VoiceoverCaptionBar.tsx和render_full_mp4.mjs)和synthesize-voiceover。
- 透過
- 創作全畫布動畫圖形(
viewBox="0 0 1600 680"):- 將您的沉浸式 SVG 舞台作為
children傳遞給<SinglePaneStage>。 - 展示,而非告訴: 用物理運動取代靜態的項目符號/文字卡片——粒子/點在座標扭曲上移動、元素在位置之間飛翔、掃掠的雷射線、即時儀表,以及在同一開放畫布內的並排即時圖表。
- 始終將扭曲/延伸的網格線包裹在
<clipPath>內,使動畫永不溢出到標籤或膠囊上。
- 將您的沉浸式 SVG 舞台作為
- 驗證靜止幀並渲染最終 MP4:
- 執行
npm run lint,並在執行render-mp4之前,使用read_file檢查代表性的靜止幀(npx remotion still)。 - 將最終的
.mp4複製到out/、專案根目錄和工作區根目錄。
- 執行
速率限制與常見錯誤
scripts/explainer_cli.py強制執行/tmp/remotion_edge_tts.lock(0.35s間隔,3 次重試,分別以1s/2s/4s回退)。- 切勿使用多面板分屏佈局或堆疊有邊框的子卡片——請使用
<SinglePaneStage>,以確保畫面上嚴格只有一個主要面板。 - 切勿一次性在畫面上傾倒完整的多步驟證明;一次只 spotlight 一個活躍方程式行和一個活躍標註膠囊。
- 切勿為高亮的內聯術語添加水平
padding(僅使用borderBottom: "2px solid #FACC15"和backgroundColor)。