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.
examples/rag/shots_src/G1/BUILD_NOTES.md
View on GitHub# G1 构建笔记(第 1 章上半:SC01–SC05,帧 78–743)
## 镜头表
| id | 帧 | 文件 | 内容 | 节拍对齐(字幕块起始 → 元素入场帧) |
|---|---|---|---|---|
| G1-SC01 | 78–167 | `SC01.tsx`(骨架在 `layout.tsx`) | 左 LLMIcon(400,360,170)「大模型」缩放入场 + 紫柔光呼吸 + 3 颗小星;右侧三个虚线框 (720,200/340/480, 440×100) 自右滑入 Δ300、2 帧错峰,编号徽章(Orbitron)glitch | 86 → LLM 缩放 84–105,halo 脉冲 100–134,小星 96/100/104;116 → 框 116/118/120,徽章 128/130/132 |
| G1-SC02 | 168–302 | `SC02.tsx`(导出 `Box1Content`, `llmAccentAt`) | 框① 边框灰→紫 11 帧 + 「知识截止」紫标签胶囊滑入;时间轴 LineArrow 730→1150 draw-on 20 帧,左侧 3 白点随尖端亮起;中点 x940 橙刻线 + ORANGE Pill「训练截止」自下弹起;右侧 3 个灰「?」圆 2 帧错峰缩放;LLM 神经元紫→灰→紫 | 176 → 变色/标签 176;186 → 轴 186–206,红标 196;233 → ? 点 233/235/237;275 → 闪灰 275–287 |
| G1-SC03 | 303–445 | `SC03.tsx`(导出 `Box2Content`) | 框② 变紫 + 「读不到私有数据」;一行:DocIcon×2 + 简笔锁 + 「内网文档」|「会议纪要」文档 + ORANGE「昨天」;框②←LLM 虚线自框向 LLM 画出;会议纪要自右滑入 → 左推 36px → 红叉 draw-on → 回弹 4px;框① 内容淡到 0.5 | 311 → 变色/标签 311;320 → 文档 320/322 缩放,锁+文字 glitch 326,虚线 330–346;380 → 滑入 380–402,左推 402–414,红叉 406–418,回弹 414–420 |
| G1-SC04 | 446–612 | `SC04.tsx`(导出 `Box3Content`) | 框③ 变紫;聊天式两行:左上问句气泡「差旅报销的上限是多少?」自左弹入;右下灰胶囊「我不知道」glitch 后被红叉划掉并淡出;答复气泡打字机「每天 1000 元,全国统一」(数字 ORANGE,2 帧/字,光标闪烁);框右上角 RED_DEEP TagBlock「幻觉」glitch(slices 6) + 答复边框 8 帧变红 + 红柔光;611–612 整组 exitFade | 454 → 变色 454;463 → 问句 463–485;499 → 灰胶囊 499,红叉 505–517,淡出 526–533;534 → 答复 534,打字 534–562;588 → 「幻觉」588,边框变红 588–596 |
| G1-SC05 | 613–743 | `SC05.tsx` | 清场:中央 LLMIcon(640,330) 缩放入场;Orbitron「?」90px glitch(rgbSplit 6);紫色循环箭头(r128、−70°→250°)draw-on 24 帧 + 底部「重新训练」胶囊;左下三根橙渐变成本柱 2 帧错峰长出 + 「¥」弹出 + 「成本」胶囊;右下日历卡缩放入场,翻页 10 帧(今天→明天,文档变灰)+ 「已过期」橙标 glitch;末帧不离场 | 621 → ? 621;637 → 环 637–661,胶囊 645;670 → 柱 670/672/674,¥ 682/684/686,胶囊 670;692 → 日历入场 674–695,翻页 692–702,已过期 704 |
`index.ts`:`SHOTS_G1` 5 个镜头首尾相接(167|168、302|303、445|446、612|613);`BG_G1 = []`(无星点/雾底覆写)。
## 结构与复用
- `layout.tsx`:SC01–SC04 共用骨架,**所有状态是绝对帧号 N 的纯函数**(`LLMBlock`/`DashedBox`/`LabelTab`/`Scene1Frame`、`boxAct/boxPast/pastOpacity`、`mixHex`、`Sparkle`)。四个镜头挂同一份代码 → 镜头边界(167→168 等)零跳变;后一镜头直接 import 前一镜头导出的 `BoxNContent`,动画因 N 已过自然处于完成态,并按 `pastOpacity` 淡到 0.5("灰 = 已过阶段")。
- ui.tsx 图元:`LLMIcon / DocIcon / Box / Pill / TagBlock / CText / Svg / LineArrow / Cross`;调色 `PURPLE / PURPLE_LIGHT / GREY / GREY_MID / GREY_LIGHT / ORANGE / CORAL / RED_DEEP / WHITE / TEXT_GLOW`;动效 `fadeIn / scaleIn / exitFade / abs`。
- common:`GlitchIn / glitchOpacity / powOutRemain / easeInOutPow / clamp01 / rnd / FONT_HEAVY / FONT_ORB`。
- 组内自补图元:`Sparkle`(四角星)、`Lock`(简笔锁)、`Bubble`(聊天气泡,tail 侧小圆角)、`LoopArrow`(圆弧箭头,头骑在尖端)、`CalPage`(日历页)、`ScaleAt`(定点缩放包装)。
## 关键参数
- 虚线框:`2px dashed`,未激活 `GREY #A0A0A1`,激活 `PURPLE_LIGHT #A175F1` + `0 0 18px 4px rgba(102,45,248,.45)`,填充 `rgba(0,0,0,.42)`(半透明,星点可透,不算不透明黑底);灰→紫 11 帧线性混色。
- 标签胶囊:骑在框顶边 (x+30, y−17, h34),24px/700,填色 `#3A3A3A→PURPLE` 随激活度;滑入 Δ40/16 帧。
- 徽章:r17 黑底 + 2px 边,Orbitron 22px/700。
- 入场:缩放 `scaleIn(n,21)` 以元素中心为原点(transformOrigin 写法 B);滑入 `powOutRemain(n,22,2.5)`;glitch 用 `GlitchIn`(全画幅容器)。
- 循环箭头:`polyline` 72 段,进度 `1−(1−t)^1.8`,头长 20 宽 18,`drop-shadow(0 0 6px rgba(102,45,248,.85))`(本镜头唯一 filter,另有 2 个 DocIcon 的 BLOOM_SOFT)。
- 日历翻页:顶页 `perspective(700px) rotateX(−90·easeInOutPow(2)(t))`,`transformOrigin 50% 0%`,卡 `overflow:hidden`(正向旋转会朝观众放大并溢出,已改负向)。
- 单帧 filter 实例:SC03 ≤ 4(3 DocIcon + 0),SC04 ≤ 4,SC05 ≤ 3;DOM 节点 < 300。
## 自检 still(`rag/stills/G1/`,共 54 张)
| 镜头 | 帧 | 发现 / 处置 |
|---|---|---|
| SC01 | 78, 85, 95, 106, 120, 128, 145, 160, 167 | 正常。78 帧仅星空(LLM 84 起);120 帧框滑入中段;167 与 168 完全一致 |
| SC02 | 168, 177, 182, 192, 200, 215, 236, 240, 278, 302 | 正常。278 帧神经元处于灰紫中间态 |
| SC03 | 303, 312, 324, 338, 360, 388, 404, 411, 418, 445 | **修 1**:会议纪要左推后与「内网文档」文字重叠 → 左组左移、MEET_X 1000→1016;**修 2**:滑入途中穿过静态「会议纪要」文字 → 文字随滑入一起进入。388/445 为修后图 |
| SC04 | 446, 455, 470, 502, 512, 540, 556, 592, 612 | 正常。470 问句气泡滑入中段跨框左缘(过渡态,允许) |
| SC05 | 613, 622, 632, 648, 662, 676, 684, 694, 697, 698, 700, 706, 720, 743 | **修 3**:翻页正向 rotateX 朝观众放大溢出卡框 → 负向 + overflow hidden(697/698/700 为修后图)。613 帧为空场(LLM 从 0 长出,硬切清场) |
| 组界 | `boundary_first_f0078.png`, `boundary_last_f0743.png` | 78 帧:仅背景 + G0 HUD;743 帧:SC05 完成态(G0 HUD 在 742–751 间空缺,属 G0 换词间隙) |
字幕带 y637+ / 进度条 y687+ 未放任何内容;最低字号 22px(「?」点、昨天/已过期/训练截止 胶囊、气泡正文);颜色全部取自 ui.tsx 调色板;画面文字不含调研数字(差旅示例文本为全局约束 #2 规定的虚构语境)。
## 30 帧测渲(协议 §6)
`npx remotion render build_dev_g1_6 RagG1 /tmp/rag_test_G1 --sequence --image-format=jpeg --frames=559-588`(N 560–589,SC04 元素最多段):**3.25 s / 30 帧 ≈ 9.2 fps**,达标。
## 与分镜表的偏差 / 待主会话决定
1. **SC04 示例文本**:分镜表写「公司去年营收是多少?」/「是 3.2 亿元,增长 18%」,但末尾全局约束 #2 要求全片统一「差旅报销」语境。已按全局约束改为问句「差旅报销的上限是多少?」、幻觉答复「每天 1000 元,全国统一」(与后续 RAG 正确答复「住宿上限每天 600 元[1]…」形成对照)。若主会话更想保留营收版,改 `SC04.tsx` 顶部 `Q_TEXT/A_TEXT` 两个常量即可(气泡宽度 262/268 可容 11–13 字)。
2. SC02 "可整体缩到 0.9 腾空间"未采用:保持 1.0 使四镜头零跳变;框内元素按 22–24px 排布已够。
3. SC01 三个虚线框为**半透明**填充(rgba(0,0,0,.42))而非纯黑,以保留"空框"感与星点;如需与其他组的 Box(纯黑)统一,改 `DashedBox` 一处。
4. SC03 "会议纪要向左移向 LLM 12 帧" 实现为 36px 小幅推进 + 红叉拦截 + 4px 回弹(文档留在框内,不穿越框②)。
5. SC05 未画 LLM 下方「大模型」标签(环内空间不足,图标已在 SC01 命名)。
## 对 ui.tsx / 共用层的建议
- `LLMIcon`:`glow` 目前只能开/关固定强度;建议接受字串(自定义 boxShadow)或数值强度,便于做柔光脉冲(本组用外置 halo div 绕过)。
- `Box`:建议加 `overflow?: boolean` 或让 `style` 可控 borderRadius 字串(本组用 `style` 覆盖 borderRadius 做气泡,能用但不直观)。
- 可提升到 ui.tsx 的组内图元:`Bubble`(聊天气泡,第 3 章生成/引用镜头会复用)、`LoopArrow`(循环箭头,第 2 章"增量更新"S20 可复用)、`Sparkle`、`Lock`(权限标签 S19 可复用)、`mixHex`(灰→紫变色是全片通用动效,建议进 common/easing)。
- 磁盘:`$TMPDIR/remotion-webpack-bundle-*` 曾累积 90 个/6.2 GB 触发 ENOSPC,本组已按协议清理 >3 min 的旧包并删除自己的旧 `build_dev_g1_*`;建议各组 still 后顺手清理。当前保留 `build_dev_g1_6`(117 MB)供 QC 复用。
## QC v1 修复(qc_v1_C1.md · G1 条目)
| 条目 | 根因 | 修法 | 复核帧(`rag/stills/F12/`) |
|---|---|---|---|
| 【低】SC02 275–290「它一概不知」画面变化过弱、251–311 静止 60 帧 | 节拍只绑在 LLMIcon 内 4 个 r≈8px 神经元点的紫→灰→紫(差分 <0.25) | ① `layout.tsx` `LLMBlock/Scene1Frame` 新增 `haloK?`(柔光强度,默认 1,其余镜头零变化);`SC02.tsx` 新增 `llmHaloAt(N,275)`:紫柔光 4 帧降到 0.1、保持 4 帧、6 帧回到 1(与神经元闪灰同步)。② 框① 右侧三个灰「?」275/278/281 依次 10 帧三角脉冲:scale 1→1.3→1、描边/文字 GREY→WHITE→GREY + 白 drop-shadow/textShadow | 275(起点,与原一致)、279(halo 熄灭 + 第 1 个「?」白闪峰值)、283(第 2 个「?」峰值)、289(第 3 个「?」+ halo 回升)、295(全部复原) |
- tsc 通过;未改帧区间、未改 index.ts;SC01/SC03/SC04 共用骨架 `haloK` 默认 1,镜头边界仍零跳变。
- still 用 tag `g12`(`build_dev_g12`,与 G2 修复共用一个 bundle)。
## 闪烁整改(用户裁定 2026-09-06「不要给每段出现的字都加闪烁,只给重点加」· 协议 §8)
- **改前 7 处 / 9 实例**:`layout.tsx` DashedBox 编号徽章 `glitchOpacity`(×3 框,SC01 128/130/132);SC03 锁+「内网文档」GlitchIn 326;SC04「我不知道」GlitchIn 499、「幻觉」GlitchIn 588(slices 6);SC05「?」GlitchIn 621(rgbSplit 6)、「重新训练」GlitchIn 645、「已过期」GlitchIn 704。
- **改后 3 处**(每镜头 ≤1,全部为短板重点词):
| 镜头 | 保留 glitch | 说明 |
|---|---|---|
| SC02 | 「知识截止」LabelTab(176) | 白名单。原为 slideUp Δ40 + fadeIn,**新开** `LabelTab glitch` → 12 帧纯透明度模板、定点不滑 |
| SC03 | 「读不到私有数据」LabelTab(311) | 白名单。同上新开;原 326 锁+「内网文档」的 glitch 改 SoftIn |
| SC04 | 「幻觉」TagBlock(588) | 白名单。去掉 `slices={6} seed={4}`(§8:rgbSplit/slices 仅片头/SC08/SC35/SC44) |
- **改为 SoftIn**(ui.tsx,8 帧淡入 + 10px 上浮,f0 不变):SC03 锁+「内网文档」326;SC04「我不知道」499(外层 dkOp 淡出仍相乘);SC05「?」621、「重新训练」645、「已过期」704。
- **改为 fadeIn 8**:DashedBox 编号徽章(n−12 起)。
- 组内图元开关:`layout.tsx` `LabelTab` 新增 `glitch?: boolean`(默认 false),只有 SC02/SC03 显式开;`DashedBox` 不再有闪烁。SC01/SC05 现为零 glitch。
- tsc 通过;帧区间 / index.ts 未改;still tag `x12`(`build_dev_x12`,与 G2 整改共用),输出 `rag/stills/X12/`:
132/142(编号徽章淡入中/完成)、180/188(知识截止 glitch 中/落定)、315/323(读不到私有数据)、330/338(锁+内网文档 SoftIn)、503/511(我不知道)、592/600(幻觉)、625/633(?)、649/657(重新训练)、708/716(已过期)。
- still 复核(Read 全部 18 张):SoftIn 处 f0+4 半透明、f0+12 落定,位置/尺寸与改前一致,无穿字幕带/HUD;「知识截止」「读不到私有数据」「幻觉」在 f0+4 为 glitch 序列 0.5 档、f0+12 实心,「幻觉」已无切片错位。bundle 50 s 内出齐(含首次打包)。
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 |