Remotion 软件工程解释器(remotion-software-explainer)
概述
将任何系统设计、分布式架构、设计模式、数据库内部原理或 DevOps 工作流转化为沉浸式、帧同步的 1920×1080 30fps MP4 Remotion 解释视频,采用单画面 Log2Base2 工作室格式。
绝不将屏幕分割成并排竞争的窗格或堆叠的文本卡片墙。每个视频都使用一个统一的视觉阶段(<SinglePaneStage>):
- 最小顶部栏(
44px,内置于SinglePaneStage):- 左侧显示主题标题 + 活动部分标签;右侧显示微妙的步骤计数器 + 细进度条。
- 一个统一的 Log2Base2 阶段(
SinglePaneStage— 100% 宽度):- 聚焦的单行聚光灯标题:在活动规范/契约行中高亮显示当前语音元素(例如
replicas: 3、ConsistentHash、WAL、CircuitBreaker),使用borderBottom: "2px solid #FACC15"(绝不添加水平内边距),并在triggerFrame处添加一个紧凑的活动标注标签(term→architectural role)。 - 全宽沉浸式 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 个方框。 - 在包含行进请求包、故障转移级联或自动扩展动画的节拍中,设置
"motionStepFrames": 2。 - 展示,而非讲述:直接在同一全宽
1600×680SVG 画布内(必要时使用<clipPath>),将请求包在节点间的移动动画与实时延迟/队列/追踪条一起呈现,绝不在分离的分屏方框中展示。 - 始终运行
npm run lint,使用read_file检查代表性静止帧(npx remotion still),并将最终.mp4保存到out/、项目根目录和工作区根目录。