Communitygithub.com

fable-video-workflow

Workflow vidéo éditorial IA de bout en bout prenant en charge les résumés courts avec présentateur Veo, les lancements produits vectoriels purs Playwright/Chrome et les vidéos explicatives longues à partir d'articles Markdown (chapitres illimités). Applique le design éditorial chaleureux Zero-Blue Anthropic, les cartes Double-Bezel, la physique à ressorts et la synchronisation automatique narration-image.

Qu'est-ce que fable-video-workflow ?

Ce workflow permet de créer des vidéos éditoriales de haute qualité avec trois moteurs de rendu distincts : un moteur de présentateur avec clips Veo et graphismes programmatiques (typographie cinétique, cartes Terracotta, séparation LAB verte sauge), un moteur vectoriel pur pour les lancements produits utilisant Playwright/Chrome headless, et un moteur d'explication longue de contenu (articles Markdown en vidéo avec chapitres illimités, synchronisation audio-narration via edge-tts ou macOS `say`). Il impose des règles strictes anti-AI-Slop comme l'interdiction du bleu froid, l'utilisation de ressorts amortis pour les transitions, et une vérification quantitative de la qualité (pourcentage de pixels bleus froids). Le workflow est conçu pour être utilisé sur macOS avec Python 3.10, ffmpeg et Chrome, et s'appuie sur le skill `ego-browser` pour l'automatisation de Google Flow. Il prend en charge plusieurs modes de saisie : un sujet en une phrase, un article Markdown complet, un script personnalisé ou une photo de l'utilisateur avec format flexible (16:9 ou 9:16).

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/sqoder/Arise-video-skill/tree/HEAD

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Workflow Éditorial de Studio Vidéo IA (Résumé Court + Lancement + Explication Longue-Format)

Aperçu

