anything2explainer

The saved excerpt is a snapshot from when this skill was listed. The external source remains the complete and most current version.

---
name: anything2explainer
description: 给一个主题，产出一条黑底 MG 风格（幕底可选星点或点阵波）、有配音字幕章节进度条的科普讲解视频（中文或英文；Remotion 代码动画；时长由用户定，常用 3–5 分钟）。内含可编译模板、图元库、配音/分镜/渲染工具、风格与动效规范、多 agent 分工协议与 QC 判据，以及一条完整样片（《RAG 与知识库》）作为质量标尺。Turn any topic into a narrated motion-graphics explainer video in Chinese or English, on a black canvas with a star-field or dot-field backdrop, TTS voiceover, subtitles and a chapter progress bar, every frame drawn in code with Remotion. Use when the user asks for an explainer, educational or science-communication video about a topic, or wants an article or document turned into a video.
---

# anything2explainer

把任意技术/知识主题做成一条**原创**科普讲解视频。视觉体系固定（黑底幕底——点阵波默认、星点雾底可选（`config.bg`）、白线条图形 + 紫色重点、超粗黑体、44px 白字黑边字幕、底部章节进度条、顶部胶囊 HUD），变化的是内容与规模：时长由用户定（确认点 1），解说词、分镜、镜头代码随之而变。样片：`examples/rag/`（4′35″，44 句、44 镜头，8 个构建组并行 40 分钟，两轮 QC）。**目标是和样片风格一致、质量相近**——先看 `examples/rag/frames/overview_*.jpg` 建立标尺，再开工。

## 何时用
- 用户给出主题（"讲一下 X"）要一条讲解视频；或给出一篇文章/文档要改成视频。
- 不适用：复刻某条现有视频（用 video-replica）、真人口播、需要实拍为主的片子。

## 硬性原则
1. **原创**：画面全部代码绘制；可选 B-roll 只能用免版权素材（Mixkit 等）并登记 MANIFEST；不得使用任何现有视频的帧或片段。视觉语言的灵感来自抖音 @图灵宇宙（见 README 致谢），写交付说明时照实说明「风格致敬、画面自绘」。
2. **事实有出处**：画面上出现的每个数字、英文术语、年份、人名必须能在本片调研文档里找到来源 URL；调研没核实的不上画面（配音也不说）。
3. **全片一个示例语境**：解说与画面用同一个贯穿例子（样片用"差旅报销"），跨组一致。
4. **闪烁只给重点**：每个镜头 ≤1 处 GlitchIn，只给该镜头的核心术语；其余文字/标签/HUD 换词一律 `SoftIn` 淡入。
5. **字幕带 y637–690 与进度条 y687–720 不放内容**；入场轨迹不得穿过字幕带；镜头衔接必须"前一镜头末 N 帧离场到 α=0 + 后一镜头首帧起入场"；**章界还要有内容承接**——章末解说留钩子、章首先回指上一章成果再开题、章首镜头承接上一章的主角 / 象征物，不能「讲完就切卡」（细则 `reference/narration-storyboard.md` §1「章界要有起承转合」与 `narration-guidance.md` §13）。
6. **持续动作 + 落位停留，「入场即停」和「落位即切」都是缺陷**：每个字幕块的动词要有持续到下一拍的动作（数据流 / 打字机 / 逐格点亮 / 光点沿线跑），元素入场后不许完全静止 >3 s；**不为凑指标给静止的物体加漂浮、飘动、呼吸**。每个镜头末拍元素落位后要有 **30–45 帧（1–1.5 s）稳定期**再离场：稳定期内不新增元素、不运镜、不换 HUD，已在跑的动词动作可以继续。没有其它运镜的镜头可加 1.0→1.05 慢推。`scripts/motion_check.py` 量化（最长静止 ≤3 s、末拍稳定期 ≥30 帧，成片复测为准）。细则 `reference/composition-and-light.md` §7。
7. **每镜头一个主角、光跟主角、有运镜**：主角高度 ≥170px 或大字 ≥96px 并带紫柔光 / 光环 / 硬投影；配角不发光；内容区最大物体 <110px 不得持续 >45 帧；每章 ≤1 个高光时刻按各自类型编排、≥3 次运镜；**三轮紫光横扫（`LightSweep` + `StageLine` + `GhostText` 的登场型开场）全片 ≤2 处，只给本片核心概念首次登场（可选再给结尾回扣），写进分镜「扫光白名单」，其余高光时刻不用扫光**；背景只有幕底（星点或点阵波），不撒碎屑。细则 `reference/composition-and-light.md` 与 `motion-vocabulary.md` §镜头运动，反例 `examples/contrast/`。
8. **镜头按画面单元分，不按句分**：短句（<3 s 或只有一个字幕块）并入相邻镜头当一个节拍，不单独入场 + 离场；单镜头 ≥120 帧；能承接（同一元素带到下一镜头）就不清场。停留预算靠时长换：解说词用**空行分段**（一段 = 一个镜头 2–4 句），`tts_build.py` 段内句间只留 10 帧、段末 30 帧（`GAP` / `PARA_GAP`）——**小句之间不加停顿，只有一段话讲完或切下一个画面时才停**；成片比纯语音长 5–8% 是设计内的，不要为压时长删停留。

## 四个确认点（必须停下来等用户回话，不要自己往下走）
1. **时长与语言**（阶段 1 派调研的同时问，写文案之前必须有答案）：「想做多长？中文还是英文？」都不要默认。时长决定内容丰富程度与全流程规模——句数、镜头数、构建组数都从下表推；章数按内容结构分，但受时长约束：**<3 分钟单章**（不出章节卡，进度条整条一段），3–5 分钟 3–4 章、每章 ≥60 s，5–8 分钟 4–6 章。用户没概念时给这张表让他挑，并说明「越长要覆盖的知识点越多，做的时间也按比例涨」。

   | 时长 | 中文字数 | 英文词数 | 句数（镜头数略少） | 章数 | 构建组（每组 5–7 镜头） | 产出耗时 |
   |---|---|---|---|---|---|---|
   | 2–3 分钟 | 650–880 | 280–420 | 24–32 | 1（不分章） | 4–6 | ≈1 小时 |
   | 3–5 分钟（样片档） | 1100–1400 | 420–700 | 40–50 | 3–4（每章 ≥60 s） | 8 | ≈2 小时 |
   | 5–8 分钟 | 1650–2200 | 700–1150 | 60–80 | 4–6 | 10–14 | ≈2–3 小时 |

   语速：**中文默认不加速**（edge 云希 `RATE=+0%`，约 5.5 字/秒）、英文 edge-tts 约 2.9 词/秒；**英文默认引擎 kokoro `am_liam` 实测只有 2.3 词/秒，成片密度 ≈2.1 词/秒 → 按 ≈125 词/分钟写（5 分钟 ≈640 词 / 48 句），上表英文词数乘 0.78**。加段末 / 章节留白后中文成片密度约 4.0–4.5 字/秒（比纯语音长 5–8%，是停留预算）。章数不写死在代码里（进度条按 `CHAPTER_STARTS.length` 等宽分章，章节卡从第 2 章起才出）：单章片自然没有章节卡；章多时章名要短（槽宽 = 1280 ÷ 章数）。
   **英文片**：阶段 0 建完项目就把 `src/config.ts` 的 `lang` 改成 `'en'`、`title.rest` 留空，其余差异（不压窄 / 基线 / 字幕与章名长度预算 / 配音默认 Liam）见 `reference/narration-storyboard.md` §2.5 与 `style-guide.md` §3.1。视觉标尺仍用中文样片的帧。
2. **解说词定稿**（阶段 2，配音之前）：把 `script/narration.txt` 全文 + 章节划分 + 字数/预估时长贴给用户，问「这版文案可以吗」。**章名与 HUD 小节名单独列一行**（进度条上就这几个词），问「只看这几个词，能不能说出每章讲什么」；多章片再把**每个章界的两句**（上一章末句 + 下一章首句）并排列出来，让用户看接得顺不顺——它们是导航标签不是俏皮话，判据、正反例与自检三问见 `reference/narration-storyboard.md` §1。**顺便交代配音**：默认用免费本地/云端 TTS（中文 edge-tts 云希、英文 kokoro `am_liam`，见确认点 3），够用但不是最好；想要更高音质就换更强的 TTS 模型或商用 API（自己生成成品 wav 放进 `public/assets/<slug>/audio.wav`，流程不变）。定稿后帧号会被每个镜头硬编码，改一个字就要全片重对位——这是