Communitygithub.com

2D长视频解说-大师技能与制作手册

端到端工作流和程序化2D矢量动画系统,用于分析参考视频(“精确视频”)并从头创建充满活力、吸引观众的长篇2D解说和生存故事视频(1920x1080 @ 30fps),以用户标志性主角“Chad”为特色。

2D长视频解说-大师技能与制作手册 是什么?

这个技能定义了一个完整的工作流和程序化动画系统,用于分析参考视频并从头开始(1920x1080,30fps,8-15+分钟,100+个镜头)创建长篇2D解说与生存故事视频。它基于一套严格的设计规则:主角始终是“Chad”(不能是“Melvin”),视觉风格由五个核心层次构成——绑定的2D主角、触感螺旋笔记本与实时手写、十月挂历倒计时、智能手机紧急警报与调查板、以及技术生存图解。该技能支持Claude Code和Python执行环境,通过ffprobe进行取证分析,使用PyCairo矢量渲染,并利用并行NVENC编码进行多工作器渲染(6个工作器)。整个系统强调程序化生成(禁止复制视频帧),并通过`index.html`交互式播放器进行验证。核心模块包括`engine/primitives.py`(相机矩阵、抖动、径向渐晕)、`engine/characters.py`(带表达式的Chad绑定)、`engine/overlays.py`(笔记本、日历、警报)和`engine/diagrams.py`(技术图解)。生产执行包含5个阶段:取证探测、模块化引擎设置、烟雾测试所有镜头、多工作器并行渲染和交互式验证。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abdulahadofficial432-arch/Gemini_Argon_Video_Skills/tree/main/.agents/skills/2d-explainer-long-videos

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

预览

来自技能 README

主角名称规则:电子邮件“致: Chad”和图书馆志愿者卡“Chad H.”
主角名称规则:蓝色“CHAD”支付卡和手写数学计算
6天后的末日闪前:Chad与僵尸群
精确视频的参考帧(2.0秒)
第1天螺旋笔记本清单:影线柱状图与移动笔手
精确视频的参考帧(54.0秒)
逃生期间“如何灭火(P-A-S-S)”笔记本覆盖图
精确视频的参考帧(503.0秒)

文档

2D长视频解说 — 大师技能与制作手册

此技能记录了用于分析和从头重新创建长篇2D解说与生存故事视频(1920x1080,30 FPS,8-15+分钟,100+个镜头)的精确工作流、视觉DNA、角色规则和高速程序化渲染架构。


1. 我如何给出指令(用户的核心方法与规则)

每当我要求你使用此技能创建或重新创建视频时,请遵循我的精确指令方法和不可协商的规则:

规则 #1:主角身份始终为 “Chad”(不能是“Melvin”)

  • 我的主要角色名称是 “Chad”(Chad H. / CHAD)。
  • 如果参考视频使用了其他名称(如 "Melvin"),你必须在其所有出现处将其替换为 "Chad":
    • 电子邮件 / 信件 / 消息: 例如 致: Chad
    • 注册表 / 志愿者卡 / 身份证: 例如 Chad H.
    • 信用卡 / 借记卡 / 银行界面: 例如 CHAD(•••• 2930)
    • 电话 / 对话气泡 / 字幕: 任何称呼或提及主角的人都使用 "Chad"。
    • 代码库与绑定系统: 在所有引擎模块和故事板UI中将角色绑定函数命名为 draw_chad(...)。

主角名称规则:电子邮件“致: Chad”和图书馆志愿者卡“Chad H.”

主角名称规则:蓝色“CHAD”支付卡和手写数学计算