Ce workflow applique l'esthétique éditoriale chaleureuse Anthropic (Règle Zéro-Bleu) sur trois pistes de rendu :

  1. Moteur 1 — Présentateur + Compositing Éditorial (scripts/fable_studio.py) :
    • Clips Présentateur en Prise Réelle (Google Flow / Veo) : Générer 2..N clips réalistes de présentateur (lumière de studio tungstène chaleureuse — zéro néon bleu/violet — plus fond mural vert sauge solide #97A396) avec interdiction stricte de texte à l'écran et phonétique/descriptive chinoise parlée conforme aux politiques.
    • Graphismes Animés Programmatiques : Composer typographie cinétique, calques GrabCut derrière la tête, cartes flash Terracotta (#D97757), séparation LAB mate vert sauge, formes d'onde vocales RMS en direct, découpes autocollantes Parchment Chaud (#FAF9F5) + polaroïds inclinés, diaphragme en carbone chaud -> Timeline NLE Architecturale 3 Pistes + Vue Studio Double-Bezel, cartes de frappe Double-Bezel Carbone Chaud (#1C1B19), physique à ressort amorti (spring_ease), et mix audio sidechain-ducked à 118 BPM.
  2. Moteur 2 — Lancement Produit/Éditorial Vectoriel Pur (scripts/render_web_stage.py + scripts/stage_template.html, miroir dans web_stage/) :
    • Capture d'images déterministe Headless Chrome + Playwright rendant des cartes UI HTML5/CSS3/SVG (0.0% de bleu froid, conteneurs Double-Bezel, touches <kbd> natives, CSS letter-spacing, zooms auto-suivi fluides, ressorts amortis).
  3. Moteur 3 — Explication Longue d'Article (scripts/explainer_studio.py + scripts/explainer_stage.html) :
    • Vidéo explicative d'article Markdown à chapitres illimités (1–20+ min) avec verrouillage des images par chapitre piloté par l'audio (edge-tts voix chinoise neurale + repli macOS say hors ligne), forme d'onde RMS en direct synchronisée + sous-titres de clauses, et 6 mises en page éditoriales (title_hook, quote_highlight, architecture_flow, code_walkthrough, comparison_bento, summary_takeaway).

Quatre Règles Anti-AI-Slop (Appliquées par Défaut)

  1. Règle Zéro-Bleu : Les jetons de canevas et cartes par défaut sont Parchment Chaud (#FAF9F5 / #F3F1EA), Carbone Chaud (#141413 / #1C1B19), Terracotta (#D97757), Sauge Botanique (#788C5D), et règles 1px (#DFDCD2). L'éclairage de studio Google Flow utilise une clé tungstène chaude + lumière de contour ambre douce (zéro éclairage néon bleu ou violet).
  2. Montage B-Roll Timeline NLE Architecturale : Les transitions de battements utilisent une grille de dessin réglée #FAF9F5, un viewport en direct Double-Bezel, et une timeline 3 pistes (01 / VIDEO TRIM, 02 / ZOOM · Z courbe de Bézier, 03 / VOICE 48K), bannissant les faux horizons bleu foncé et les grilles néon.
  3. Double Moteur de Rendu : Utiliser fable_studio.py pour les histoires de présentateur Veo, ou adapter web_stage/render_web_stage.py + web_stage/stage_template.html lorsque des graphismes vectoriels purs UI/navigateur sont nécessaires.
  4. Physique à Ressort Amorti et Vérification Quantitative : Les transitions UI utilisent l'assouplissement harmonique spring_ease(t, stiffness, damping), et fable_studio.py verify rapporte ui_beat_cold_blue_pct sur les battements graphiques synthétiques (#3, #6, #7) ainsi que les flux ffprobe et verify_grid.jpg.

Espace de travail utilisateur autonome par défaut : /Users/wangxinglin/Downloads/AI视频工作流/.

Dépendances

  • Automatisation du navigateur : Se référer au skill ego-browser existant avant de contrôler Google Flow dans le navigateur. Ne jamais dupliquer la configuration d'automatisation du navigateur en dehors de ego-browser.
  • Runtime Python : /Library/Frameworks/Python.framework/Versions/3.10/bin/python3 (a playwright, cv2, numpy et PIL préinstallés ; /usr/bin/python3 ne les a pas).
  • Navigateur Web-Stage : /Applications/Google Chrome.app/Contents/MacOS/Google Chrome (utilisé headless par render_web_stage.py).
  • Binaires médias : /opt/homebrew/bin/ffmpeg, /opt/homebrew/bin/ffprobe.

Démarrage Rapide

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

# 1. Créer ou réinitialiser project.json (supporte --aspect 16:9|9:16 et --segments 3|4|5)
$PY "$STUDIO/fable_studio.py" init --output "$STUDIO/project.json" --aspect 16:9 --segments 3

# 2. Exporter les invites Google Flow sécurisées + instructions d'ancrage des ingrédients
$PY "$STUDIO/fable_studio.py" flow-plan --project "$STUDIO/project.json" --output "$STUDIO/output/flow_tasks.json"

# 3. Rendre la vidéo finale une fois les clips/seg_01.mp4..seg_0N.mp4 existants
$PY "$STUDIO/fable_studio.py" render --project "$STUDIO/project.json" --output "$STUDIO/output/《今日AI大事件》成片.mp4"

# 4. Vérifier les flux A/V et produire une planche contact 9 battements
$PY "$STUDIO/fable_studio.py" verify --video "$STUDIO/output/《今日AI大事件》成片.mp4" --output "$STUDIO/output/verify_grid.jpg"

Scripts Utilitaires

  • scripts/fable_studio.py (miroir dans /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, segments illimités)
    • flow-plan -p <project.json> [-o <flow_tasks.json>] : Applique safety.auto_derisk au dialogue parlé tout en préservant l'orthographe originale de la marque dans les champs de superposition.
    • render -p <project.json> [-o <output.mp4>] [--keep-temp] : Valide que tous les clips de segment existent, rend les battements Fable complets, nettoie automatiquement les fichiers temporaires intermédiaires.
    • verify -v <video.mp4> [-o <verify_grid.jpg>] : Exécute ffprobe, rapporte ui_beat_cold_blue_pct sur les battements graphiques (#3, #6, #7), et enregistre une planche contact 3x3 avec horodatage.
  • scripts/explainer_studio.py + scripts/explainer_stage.html (miroir dans /Users/wangxinglin/Downloads/AI视频工作流/explainer_studio.py & web_stage/explainer_stage.html) :

    • Mode explicatif long d'article piloté par l'audio supportant des chapitres illimités (1–15+ minutes).
    • init -o <explainer_project.json> : Crée un JSON de démarrage à 6 chapitres couvrant les 6 mises en page éditoriales Anthropic (title_hook, quote_highlight, architecture_flow, code_walkthrough, comparison_bento, summary_takeaway).
    • from-markdown -i <article.md> -o <explainer_project.json> : Convertit automatiquement tout article Markdown en JSON d'explication multi-chapitres.
    • render -p <explainer_project.json> -o <output.mp4> [--voice zh-CN-XiaoxiaoNeural] [--tts auto|edge|macos] : Synthétise la narration des chapitres via edge-tts (avec repli hors ligne macOS say -v Tingting), verrouille les nombres d'images exacts + forme d'onde RMS et sous-titres de clauses à la durée audio, rend via Headless Chrome Playwright, et mixe un groove ducké à 112 BPM.
    • verify -v <output.mp4> [-o <verify_explainer_grid.jpg>] : Exécute ffprobe, mesure cold_blue_pixel_pct sur les images échantillonnées, et construit une planche contact 3x3.

Modes de Saisie Supportés

  1. Sujet en Une Phrase ("一句话出片") :
    • Rechercher les actualités/événements factuels actuels via search_web lorsque l'utilisateur demande les nouvelles d'aujourd'hui/récentes.
    • Rédiger des scripts parlés concis d'environ 9s par segment, mapper la typographie réelle de la marque dans les champs de superposition visuelle, et remplir project.json.
    • Exécuter flow-plan, générer chaque segment dans Google Flow via ego-browser, télécharger les clips dans clips/seg_01.mp4 .., puis exécuter render et verify.
  2. Article Long / Explication Markdown ("讲解一篇文章 / 长视频模式") :
    • Accepter tout article collé, fichier Markdown ou sujet ; convertir/structurer en N chapitres logiques (explainer_studio.py from-markdown ou JSON personnalisé couvrant les 6 mises en page : title_hook, quote_highlight, architecture_flow, code_walkthrough, comparison_bento, summary_takeaway).
    • Exécuter explainer_studio.py render + verify (la durée audio détermine le nombre d'images vidéo avec zéro dérive A/V).
  3. Script Personnalisé / Storyboard ("自带口播/分镜") :
    • Préserver les lignes parlées exactes de l'utilisateur dans segments[*].spoken_text et extraire les appels visuels percutants dans les champs de superposition (behind_head_left/right, flash_card_title, behind_body_lines, cutout_title/cutout_serif_lines, broll_caption, user_prompt_text).
    • Exécuter flow-plan -> Google Flow -> render -> verify.
  4. Persona Personnalisé / Photo + Format Flexible ("自带照片 / 自定义形象 / 竖屏 9:16") :
    • Copier ou référencer l'image portrait de l'utilisateur dans persona.dark_anchor_path (et/ou green_anchor_path), définir persona.mode = "custom", ou définir format.aspect_ratio = "9:16" (1080x1920).
    • Personnaliser éventuellement brand.hud_prefix et brand.cta_text.

Guide du Navigateur Google Flow (via ego-browser)

  1. Vérification de l'Espace de Travail : Appeler listTaskSpaces() d'abord ; réutiliser l'espace de tâche "flow-google-duanju" sur Chrome "Profile 2" ([email protected]). Ne jamais laisser d'onglets en suspens ; terminer proprement via task.finish({ keep: [...] }) après que les téléchargements se soient stabilisés.
  2. Sélection du Modèle et du Ratio : Utiliser "Veo 3.1 - Lite" (par défaut) et le nombre de lots "x1" ; faire correspondre "16:9" ou "9:16" à project.json.
  3. Attachement des Ingrédients de Cohérence :
    • Télécharger ou sélectionner assets/default_dark_anchor.png / assets/default_green_anchor.png (ou la photo portrait de l'utilisateur).
    • Vérifier l'attachement du chip ingrédient : Confirmer que le bouton ingrédient (button "素材") se trouve strictement entre le dernier svg_root et le textfield "您希望创作什么?" dans le DOM/instantané avant de soumettre.
  4. Gestion des Obstacles Snackbar : Ignorer les snackbars "已将 X 项内容移至回收站" en cliquant sur text "关闭" avant de cliquer sur les cartes médias à proximité.
  5. Nouvelle Tentative Silencieuse de Sécurité : Toujours lire les invites depuis flow_tasks.json (flow_prompt, déjà dé-risqué). Si Google Flow rejette une invite pour des raisons politiques/de sécurité malgré auto_derisk, adoucir immédiatement les noms propres, mots financiers ou formulations géopolitiques restants dans spoken_text_safe et réessayer silencieusement sans s'arrêter pour déranger l'utilisateur.

Garde-fous de Composition et Typographie

  • Pas de Glyphes Tofu : Ne jamais utiliser d'émojis (🔥, 💳) ou de symboles non supportés (▸) dans les couches de texte Pillow ; s'en tenir aux caractères chinois/ASCII propres et ·, —, &, ●.
  • Contiguïté des Tableaux OpenCV : Lors de la conversion de tranches PIL RGBA/RGB en tableaux BGR pour les appels OpenCV (rectangle, warpAffine, GaussianBlur), toujours envelopper avec np.ascontiguousarray(...) et allouer des tampons flottants explicitement avec np.zeros((H, W, 3), dtype=...).
  • Nettoyage Propre : Les répertoires temporaires WAV/MP4 normalisés dans output/ doivent être nettoyés après la fin du rendu (--keep-temp uniquement lors du débogage).

Erreurs Courantes

  • Exécuter /usr/bin/python3 au lieu de Python 3.10 : Résulte en ModuleNotFoundError: No module named 'cv2'. Toujours exécuter avec /Library/Frameworks/Python.framework/Versions/3.10/bin/python3.
  • Passer "新闻记者" ou "OpenAI / IPO" non masqué dans le dialogue Flow : Déclenche des blocages de sécurité ou des clichés stériles de présentateur de journal. Garder le cadrage "视频创作者" et exécuter flow-plan d'abord.
  • Laisser Flow graver des sous-titres dans la vidéo brute : Ruine la typographie derrière la tête et l'esthétique des découpes vert sauge. Toujours garder STRICT NO ON-SCREEN TEXT dans les invites Flow.
  • Sauter verify / vérification visuelle : Toujours inspecter verify_grid.jpg via read_file après le rendu pour confirmer les marges de typographie, les bords mats, le placement des polaroïds et la durée audio.

Skills associés