Remotion 軟體工程解說員 (remotion-software-explainer)
概述
將任何系統設計、分散式架構、設計模式、資料庫內部機制或 DevOps 工作流程,轉換成沉浸式、幀數同步的 1920×1080 30fps MP4 Remotion 解說影片,採用 單面板 Log2Base2 工作室格式。
絕不將畫面分割成競爭的並列面板或堆疊的文字卡片牆。每個影片都使用 一個統一的視覺舞台 (<SinglePaneStage>):
- 極簡頂部資訊列(
44px,內建於SinglePaneStage):- 左側顯示主題標題 + 活躍章節標籤;右側顯示細緻的步驟計數器 + 細進度條。
- 一個統一的 Log2Base2 舞台(
SinglePaneStage— 100% 寬度):- 聚焦的單行重點標題:在活躍的規格/合約行中,以
borderBottom: "2px solid #FACC15"高亮顯示被口頭說明的元素(例如replicas: 3、ConsistentHash、WAL、CircuitBreaker),不添加任何水平內距,並在triggerFrame時顯示 一個 緊湊的活躍說明標籤(術語→架構角色)。 - 全寬沉浸式 SVG 畫布(
viewBox="0 0 1600 680"):漸進式向量服務節點(客戶端、API 閘道器、負載均衡器、微服務、訊息佇列、快取、資料庫分片、K8s Pod)隨口述依序出現,並以動畫虛線管道相連,管道上帶有 移動的請求封包、即時的快取命中率/吞吐量儀表板,以及直接在同一開放畫布上流動的請求追蹤跨度。
- 聚焦的單行重點標題:在活躍的規格/合約行中,以
- 極簡底部字幕列(
VoiceoverCaptionBar—68px):- 由精確的 TTS
WordBoundary時間戳驅動的乾淨、居中、逐字高亮的卡拉 OK 風格字幕。
- 由精確的 TTS
相依性
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md)uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md)
快速開始
# 1. 建立專案骨架
uv run python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/path/to/project" \
--output "/path/to/project/scaffold-status.json"
# 2. 合成旁白
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-software-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. 渲染 1080p MP4
uv run python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/path/to/project" \
--composition-id "SoftwareExplainer" \
--out-name "SoftwareExplainer.mp4" \
--concurrency 8 \
--output "/path/to/project/render-report.json"
沉浸式敘事與工作流程
- 保持
snippet聚焦(2–4行),以便<SinglePaneStage>能高亮 一個 活躍的合約行,並逐步揭示架構節點——絕不在第 0 幀就傾倒 15 個方塊。 - 對於包含移動請求封包、故障轉移串聯或自動擴展動畫的 beat,設定
"motionStepFrames": 2。 - 展示,而非告知:讓請求封包在節點間移動,同時直接在 同一個 全寬
1600×680SVG 畫布上(必要時使用<clipPath>)顯示即時的延遲、佇列和追蹤條,絕不使用分割畫面框。 - 始終執行
npm run lint,透過read_file檢查代表性的靜止幀(npx remotion still),並將最終的.mp4儲存至out/、專案根目錄和工作區根目錄。