规则 #2:“精确视频” 取证分析方法

  1. 投放与检查: 我提供一个参考视频(例如 Exact Video.mp4),并要求你仔细完整地阅读和分析它,然后从头重新创建完全相同的视觉风格、高活性吸引眼球的动画、动态覆盖层和节奏。
  2. 绝不复制视频帧: 输出的MP4的每一帧都必须通过程序化2D矢量代码(PyCairo)100%从头渲染,然后与音轨合成。
  3. 完整时间线检查(零猜测):
    • 运行 ffprobe 获取精确分辨率(1920x1080)、帧率(30 fps)、时长(590.87s)和总帧数(17,726)。
    • 提取60秒的视频片段(clip_0_60.mp4,clip_60_120.mp4,……)以及每个主要视觉节拍处的35-45张全分辨率1080p关键帧(frame_*.jpg)。
    • 使用 read_file 检查每个片段和关键帧,以规划出一个完整的100+镜头主时间线(t0,t1,相机 zoom0 -> zoom1,pan_x,pan_y,shake,red_pulse 和场景回调函数)。
  4. 迭代定制: 当我在第一次渲染后要求更改角色名称、属性调整或视觉调整时,更新特定的场景模块,通过 h264_nvenc 并行重新渲染受影响的片段,并立即重新合成。

2. 视觉与动态风格圣经(附参考截图)

此风格的每个视频都由五个标志性视觉层构建,这些层通过每隔2.5到5.5秒引入新的动态运动、手写笔记或切入画面来保持观众留存率:

A. 绑定的2D主角(“Chad”)

  • 比例与调色板:
    • 超大头部的圆润米白色(#EAE4DC),带有厚实的炭黑墨线轮廓(#1A1512,4.0–5.5 px 圆角和圆端)。
    • 后戴的深红色棒球帽(#B5423D),前部有一个锁孔形切口,露出尖刺的深棕色头发(#3A2B22)。
    • 绗缝深石板色羽绒背心(#3D3E44),带有水平缝合线,内穿深色长袖衬衫。
    • 棍状手臂(5.5 px 黑色描边),配圆润白色卡通手和棍状腿,带扁平椭圆形鞋子。
  • 姿势与表情:
    • 表情:neutral(中性)、worried(担忧)、shocked(震惊)(白色巩膜放大 + 瞳孔放大)、grimace_teeth(龇牙)、wince(畏缩)、panting(喘息)、asleep(睡着)、angry(生气)。
    • 姿势:idle(空闲)、walk(行走)(正弦波腿/手臂摆动 + 头部上下晃动)、sleep_bed(床上睡觉)、sit_bed(床上坐)、sit_chair(椅子上坐)、phone_ear(打电话贴耳)、phone_look(看手机)、point_right(指右)、tremble_jugs(颤抖的水罐)、crouch(蹲伏)、brace_door(顶门)、aim_extinguisher(瞄准灭火器)。

6天后的末日闪前:Chad与僵尸群

精确视频的参考帧(2.0秒)


B. 触感螺旋笔记本与实时移动的笔手(draw_notebook_card)

  • 纸张构造: 奶油色横线纸(#F5F0DC),水平浅蓝色划线,垂直红色边距线,3个打孔装订孔,左侧边缘银色的螺旋线圈,以及右上角半透明的倾斜透明胶带(draw_scotch_tape)。
  • 实时书写手(draw_hand_with_pen): 一条长深色袖子手臂,配白色卡通手,握着蓝色、黑色或红色马克笔,实时跟踪正在绘制的活动角色或条形图!
  • 行类型:
    1. bar_row:迷你矢量图标(water 水,food 食物,cash 现金)+ 递进的手写标签 + 填充有对角影线(#3B8EEA 蓝色,#E8922D 橙色,#58B86C 绿色)的矩形计量表。支持红色删除线更新(2加仑 -> 30加仑,3天 -> 24天,$40 -> $640)。
    2. tally:五笔一组计数(蓝色墨水 |||| + 红色墨水对角第五划 /),带有实时计数器(JUGS 3..28,TRIP 1..11/11)。
    3. pass_row:大型彩色藏头字母(P-A-S-S 代表 如何灭火:拔销子、瞄准根部、挤压手柄、左右扫射)。
    4. month_droplets:6×5 网格的30个蓝色水滴(30加仑 = 1个月)。

第1天螺旋笔记本清单:影线柱状图与移动笔手

精确视频的参考帧(54.0秒)

逃生期间“如何灭火(P-A-S-S)”笔记本覆盖图

精确视频的参考帧(503.0秒)


C. 十月挂历倒计时(draw_october_calendar)

  • 用红色的图钉固定在温暖的棕色墙壁(#7A5E42,在 剩余1天 和 零时 期间脉动深红色)中央顶部。
  • 10月的5×7网格,其中星期四的 23 用粗红色马克笔圈出(晚上9点)。
  • 在每个日期过渡时,卡通手用红色马克笔在已完成的日期(17 到 23)上画一个粗体红色 X,并在底部写下倒计时标题(剩余6天,剩余5天,……,零时)。
  • 从第4天开始,棕色的纸板(此面朝上 ↑)被用胶带贴在日历旁边的窗户上。

十月挂历倒计时与红色马克笔手

精确视频的参考帧(60.0秒)


D. 智能手机紧急警报与调查板

  • 紧急警报屏幕(draw_smartphone_alert):
    • 一个或多个卡通手中的倾斜深色智能手机边框,背景是脉动的深红色径向光晕。
    • 红色警报卡(#BF1515),带有黄色警告三角形,县级警报 · 现在,粗体大写标题(紧急警报),逐行文本显示,黄色荧光笔划过关键生存短语,以及页脚 发送方:阿什福德县 · 操作员:EW04。
  • 调查板(draw_ellen_ward_board):
    • 在深色背景上使用动画红色虚线曲线连接线索(署名“Ellen Ward”的名片 $ ightarrow$ 宝丽来照片 警报测试 / 操作员:EW04,标注为 同一个人,加上 区域1..4 象限图,其中 区域4 用红色圈出)。

周五凌晨3:12智能手机紧急警报屏幕

精确视频的参考帧(18.0秒)

Ellen Ward = EW04 和区域4调查板

精确视频的参考帧(222.0秒)


E. 技术性生存切入画面与图解(engine/diagrams.py)

每当叙述者解释物理机制或生存规则时,立即切入一个清晰、高对比度的图解:

  1. 卡路里试管计量表(draw_calorie_tube_overlay): 玻璃试管中填充从桌上罐子弧线飞出的花生酱,直到达到 2,500 卡路里并击裂玻璃!
  2. 建筑门横截面(draw_door_cross_section 和 draw_screw_stud_inset): 俯视示意图(你家的前门,从上方看),展示1英寸螺丝仅固定住薄 门框,而 3英寸黄铜螺丝 则深深咬入 墙柱。
  3. 120加仑水堆叠(draw_water_stack_120_diagram): 30个水罐 + 40个水箱 + 50个热水器 堆叠成单列 120加仑,配有红色花括号。
  4. 应急背包X光(draw_backpack_xray): 木地板上的背包内部俯视虚线X光视图(2加仑水,3天食物,大米,食物,收音机,急救包)。

花生酱倒入玻璃卡路里计量表

门横截面俯视图(“你家的前门,从上方看”)

30 + 40 + 50 = 120加仑堆叠水柱

应急背包内部X光俯视剖视图


F. 高度紧张的动作、猫眼恐怖与结局

  • 竖屏电话录像(draw_hospital_phone_video): 9:16 竖屏社交媒体视频帧,显示医院走廊僵尸袭击,随后是3×3缩略图网格逐一变为 视频不可用。
  • 圆形鱼眼猫眼序列(peephole_sequence): 黑暗圆形视口,带有玻璃边缘反射,显示邻居戴着草帽、手腕上血淋淋的咬痕特写、门缝下伸出的沾满泥土的黑指甲,以及他倾斜的灰绿色僵尸头扑向猫眼。
  • 走廊灭火器打斗与屋顶核爆结局: 喷出白色化学粉末,挥舞红色灭火器罐,楔住屋顶门把手,以及最终的广阔屋顶镜头,伴随着不断扩大的白蓝色冲击波穹顶和参天的核蘑菇云。

医院走廊僵尸袭击的抖动竖屏电话录像

黑暗走廊中邻居的圆形鱼眼猫眼视图

走廊中挥舞灭火器攻击僵尸邻居的打斗

屋顶核冲击波与蘑菇云结局


3. 未来视频的分步执行流程

使用此技能创建或重新创建视频时,请按顺序执行以下5个阶段:

  1. 阶段 1 — 取证探测与关键帧提取
    • 运行 ffprobe 记录精确的宽度、高度、FPS、帧数和音频编解码器。
    • 将60秒的视频片段(-vf scale=640:360)和1080p关键帧(frame_*.jpg)提取到临时目录,并使用 read_file 进行检查。
  2. 阶段 2 — 模块化矢量引擎设置(engine/)
    • engine/primitives.py:相机矩阵(apply_camera,带有爬行缩放 1.00 -> 1.14、平移和程序化创伤抖动)、缓存径向渐晕(draw_vignette)、脉动红色警报覆盖(draw_red_alarm_pulse)、手绘边框(draw_ink_box)、透明胶带、倾斜印章横幅、对话气泡、数字时钟、心电图波形、声波弧线和火焰。
    • engine/characters.py:绑定 draw_chad(绝不能是 Melvin)、draw_neighbor、draw_hand_with_pen、draw_water_jug 和 draw_fire_extinguisher_prop。
    • engine/overlays.py:draw_notebook_card、draw_sticky_note_pad、draw_taped_label、draw_october_calendar 和 draw_smartphone_alert。
    • engine/diagrams.py:所有技术性切入画面、收据、电子邮件(致: Chad,Chad H.)、调查板和X光视图。
    • engine/environments.py 和 engine/environments_part2.py:缓存的 _get_cached_bg(key, builder_fn) 1080p基础表面,使静态房间/外部几何体在每个工作进程中只渲染一次(>140-300 FPS)。
    • engine/timeline.py:主 SHOTS 表,映射整个时长内的 (t0, t1, zoom0, zoom1, pan_x, pan_y, shake, red_pulse, draw_fn)。
    • 字体字形规则: 避免在 Segoe Print 文本字符串中使用原始Unicode表情符号(💧,🔍,🔕)(这些会渲染为 [] 框);始终使用矢量迷你图标(draw_mini_icon)或干净的ASCII文本。
  3. 阶段 3 — 所有镜头的烟雾测试
    • 在启动完整视频编码之前,运行一个2秒的测试,渲染 SHOTS 中每个镜头的开始、中间和结束帧,以提前捕获任何语法或绘制错误。
  4. 阶段 4 — 多工作器并行NVENC渲染(recreate_video.py)
    • 将总帧数分配到6个并行的 ProcessPoolExecutor 工作器(前3个工作器使用 -c:v h264_nvenc -preset p4 -cq 20 -b:v 4500k,其余工作器使用 -c:v libx264 -preset veryfast -crf 20)。
    • 使用 ffmpeg -f concat 无损拼接片段,并合成立体声AAC音轨(-map 0:v:0 -map 1:a:0 -c:v copy -c:a aac -b:a 192k -shortest)。
  5. 阶段 5 — 交互式工作室(index.html)与验证
    • 构建 index.html,包含独立并排和同步并排对比播放器、逐帧步进(-1 / +1 帧)、章节快速跳转按钮以及可点击的逐镜头故事板检查器。
    • 使用 ffprobe 验证最终的MP4,并通过 read_file 检查提取的帧。

4. 捆绑的Python脚本与引擎模块(./scripts/)

所有可执行的Python脚本和程序化2D矢量引擎模块都直接包含在此技能的 scripts/ 文件夹中,供立即重用:

  • 取证参考视频分析器: analyze_reference_video.py
    • 探测视频元数据(ffprobe),提取60秒预览片段(clip_0_60.mp4,……),并转储1080p关键帧(frame_*.jpg)。
  • 并行多工作器NVENC视频渲染器: recreate_video.py
    • 使用6个并行的 ProcessPoolExecutor 工作器渲染所有17,726帧(1920x1080 ...

相关技能