Remotion 電子工程解釋器 (remotion-electronic-explainer)
概述
將任何電子工程主題——從半導體物理和電晶體偏壓到 CMOS 邏輯和類比 IC 級——轉變為沉浸式、影格同步的 1920×1080 30fps MP4 Remotion 解釋影片,採用單面板 Log2Base2 工作室格式。
絕不將畫面分割成競爭的並排面板或堆疊的文字卡片牆。每個影片使用一個統一的視覺舞台 (<SinglePaneStage>):
- 極簡頂部列 (
44px,內建於SinglePaneStage):- 左側顯示主題標題 + 活動章節藥丸;右側顯示微妙的步驟計數器 + 細進度條。
- 一個統一的 Log2Base2 舞台 (
SinglePaneStage— 100% 寬度):- 聚焦的單行聚光燈標題:使用
borderBottom: "2px solid #FACC15"(絕不添加水平內距) 高亮顯示活動口語詞彙 (V_GS、V_th、I_D、β、g_m、V_OH) 所在的活動方程式行,並在triggerFrame處加上一個緊湊的活動呼叫藥丸 (符號→電子意義 + 單位)。 - 全寬沉浸式 SVG 畫布 (
viewBox="0 0 1600 680"): 清晰的動畫半導體截面(PN 空乏區擴大/縮小、MOSFET 反轉通道與夾止、BJT 載子流動、CMOS 上拉/下拉切換)直接與同一開放畫布上的即時 $I$-$V$ 曲線和移動的 Q 點配對。
- 聚焦的單行聚光燈標題:使用
- 極簡底部字幕列 (
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-electronic-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-electronic-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-electronic-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/path/to/project" \
--composition-id "ElectronicExplainer" \
--out-name "ElectronicExplainer.mp4" \
--concurrency 8 \
--output "/path/to/project/render-report.json"
沉浸式說故事與工作流程
- 保持
snippet聚焦(2–4行),以便<SinglePaneStage>一次只聚光一個活動方程式和一個活動呼叫藥丸。 - 在具有移動 Q 點、載子流動、夾止變形或即時切換波形的節拍上設定
"motionStepFrames": 2。 - 展示,而非告知:直接在單一開放
1600×680SVG 畫布上(使用<clipPath>乾淨裁剪)動畫顯示電子/電洞、空乏區寬度和移動的負載線 Q 點,切勿在分離的分割畫面方塊中進行。 - 始終執行
npm run lint,使用read_file檢查代表性靜止影格 (npx remotion still),並將最終.mp4儲存至out/、專案根目錄和工作區根目錄。