Communitygithub.com

fable-video-workflow

Veo 토크-헤드 요약, Playwright/Chrome 순수 벡터 제품 출시, 오디오 중심 장문 기사 설명 동영상('글을 동영상으로 만들기')을 지원하는 종합 AI 동영상 편집 워크플로우입니다. Zero-Blue Anthropic 웜 에디토리얼 디자인, 이중 베젤 카드, 스프링 물리, 자동 내레이션-프레임 동기화를 적용합니다. 사용자가 'AI大事件', '今日AI', '讲解视频', '把文章做成视频', 장문 설명 동영상, 또는 `fable-video-workflow`/`AI视频工作流`를 언급할 때 사용하세요.

fable-video-workflow란 무엇인가요?

이 스킬은 세 가지 개별 엔진을 통해 완전한 AI 동영상 편집 파이프라인을 제공합니다. 첫 번째 엔진(`fable_studio.py`)은 Veo로 생성된 토크-헤드 클립과 프로그래매틱 모션 그래픽(예: 테라코타 카드, 더블 베젤 뷰포트, 스프링 애니메이션)을 결합하여 짧은 뉴스 다이제스트(

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/sqoder/Arise-video-skill/tree/HEAD

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

에디토리얼 AI 동영상 스튜디오 워크플로우 (짧은 요약 + 런칭 + 장문 설명 동영상)

개요

이 워크플로우는 세 가지 렌더링 트랙에 걸쳐 Anthropic 웜 에디토리얼 미학(Zero-Blue 룰)을 적용합니다:

  1. 엔진 1 — 토크-헤드 + 에디토리얼 컴포지팅 (scripts/fable_studio.py) :
    • 실사 프레젠터 클립 (Google Flow / Veo) : 웜 텅스텐 스튜디오 조명(네온 블루/퍼플 제로)과 솔리드 #97A396 세이지 그린 스튜디오 벽을 사용하여 2..N개의 사실적인 토크-헤드 클립을 생성하며, 엄격한 화면 내 텍스트 없음 및 정책 안전한 음성/설명 중국어를 적용합니다.
    • 프로그래매틱 모션 그래픽 : 키네틱 타이포그래피, 머리 뒤 GrabCut 레이어링, 테라코타(#D97757) 플래시 카드, 세이지 그린 LAB 매트 분리, 실시간 RMS 음성 파형, 웜 파치먼트(#FAF9F5) 스티커 컷아웃 + 기울어진 폴라로이드, 웜 카본 아이리스 -> 아키텍처 3-트랙 NLE 타임라인 + 더블 베젤 스튜디오 뷰포트, 웜 카본(#1C1B19) 더블 베젤 타이핑 카드, 댐핑 스프링 물리(spring_ease), 118 BPM 사이드체인 덕킹 오디오 믹스를 합성합니다.
  2. 엔진 2 — 순수 벡터 제품/에디토리얼 런칭 (scripts/render_web_stage.py + scripts/stage_template.html, web_stage/에 미러링됨) :
    • 결정론적 Headless Chrome + Playwright 프레임 캡처로 HTML5/CSS3/SVG UI 카드 렌더링 (0.0% 콜드 블루, 더블 베젤 컨테이너, 네이티브 <kbd> 키캡, CSS letter-spacing, 부드러운 자동 팔로우 줌, 댐핑 스프링).
  3. 엔진 3 — 장문 기사 설명 동영상 (scripts/explainer_studio.py + scripts/explainer_stage.html) :
    • 무제한 챕터(1~20+분) Markdown/기사 설명 동영상으로, 오디오 구동 챕터 프레임 잠금(edge-tts 신경망 중국어 음성 + 오프라인 macOS say 폴백), 동기화된 실시간 RMS 파형 + 절 자막, 6가지 에디토리얼 레이아웃(title_hook, quote_highlight, architecture_flow, code_walkthrough, comparison_bento, summary_takeaway)을 지원합니다.

네 가지 안티-AI-슬롭 규칙 (기본 적용)

  1. Zero-Blue 규칙 : 기본 캔버스 및 카드 토큰은 웜 파치먼트(#FAF9F5 / #F3F1EA), 웜 카본(#141413 / #1C1B19), 테라코타(#D97757), 보태니컬 세이지(#788C5D), 1px 규칙(#DFDCD2)입니다. Google Flow 스튜디오 조명은 웜 텅스텐 키 + 소프트 앰버 림 라이트(네온 블루 또는 퍼플 조명 제로)를 사용합니다.
  2. 아키텍처 NLE 타임라인 B-롤 : 비트 전환은 #FAF9F5 제도 그리드, 더블 베젤 라이브 뷰포트, 3-트랙 타임라인(01 / VIDEO TRIM, 02 / ZOOM · Z 베지어 곡선, 03 / VOICE 48K)을 사용하며, 다크 블루 가짜 스카이라인과 네온 그리드를 금지합니다.
  3. 이중 렌더링 엔진 : Veo 프레젠터 스토리에는 fable_studio.py를 사용하거나, 순수 UI/브라우저 등급 벡터 모션 그래픽이 필요할 때는 web_stage/render_web_stage.py + web_stage/stage_template.html을 사용합니다.
  4. 댐핑 스프링 물리 및 정량적 검증 : UI 전환은 조화 spring_ease(t, stiffness, damping) 이징을 사용하며, fable_studio.py verify는 합성 그래픽 비트(#3, #6, #7)에 걸쳐 ui_beat_cold_blue_pct를 ffprobe 스트림 및 verify_grid.jpg와 함께 보고합니다.

기본 독립 실행형 사용자 작업 공간: /Users/wangxinglin/Downloads/AI视频工作流/.

종속성

  • 브라우저 자동화 : Google Flow를 브라우저에서 제어하기 전에 기존 ego-browser 스킬을 참조하세요. ego-browser 외부에서 브라우저 자동화 설정을 중복하지 마십시오.
  • Python 런타임 : /Library/Frameworks/Python.framework/Versions/3.10/bin/python3 (playwright, cv2, numpy, PIL이 사전 설치됨; /usr/bin/python3에는 없음).
  • 웹 스테이지 브라우저 : /Applications/Google Chrome.app/Contents/MacOS/Google Chrome (render_web_stage.py가 헤드리스로 사용).
  • 미디어 바이너리 : /opt/homebrew/bin/ffmpeg, /opt/homebrew/bin/ffprobe.

빠른 시작

PY=/Library/Frameworks/Python.framework/Versions/3.10/bin/python3
STUDIO="/Users/wangxinglin/Downloads/AI视频工作流"

# 1. project.json 생성 또는 초기화 (--aspect 16:9|9:16 및 --segments 3|4|5 지원)
$PY "$STUDIO/fable_studio.py" init --output "$STUDIO/project.json" --aspect 16:9 --segments 3

# 2. 안전성 완화된 Google Flow 프롬프트 + 재료 앵커 지침 내보내기
$PY "$STUDIO/fable_studio.py" flow-plan --project "$STUDIO/project.json" --output "$STUDIO/output/flow_tasks.json"

# 3. clips/seg_01.mp4..seg_0N.mp4 파일이 존재하면 최종 동영상 렌더링
$PY "$STUDIO/fable_studio.py" render --project "$STUDIO/project.json" --output "$STUDIO/output/《今日AI大事件》成片.mp4"

# 4. A/V 스트림 확인 및 9비트 콘택트 시트 생성
$PY "$STUDIO/fable_studio.py" verify --video "$STUDIO/output/《今日AI大事件》成片.mp4" --output "$STUDIO/output/verify_grid.jpg"

유틸리티 스크립트

  • scripts/fable_studio.py ( /Users/wangxinglin/Downloads/AI视频工作流/fable_studio.py에 미러링됨):

    • init -o <project.json> [--aspect 16:9|9:16] [--segments N] [--hud-prefix "AI DAILY"] [--cta "每天一分钟 · 点个关注"] (N >= 2, 무제한 세그먼트)
    • flow-plan -p <project.json> [-o <flow_tasks.json>] : safety.auto_derisk를 음성 대사에 적용하고 오버레이 필드의 원래 브랜드 철자는 유지합니다.
    • render -p <project.json> [-o <output.mp4>] [--keep-temp] : 모든 세그먼트 클립이 존재하는지 확인하고, 전체 Fable 비트를 렌더링하며, 임시 중간 파일을 자동으로 정리합니다.
    • verify -v <video.mp4> [-o <verify_grid.jpg>] : ffprobe를 실행하고, 그래픽 비트(#3, #6, #7)에 걸쳐 ui_beat_cold_blue_pct를 보고하며, 3x3 타임스탬프 콘택트 시트를 저장합니다.
  • scripts/explainer_studio.py + scripts/explainer_stage.html ( /Users/wangxinglin/Downloads/AI视频工作流/explainer_studio.py & web_stage/explainer_stage.html에 미러링됨):

    • 무제한 챕터(1~15+분)의 장문 오디오 구동 기사 설명 동영상 모드입니다.
    • init -o <explainer_project.json> : 6개의 Anthropic 에디토리얼 레이아웃(title_hook, quote_highlight, architecture_flow, code_walkthrough, comparison_bento, summary_takeaway)을 모두 포함하는 6챕터 스타터 JSON을 생성합니다.
    • from-markdown -i <article.md> -o <explainer_project.json> : 모든 Markdown 기사를 다중 챕터 설명 동영상 JSON으로 자동 변환합니다.
    • render -p <explainer_project.json> -o <output.mp4> [--voice zh-CN-XiaoxiaoNeural] [--tts auto|edge|macos] : edge-tts(오프라인 macOS say -v Tingting 폴백 포함)를 통해 챕터 내레이션을 합성하고, 정확한 프레임 수와 RMS 파형 및 절 자막을 오디오 지속 시간에 잠그고, Headless Chrome Playwright를 통해 렌더링하며, 112 BPM 덕킹 그루브를 믹싱합니다.
    • verify -v <output.mp4> [-o <verify_explainer_grid.jpg>] : ffprobe를 실행하고, 샘플링된 프레임 전체에서 cold_blue_pixel_pct를 측정하며, 3x3 콘택트 시트를 생성합니다.

지원되는 입력 모드

  1. 한 문장 주제 ("一句话出片") :
    • 사용자가 오늘/최근 뉴스를 물을 때 search_web을 통해 현재 사실적 뉴스/이벤트를 조사합니다.
    • 세그먼트당 간결한 ~9초 음성 스크립트를 작성하고, 실제 브랜드 타이포그래피를 시각적 오버레이 필드에 매핑하고, project.json을 채웁니다.
    • flow-plan을 실행하고, ego-browser를 통해 Google Flow에서 각 세그먼트를 생성하고, 클립을 clips/seg_01.mp4 ..에 다운로드한 후 render 및 verify를 실행합니다.
  2. 장문 기사 / Markdown 설명 동영상 ("讲解一篇文章 / 长视频模式") :
    • 붙여넣은 기사, Markdown 파일 또는 주제를 수락하고, N개의 논리적 챕터로 변환/구조화합니다(explainer_studio.py from-markdown 또는 title_hook, quote_highlight, architecture_flow, code_walkthrough, comparison_bento, summary_takeaway의 6개 레이아웃 전체에 걸친 사용자 정의 JSON).
    • explainer_studio.py render + verify를 실행합니다(오디오 지속 시간이 비디오 프레임 수를 결정하며 A/V 드리프트가 없음).
  3. 사용자 정의 스크립트 / 스토리보드 ("自带口播/分镜") :
    • 사용자의 정확한 음성 대사를 segments[*].spoken_text에 보존하고, 눈에 띄는 시각적 콜아웃을 오버레이 필드(behind_head_left/right, flash_card_title, behind_body_lines, cutout_title/cutout_serif_lines, broll_caption, user_prompt_text)로 추출합니다.
    • flow-plan -> Google Flow -> render -> verify를 실행합니다.
  4. 사용자 정의 페르소나 / 사진 + 유연한 형식 ("自带照片 / 自定义形象 / 竖屏 9:16") :
    • 사용자의 초상화 이미지를 persona.dark_anchor_path(및/또는 green_anchor_path)에 복사하거나 참조하고, persona.mode = "custom"으로 설정하거나, format.aspect_ratio = "9:16"(1080x1920)을 설정합니다.
    • 선택적으로 brand.hud_prefix 및 brand.cta_text를 사용자 정의합니다.

Google Flow 브라우저 플레이북 (ego-browser를 통해)

  1. 작업 공간 확인 : 먼저 listTaskSpaces()를 호출하고, Chrome "Profile 2" ([email protected])의 작업 공간 "flow-google-duanju"를 재사용합니다. 중단된 탭을 남기지 말고, 다운로드가 완료된 후 task.finish({ keep: [...] })를 통해 깨끗이 마무리하십시오.
  2. 모델 및 비율 선택 : "Veo 3.1 - Lite" (기본값) 및 "x1" 배치 수를 사용하고, "16:9" 또는 "9:16"을 project.json과 일치시킵니다.
  3. 일관성 재료 첨부 :
    • assets/default_dark_anchor.png / assets/default_green_anchor.png (또는 사용자의 초상화 사진)를 업로드하거나 선택합니다.
    • 재료 칩 첨부 확인 : 제출하기 전에 재료 버튼(button "素材")이 DOM/스냅샷에서 마지막 svg_root와 textfield "您希望创作什么?" 사이에 엄격히 위치하는지 확인합니다.
  4. 스낵바 장애 처리 : 가까운 미디어 카드를 클릭하기 전에 text "关闭"를 클릭하여 "已将 X 项内容移至回收站" 스낵바를 닫습니다.
  5. 무음 안전 재시도 : 항상 flow_tasks.json (flow_prompt, 이미 완화됨)에서 프롬프트를 읽습니다. Google Flow가 auto_derisk에도 불구하고 정책/안전 문제로 프롬프트를 거부하는 경우, 즉시 spoken_text_safe에서 나머지 고유 명사, 금융 단어 또는 지정학적 표현을 부드럽게 하고, 사용자에게 알리지 않고 자동으로 재시도합니다.

컴포지팅 및 타이포그래피 가드레일

  • 두부 글리프 없음 : Pillow 텍스트 레이어에 이모지(🔥, 💳) 또는 지원되지 않는 기호(▸)를 사용하지 말고, 깨끗한 중국어/ASCII 문자 및 ·, —, &, ●를 사용하십시오.
  • OpenCV 배열 연속성 : PIL RGBA/RGB 슬라이스를 OpenCV 호출(rectangle, warpAffine, GaussianBlur)을 위한 BGR 배열로 변환할 때 항상 np.ascontiguousarray(...)로 래핑하고 np.zeros((H, W, 3), dtype=...)로 명시적으로 float 버퍼를 할당하십시오.
  • 깔끔한 정리 : render 완료 후 output/ 내의 임시 정규화 WAV/MP4 디렉토리를 정리해야 합니다(--keep-temp는 디버깅 시에만 사용).

일반적인 실수

  • Python 3.10 대신 /usr/bin/python3 실행 : ModuleNotFoundError: No module named 'cv2' 오류가 발생합니다. 항상 /Library/Frameworks/Python.framework/Versions/3.10/bin/python3로 실행하십시오.
  • "新闻记者" 또는 마스킹되지 않은 "OpenAI / IPO"를 Flow 대화에 전달 : 안전 차단 또는 무미건조한 뉴스 앵커 클리셰를 유발합니다. "视频创作者" 구도를 유지하고 먼저 flow-plan을 실행하십시오.
  • Flow가 원시 동영상에 자막을 굽도록 허용 : 머리 뒤 타이포그래피와 세이지 그린 컷아웃 미학을 망칩니다. 항상 Flow 프롬프트에서 STRICT NO ON-SCREEN TEXT를 유지하십시오.
  • verify / 시각적 확인 건너뛰기 : 렌더링 후 항상 read_file을 통해 verify_grid.jpg를 검사하여 타이포그래피 여백, 매트 가장자리, 폴라로이드 배치 및 오디오 지속 시간을 확인하십시오.

관련 스킬