anbeime/skill / skills/anything2explainer/anything2explainer
anything2explainer
Unverified给一个主题,产出一条黑底 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.
reference/motion-vocabulary.md
View on GitHub# 动效词汇表(n = N − f0,N 为成片帧号;全部纯函数,随机只用 rnd)
## 入场
| 名称 | 公式/组件 | 帧数 | 用途 |
|---|---|---|---|
| **SoftIn(默认)** | `<SoftIn N f0>`:opacity easeOut(2.5) 首帧≈25%→1,上浮 10px→0 | 8 | 一切文字、标签、HUD 换词、小图标 |
| GlitchIn(重点词) | `<GlitchIn N f0>` 12 帧透明度模板 [.5,1,.5,0,.5,0,.5,1,.75,.5,.75,1] | 12 | **每镜头 ≤1 处**,只给核心术语;rgbSplit/slices 重口味只给片头、章节卡、主角登场、片尾 |
| 自下滑入 | `top = yEnd + slideUp(n, Δ)`,Δ·(1−n/22)^2.5 | 22 | 卡片、图形;**Δ≤120**(Δ300 会穿字幕带),配前 6 帧 fadeIn |
| 侧向滑入 | `left = xEnd − Δ·powOutRemain(n,18,2.5)`,Δ 260–320 | 18 | 安全区外进入的替代方案 |
| 缩放入场 | `scale = scaleIn(n)`(cubic-bezier(.1,.1,.35,1)) | 21 | 图标、球、卡 |
| 错峰 | 第 i 个元素 f0 + stagger(i, 2) | 2/个 | 列表、卡片阵列;**不要用 GlitchIn 做错峰**(像掉帧) |
| draw-on 线/箭头 | `<LineArrow p={clamp01(n/20)}>`,箭头自根部长出、头随杆 | 16–28 | 连接、指向 |
| draw-on 框 | SVG stroke-dasharray + dashoffset,或 clipPath rect wipe | 20–30 | 虚线框、勾、路径 |
| 打字机 | `text.slice(0, floor(n/2))` 每 2 帧 1 字 | 按字数 | 问句、答复、提示词规则 |
| 计数 | Counter,值 = kf(n,[[0,a],[20,b]]) 取整 | 14–26 | 年份、百分比、token 数 |
| 逐行 wipe | 每行 2 帧 clip 宽 0→100% | 2/行 | 文档卡文本线 |
## 强调
| 名称 | 公式 | 帧数 |
|---|---|---|
| 脉冲 | `scale = emphasisPulse(n, {peak: 1.11, up: 13, hold: 4, down: 13})` | 30 |
| 灰→紫变色 | `mix(GREY, PURPLE, clamp01(n/11))`(边框与填充同变) | 11 |
| 柔光亮起 | boxShadow GLOW_PURPLE_S 的 α 0→1 | 8 |
| 白闪 | 元素 filter brightness 1→1.6→1 | 6–10 |
| 高亮条 wipe | 紫色半透明条自左 scaleX 0→1 | 12 |
## 光效(谁发光、怎么亮;规则见 `composition-and-light.md`,组件在 `src/fx.tsx`)
| 名称 | 公式/组件 | 帧数 | 用途 |
|---|---|---|---|
| 主角常亮 | `<HeroGlow x y w h N>` 双层紫柔光 + 30 帧呼吸 ±15%;或 `LLMIcon glow` | 常驻 | **每镜头主角必带**;配角不带 |
| 紫光条横扫 | `<LightSweep N rounds={[T0+4,T0+22,T0+40]}>` 每轮 3 条、2 帧错峰、16 帧、α .6/.55/.55 白芯 | 3×16 | **登场型高光时刻专用,全片 ≤2 处**(扫光白名单):核心概念首次登场 + 可选结尾回扣;大数字 / 论点 / 象征物型不用 |
| 舞台光线 | `<StageLine N f0 flashAt>` 14 帧展宽到 720 → 呼吸 → 节拍帧白闪 3 帧消失 | 14+ | 主角落点的预示线;只随扫光出现(登场型专用) |
| 幽灵轮廓 | `<GhostText opacity={ghostOpacity(N,f0,until)}>` 白描边 10% 隐现 | 12 淡入 | 主角大字出现前约 40 帧;只随扫光出现(登场型专用) |
| 光环 | `<HaloRing p fillOp phase half>` 白描边 draw-on 20 帧 + 紫渐变 12 帧 + 3 圈虚线波纹 2 帧一相位 | 20 | 象征物脚下(back / 主体 / front 三层) |
| 紫硬投影 | 大字 textShadow `6px 6px 0 PURPLE, 0 0 28px rgba(102,45,248,.45)`(`BigNumber` 默认) | 常驻 | Audiowide / Orbitron 大字、片名 |
| 紫描边 | Noto 900 大字 `WebkitTextStroke 2.5px PURPLE` + `paintOrder: stroke fill` + 紫柔光 | 常驻 | 结论大字 |
| 橙色发光 | `GLOW_ORANGE` / textShadow 橙 | 常驻 | 指标数字、结果项(−49%、¥3.20) |
| 柔光亮起 | boxShadow `GLOW_PURPLE_S` α 0→1 | 8 | 重点转移到某一项 |
| 光先灭 | 离场前 6 帧 glow α→0,再整体归零淡出 | 6+8 | 任何带光元素的离场 |
| 白闪 | filter brightness 1→1.6→1,或 `StageLine` 的 flash | 3–6 | 事件:点击、命中、落槌 |
一帧内:主角光 1 处 + 重点光 ≤1 处;光只有紫 / 橙 / 红三色;白 bloom 只给结构线条。三轮扫光 → 光线 → 轮廓 → 白闪 + glitch 的完整编排见 `composition-and-light.md` §3 与 `fx.tsx` 的 `SET_PIECE`。
## 离场(**硬切前必须归零**)
| 名称 | 公式 | 帧数 |
|---|---|---|
| 归零淡出 | `opacity = 1 − (n/N)^1.5`(N=6–12),末帧 0 | 6–12 |
| 加速下摇 | `translateY(exitAccel(n, c))`,c 0.2–1.2,配归零淡出;限幅 ≤10px 若旁边有字幕带 | 6–12 |
| 加速上出(覆盖层) | `dy = −(n/11)^2·440`,`opacity = 1 − (n/11)^1.6` | 12 |
| 左滑离场 | `translateX(−c·n²)` + 归零淡出 | 12–15 |
| 变灰下沉 | 11 帧变灰 + 12 帧下沉 12px("记忆"退居次要) | 12 |
禁止:6.7%/帧的 exitFade 单独用于硬切前(末帧还剩 40–60% 会"啪");可见度 >20% 时 Sequence 结束。
## 镜头运动(运镜;组件 `fx.tsx` 的 `CameraRig`/`camAt`)
> 预算依据:风格来源的原片每分钟 6.6 次整体运镜、平均 16 帧,含推近 / 拉远 / 视差 / 长滚动;早期两片只有 2.2–2.5 次/分钟且零次推近,观感差距主要在这里(复盘见 `lessons.md` §风格传递)。下面是预算与词汇。
**预算**:每章 ≥3 次运镜、每镜头 ≤1 次;单次 30–45 帧 easeInOut;运镜期间不做 GlitchIn、不做错峰入场(先入场停 ≥10 帧再动);文字可读性优先,scale ≤1.33(描边随组放大,>1.4 会显粗);顶部 HUD / 流程轨 / 字幕在屏幕空间不动,运镜只动内容层;**运镜不进末拍**:运镜结束帧 ≤ 离场起点 −30,推完停 1–1.5 s 再走(1.0→1.05 慢推贯穿例外)。
| 名称 | 公式 / 组件 | 帧数 | 何时用 |
|---|---|---|---|
| 定点推近 | `<CameraRig N keys={[{f:a,x:640,y:360,s:1},{f:a+33,x:px,y:py,s:1.33}]}>`(原片 1→1.329 / 33 帧 bezier(.6,.05,.4,.95);1→1.358 / 35 帧 幂 2.5) | 30–40 | 主角说到第 2 个节拍还要停 ≥60 帧时推向主角;推近同时顶/底暗角淡入 18 帧 |
| 拉远 / 拉回 | 同上反向(原片 37–42 帧 bezier(.55,.05,.4,1)) | 37–45 | 从局部回到全景、章末收束、露出被裁掉的第二主体 |
| 承接位移 | 上一镜头主角 `kf` 16 帧 easeInOutPow(2.5) 缩到 0.6 并移到角落,让位给新主角;两镜头共用同一组件同参数 | 16 | 每处「不离场」承接都要有,不要原地消失重画 |
| 整组平移(舞台平移) | 整组作为刚体左移一屏 / 上移 110px(原片流程图段末、传送带升起) | 20–30 | 一屏讲完、下一屏在旁边;列表超过一屏 |
| 整页滚动 | y 位移 easeInOutPow(2.5),可带滚动条 | 43 | 长列表 / 长文档卡 |
| 视差 | 2–3 层不同速度(原片 6.4 / 9.6 / 12.8 px/帧,背景层压暗 ×0.43),或内容层随前景 1.33× 位移 | 26+ | 表现「很多」「世界很大」:截图墙、文档墙、日志流 |
| 加速出画 | 整场景向下 / 向左平移,位移表持续加速,最后 1 帧全部出画 | 12–25 | 章末清场、比喻结束 |
| 甩出(whip) | 空心副本横向偏移 −63 / +38px 1–3 帧后复位,或整组 3 帧位移 + 方向模糊 | 1–3 | 冲突 / 对比切换的瞬间,一章 ≤2 次 |
| 屏幕空间暗角 | 顶/底 linear-gradient 黑 α .38–.42,淡入 18 帧 | 18 | 推近时同步;把注意力压到中央 |
运镜也算「每句一处可察觉变化」——一句没有新元素时,用一次 30 帧推近替代硬塞元素。
## 节拍
- 元素出现帧 = 对应字幕块起始帧(`script/timeline.md` 每个 | 块);容差 −6…+3。
- 每句解说至少一处可察觉的画面变化;元素完全静止 >3 s 才是缺陷,**不为凑动作给静止物体加呼吸 / 漂浮 / 飘动**(`composition-and-light.md` §7)。
- **镜头 ≠ 句**:镜头按画面单元分,短句(<3 s 或只有一个字幕块)并入相邻镜头当一个节拍,不单独入场 + 离场;单镜头 ≥120 帧;能承接(同一元素带到下一镜头)就不清场。
- 句间空白:段内 10 帧(`tts_build.py` GAP,只够一口气)、段末 30 帧(+`PARA_GAP`)、章前 45 帧——**停顿只在段末与换页处**;成片比纯语音长 5–8% 是停留预算。镜头区间 = [首句 from−8, 下一句 from−9](章末 / 片末 = 末句 to+2),末 8 帧离场、后一镜头首帧起入场。
- **落位停留**:末拍元素落位帧 → 离场起点 ≥30 帧(目标 30–45,1–1.5 s),稳定期内不新增元素、不运镜。段末句末块 <45 帧的(`tts_build.py` 带 ¶ 列出)三选一:末拍元素前挂到上一块 / 文案加 `## gap 15–30` / 并入相邻镜头。
- 章前空白 45 帧给章节卡:上一章末镜头 exitFade 归零 → 章节卡 3 帧后 glitch → 末 12 帧加速上出 → 新章 HUD 从卡结束下一帧淡入。
- **章界不只是帧衔接**:章首第一个镜头要承接上一章末镜头的主角 / 象征物(同组件同参数,可缩小移位),不要「清场 → 章节卡 → 全新画面」;解说同时要承上启下(`narration-storyboard.md` §1「章界要有起承转合」)。
## 衔接(分镜表必须写清两侧)
- 写法:「A 末 8 帧归零淡出 + 轻微下摇;B 首帧起首批元素 SoftIn」。不要只写"硬切"(两侧会各自理解为"我不动、你从节拍帧才入场"→ 6–8 帧空场)。
- 组界帧(两个构建组交界):两组各自对分镜实现,QC 单列组界帧核对;相邻 Sequence 允许 0–4 帧重叠。
- 承接同一元素(如文档卡从上镜头带到下镜头):两镜头共用同一组件 + 同参数,交界帧像素一致。
- 承接优先于清场:一个节拍讲完的短句跟在前一镜头里(承接位移 16 帧让位),不要为它清场重画;清场留给章首、高光时刻与语境切换。
## 闪烁白名单规则
- 每镜头 ≤1 处 GlitchIn,只给"这一镜头在讲的那个词";分镜表里 glitch 一词只出现在那一格,其余写"淡入"。
- HUD 换词、流程轨、编号、角标、小标签、数字、图标:一律 SoftIn/淡入/缩放。
- 终检用 12 帧模板扫描全片,命中数必须等于白名单条数。
- **扫光白名单**同理:三轮 `LightSweep`(连带 `StageLine` / `GhostText`)只出现在分镜「全局约束 §扫光白名单」列出的 ≤2 个镜头;`selfcheck.py` 按文件计数,终检按帧核对。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |