Communitygithub.com

2D 解說長影片

端到端工作流程與程序化 2D 向量動畫系統,用於分析參考影片(『精確影片』)並從頭創作高互動性、吸引觀眾的長篇 2D 解說與生存故事影片(1920x1080 @ 30fps),主角為使用者指定的標誌性角色「Chad」。

2D 解說長影片 是什麼?

此技能定義了一套完整的程序化 2D 向量動畫管線,用於從頭重建長篇解說與生存故事影片(8–15 分鐘以上,1920x1080 @ 30fps)。核心工作流程採用「精確影片」法醫分析方法:首先使用 ffprobe 對參考影片進行元數據探測,提取 60 秒片段與關鍵影格,以建立包含 100 個以上鏡頭的完整時間線。隨後,透過純 Python 程式碼(PyCairo)程序化渲染每個影格,確保輸出為 100% 原創向量圖形,而非複製參考影格。此技能強制執行嚴格的視覺聖經,包括主角「Chad」(永遠不能是 Melvin)、觸感螺旋筆記本與動態手寫筆、十月月曆倒數、智慧型手機緊急警報、調查板,以及技術性求生示意圖。支援平台包括 Claude Code、Cursor、Codex 與其他 AI 編碼代理。渲染架構使用多工作業平行 NVENC 編碼(6 個工作者)與無損串接,接著建立互動式 HTML 驗證播放器,以進行並排比較與鏡頭偵錯。

相容平台~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

主角名稱規則:電子郵件「To: 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」:
    • 電子郵件 / 信件 / 訊息: 例如 To: Chad
    • 報名表 / 志工卡 / 證件: 例如 Chad H.
    • 信用卡 / 簽帳金融卡 / 銀行畫面: 例如 CHAD(•••• 2930)
    • 電話 / 對話泡泡 / 字幕: 任何呼叫或稱呼主角的人使用 「Chad」。
    • 程式碼庫與骨架: 在所有引擎模組與分鏡 UI 中,將角色骨架函數命名為 draw_chad(...)。

主角名稱規則:電子郵件「To: 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 gal -> 30 gal、3 -> 24 days、$40 -> $640)。
    2. tally:五筆畫計數組(藍色墨水 |||| + 紅色墨水對角線第 5 筆 /),帶有即時計數器(JUGS 3..28、TRIP 1..11/11)。
    3. pass_row:大型彩色離合字母(P-A-S-S 代表 HOW TO FIGHT A FIRE:Pull the pin、Aim at the BASE、Squeeze、Sweep side to side)。
    4. month_droplets:6×5 網格,共 30 個藍色水滴(30 GAL = 1 MONTH)。

第 1 天螺旋筆記本庫存,帶有剖面線長條圖與移動筆手

精確影片參考影格(54.0 秒)

火災逃生期間的「如何滅火(P-A-S-S)」筆記本疊加層

精確影片參考影格(503.0 秒)


C. 十月月曆倒數(draw_october_calendar)

  • 固定在溫暖的棕色牆壁(#7A5E42,在 1 DAY LEFT 與 HOUR ZERO 期間脈動為深紅色)上,頂部中心有一個紅色圖釘。
  • OCTOBER 的 5×7 網格,星期四 23 用粗紅筆圈出(9 PM)。
  • 在每一天過渡時,卡通手用紅筆在已完成的日期(17 到 23)上畫一個粗體紅色 X,並在底部寫下倒數標題(6 DAYS LEFT、5 DAYS LEFT、…、HOUR ZERO)。
  • 從第 4 天開始,月曆旁的窗戶上貼有棕色紙板(THIS SIDE UP ↑)。

帶有紅筆手的十月月曆倒數

精確影片參考影格(60.0 秒)


D. 智慧型手機緊急警報與調查板

  • 緊急警報畫面(draw_smartphone_alert):
    • 傾斜的深色智慧型手機邊框,由一隻或兩隻卡通手握住,背景是脈動的深紅色徑向背光。
    • 紅色警報卡(#BF1515),帶有黃色警告三角形、COUNTY ALERT · now、粗體大寫標題(EMERGENCY ALERT)、逐行文字揭示、黃色螢光筆掃過關鍵生存短語,以及 Sender: Ashford County · Operator: EW04 頁腳。
  • 調查板(draw_ellen_ward_board):
    • 在深色背景上使用動畫紅色虛線曲線連接線索(Signed, Ellen Ward 名片 $\rightarrow$ 拍立得 ALERT TEST / Operator: EW04 標記為 same person,加上 Zone 1..4 象限地圖,Zone 4 用紅筆圈出)。

星期五凌晨 3:12 智慧型手機緊急警報畫面

精確影片參考影格(18.0 秒)

Ellen Ward = EW04 與 Zone 4 調查板

精確影片參考影格(222.0 秒)


E. 技術性求生插入畫面與圖表(engine/diagrams.py)

每當敘述者解釋物理機制或求生規則時,立即切換到乾淨、高對比度的圖表:

  1. 卡路里管計量器(draw_calorie_tube_overlay): 玻璃試管,花生醬從桌上的罐子中呈弧形流出,直到達到 2,500 卡路里並使玻璃破裂!
  2. 建築門橫截面(draw_door_cross_section 與 draw_screw_stud_inset): 俯瞰圖(Your front door, from above),顯示 1 英吋螺絲只能固定薄薄的 frame,而 3 英吋黃銅螺絲則能深入咬合 wall stud。
  3. 120 加侖水堆疊(draw_water_stack_120_diagram): 30 jugs + 40 tub + 50 heater 堆疊成一個 120 gallons 的柱子,帶有紅色花括號。
  4. 逃生背包 X 光圖(draw_backpack_xray): 木地板上的俯瞰虛線 X 光背包內部(2 gal water、3 days、RICE、food、radio、first aid)。

花生醬倒入玻璃卡路里計量器

俯瞰門橫截面圖(「Your front door, from above」)

30 + 40 + 50 = 120 加侖堆疊水柱

逃生背包內部俯瞰 X 光剖面圖


F. 高緊張動作、窺視孔恐怖與結局

  • 垂直手機影片(draw_hospital_phone_video): 9:16 垂直社交影片影格,顯示醫院走廊殭屍攻擊,接著是 3×3 縮圖網格,一個接一個顯示 Video unavailable。
  • 圓形魚眼窺視孔序列(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)、透明膠帶、斜蓋郵戳橫幅、對話泡泡、數位時鐘、ECG 波形、聲波弧線與火焰羽流。
    • 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:所有技術性剖面圖、收據、電子郵件(To: 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 階段 — 所有鏡頭的冒煙測試
    • 在啟動完整影片編碼之前,對 SHOTS 中每個鏡頭的開頭、中點與結尾執行 2 秒測試渲染,以事先捕捉任何語法或繪圖錯誤。
  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 Frame)、章節快速跳轉按鈕,以及可點選的逐鏡頭分鏡檢查器。
    • 使用 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 個並行工作者渲染所有 17,726 個影格(1920x1080

相關技能