Remotion 电子工程解释器 (remotion-electronic-explainer)
概述
将任何电子工程主题——从半导体物理和晶体管偏置到 CMOS 逻辑和模拟 IC 级——转化为一个沉浸式的、帧同步的 1920×1080 30fps MP4 Remotion 解释视频,采用单面板 Log2Base2 工作室格式。
绝不将屏幕分成并排的竞争面板或堆叠的文本卡片墙。每个视频都使用一个统一的视觉舞台 (<SinglePaneStage>):
- 最小化顶部栏 (
44px,内置于SinglePaneStage):- 左侧显示主题标题 + 活跃步骤标签;右侧显示微妙的步骤计数器 + 细进度条。
- 一个统一的 Log2Base2 舞台 (
SinglePaneStage— 100% 宽度):- 聚焦的单行重点标题:在活跃方程行中高亮显示的活跃口语术语 (
V_GS、V_th、I_D、β、g_m、V_OH) 带有borderBottom: "2px solid #FACC15"(绝不添加水平内边距) 加上一个紧凑的活跃标注标签 (symbol→电子含义 + 单位) 在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 画布上动画显示电子/空穴、耗尽区宽度和移动的负载线 Q 点 (使用<clipPath>清晰裁剪),绝不在分离的并排框中显示。 - 始终运行
npm run lint,使用read_file检查代表性静态帧 (npx remotion still),并将最终的.mp4文件保存到out/、项目根目录以及工作区根目录。