Remotion 物理动画解释器 (remotion-physics-explainer)
概述
将任何物理概念、定律或问题转化为一个沉浸式的、帧同步的 1920×1080 30fps MP4 Remotion 解释视频,采用 单面板 Log2Base2 工作室格式。
绝不将屏幕分割成竞争性的并排面板或堆叠的文本卡片墙。每个视频都使用 一个统一的视觉舞台 (<SinglePaneStage>):
- 最小化顶部栏 (
44px,内置于SinglePaneStage):- 左侧显示主题标题 + 活动部分标签;右侧显示微妙的步骤计数器 + 细进度条。
- 一个统一的 Log2Base2 舞台 (
SinglePaneStage— 100% 宽度):- 聚焦的单行聚光灯标题:高亮当前口语化的物理符号 (
F,m,a,E,B,λ,Ψ,ΔS) 在活动方程行中,使用borderBottom: "2px solid #FACC15"(绝不 添加水平内边距) 外加 一个 紧凑的活动调用标签 (symbol→物理含义 + SI 单位),出现在triggerFrame。 - 全宽沉浸式 SVG 画布 (
viewBox="0 0 1600 680"): 宽敞的实时物理模拟——钟摆、抛射体轨迹、在 $\vec{B}$-场中弯曲的带电粒子、干涉波前、能量棒传递和实时矢量覆盖——直接在同一开放画布上动画。
- 聚焦的单行聚光灯标题:高亮当前口语化的物理符号 (
- 最小化底部字幕栏 (
VoiceoverCaptionBar—68px):- 由精确的 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-physics-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-physics-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 30fps MP4 视频
uv run python3 \
~/.gemini/config/skills/remotion-physics-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/path/to/project" \
--composition-id "PhysicsExplainer" \
--out-name "PhysicsExplainer.mp4" \
--concurrency 8 \
--output "/path/to/project/render-report.json"
沉浸式叙事与工作流程
- 保持
snippet集中(2–4行),以便<SinglePaneStage>一次只高亮 一个 活动方程和 一个 活动符号调用标签。 - 对有连续物理运动(钟摆、波动、场、粒子)的节拍设置
"motionStepFrames": 2。 - 展示,而非讲述:在同一全宽
1600×680SVG 画布内(使用<clipPath>处理移动的图/波)一起动画化力、场、能量交换和实时运动图,绝不放在分离的分屏框中。 - 始终运行
npm run lint,使用read_file检查代表性静态帧 (npx remotion still),并将最终的.mp4保存到out/、项目根目录和工作空间根目录。