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(...)。
- 電子郵件 / 信件 / 訊息: 例如


規則 #2:「精確影片」 法醫分析方法
- 丟入並檢查: 我提供一部參考影片(例如
Exact Video.mp4),並要求你仔細完整地閱讀與分析,然後從頭重建完全相同的視覺風格、高互動性吸引觀眾的動畫、動態疊加層與節奏。 - 絕不複製影片影格: 輸出 MP4 的每個影格都必須透過程序化 2D 向量程式碼(
PyCairo)100% 從頭渲染,然後與音軌混合。 - 完整時間線檢查(零猜測):
- 執行
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與場景回呼)。
- 執行
- 迭代自訂: 當我在首次渲染後要求更改角色名稱、道具調整或視覺調整時,請更新特定場景模組,透過
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。
- 表情:


B. 觸感螺旋筆記本與即時移動的筆手(draw_notebook_card)
- 紙張建構: 米色橫線紙(
#F5F0DC)、水平淺藍色格線、垂直紅色邊線、3 個打孔綁帶孔、左邊緣的銀色金屬螺旋環,以及右上角的半透明傾斜透明膠帶(draw_scotch_tape)。 - 即時寫字手(
draw_hand_with_pen): 一隻長袖深色手臂,帶有白色卡通手,握著藍色、黑色或紅色麥克筆,即時追蹤正在繪製的活躍角色或長條圖! - 列類型:
bar_row:迷你向量圖示(water、food、cash)+ 漸進式手寫標籤 + 充滿對角彩色剖面線的矩形計量器(#3B8EEA藍色、#E8922D橙色、#58B86C綠色)。支援紅色刪除線更新(2 gal -> 30 gal、3 -> 24 days、$40 -> $640)。tally:五筆畫計數組(藍色墨水||||+ 紅色墨水對角線第 5 筆/),帶有即時計數器(JUGS 3..28、TRIP 1..11/11)。pass_row:大型彩色離合字母(P-A-S-S代表HOW TO FIGHT A FIRE:Pull the pin、Aim at the BASE、Squeeze、Sweep side to side)。month_droplets:6×5 網格,共 30 個藍色水滴(30 GAL = 1 MONTH)。




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 ↑)。


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用紅筆圈出)。
- 在深色背景上使用動畫紅色虛線曲線連接線索(




E. 技術性求生插入畫面與圖表(engine/diagrams.py)
每當敘述者解釋物理機制或求生規則時,立即切換到乾淨、高對比度的圖表:
- 卡路里管計量器(
draw_calorie_tube_overlay): 玻璃試管,花生醬從桌上的罐子中呈弧形流出,直到達到2,500卡路里並使玻璃破裂! - 建築門橫截面(
draw_door_cross_section與draw_screw_stud_inset): 俯瞰圖(Your front door, from above),顯示 1 英吋螺絲只能固定薄薄的frame,而 3 英吋黃銅螺絲則能深入咬合wall stud。 - 120 加侖水堆疊(
draw_water_stack_120_diagram):30 jugs+40 tub+50 heater堆疊成一個120 gallons的柱子,帶有紅色花括號。 - 逃生背包 X 光圖(
draw_backpack_xray): 木地板上的俯瞰虛線 X 光背包內部(2 gal water、3 days、RICE、food、radio、first aid)。




F. 高緊張動作、窺視孔恐怖與結局
- 垂直手機影片(
draw_hospital_phone_video): 9:16 垂直社交影片影格,顯示醫院走廊殭屍攻擊,接著是 3×3 縮圖網格,一個接一個顯示Video unavailable。 - 圓形魚眼窺視孔序列(
peephole_sequence): 深色圓形視口,帶有玻璃邊緣反射,顯示戴著草帽的鄰居、他手腕上血淋淋的咬傷特寫、從門縫下伸入的沾滿泥土的黑指甲,以及他傾斜的灰綠色殭屍頭部撲向窺視孔。 - 走廊滅火器戰鬥與屋頂核彈結局: 噴出白色化學粉末、揮動紅色滅火器鋼瓶、楔住屋頂門把手,以及最終的寬闊屋頂鏡頭,伴隨著不斷擴大的白色藍色衝擊波穹頂與高聳的核蕈狀雲。




3. 未來影片的逐步執行管線
使用此技能創作或重建影片時,請依序執行以下 5 個階段:
- 第 1 階段 — 法醫探測與關鍵影格提取
- 執行
ffprobe以記錄確切寬度、高度、FPS、影格數與音訊編碼器。 - 將 60 秒影片片段(
-vf scale=640:360)與 1080p 關鍵影格(frame_*.jpg)提取到暫存目錄,並使用read_file檢查它們。
- 執行
- 第 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 階段 — 所有鏡頭的冒煙測試
- 在啟動完整影片編碼之前,對
SHOTS中每個鏡頭的開頭、中點與結尾執行 2 秒測試渲染,以事先捕捉任何語法或繪圖錯誤。
- 在啟動完整影片編碼之前,對
- 第 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)。
- 將總影格數分割到 6 個並行
- 第 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
- 透過 6 個並行工作者渲染所有 17,726 個影格(







