Légendes intégrées
Un catalogue, choisi en amont (CATALOG.md — 17 identités ; les trois moteurs derrière sont des détails d'implémentation). Standard (par défaut) construit une barre textuelle propre (sous-titre en tiers inférieur portant la majeure partie du texte) + un climax embed composité dans la scène derrière le sujet au moment fort. Cinématique est un embed pur — pas de barre, chaque légende compositée derrière le sujet (typographie héroïque, accumulation, occlusion comme effet). Thème est une constitution thématique complète — paradigme du corps × scène héroïque × fx avant × réaction de la plaque, composée à partir de registres (themes/README.md) : ordnance terminal neonsign stardust stomp. La plupart des vidéos explicatives / voice-over sont en Standard ; l'embed est le pic rare et mérité — incorporer chaque mot est l'erreur courante ; le Thème est réservé aux demandes de niveau VFX ("炸", "特效", "像 AE 做的").
Flux opérationnel (TL;DR)
Le texte d'artisanat ci-dessous est long ; le pipeline lui-même est court — et tout ce qui est déterministe est calculé ou compilé, jamais écrit à la main :
- Porte de décision (refuser les mauvais clips) → choisir UNE identité dans CATALOG.md (17 identités ; le moteur/compilateur est dérivé par recherche — ne jamais poser de question de mode/catégorie)
hyperframes init(ignorer si le répertoire du projet existe déjà avec la vidéo à l'intérieur —matte.cjs/transcribe.cjsadoptent n'importe quelle vidéo dans le répertoire comme source.mp4) →bash scripts/prepare.sh <projet>(matte ∥ transcrire ∥ enveloppe audio en parallèle, puis zones de sécurité v2 avec palette de scène/optique/éclairage — une commande, rien oublié)- écrire un petit JSON de choix créatifs (lire
safe-zones.jsond'abord) : Cinématique →plan.json→fill-timings.cjs→fit-fonts.cjs→make-composition.cjs; Thème →theme.json→make-theme.cjs(paradigmes rail/panneau/poème/takeover ;anchorest le rail silencieux par défaut) - QA visuel :
node scripts/preview-frames.cjs <projet>→ aperçus composites fidèles en ~2s/image (pas de rendu). Vérifier § QA visuel avant de payer un rendu. render-and-composite.sh→ portes (timing / occlusion+héros / débordement / transfert) →final.mp4
Règles porteuses que les gens oublient :
- rail (par défaut) + embed (promotion).
drop(remplissage, non affiché) /rail(sous-titre textuel en tiers inférieur, au premier plan, porte la plupart du texte) /embed(un mot fort composité derrière le sujet). Le mode Standard fait les deux, n'encastrant que le(s) pic(s). Voir § Modèle de légende. - La vidéo est livrée INTACTE (Standard/Cinématique ; le budget PLATEAU du mode Thème est la seule exception sanctionnée — réactions de battement enregistrées (charge-dim, coup de poing, secousse, grain) définies par l'ADN du thème et appliquées APRÈS la composition matte pour que le sujet+texte+plateau bougent comme un seul cadre) — seules les légendes sont ajoutées ; le matte permet juste au sujet d'occlure la piste embed. Ne jamais étalonner/recolorer/scanliner les images.
- Deux livres de règles : rail → references/rail.md (mince), artisanat embed → references/composition-craft.md (riche, embed uniquement). Parcourir selon les besoins.
Modèle de légende — rail + embed
Chaque phrase parlée est l'une des trois choses suivantes :
| Quoi | Comment c'est affiché | |
|---|---|---|
| drop | remplissage — euh/uh, bégaiements, autocorrections | non affiché |
| rail | la valeur par défaut — contenu parlé ordinaire (textuel) | sous-titre propre en tiers inférieur, au premier plan, lisible. Un mot fort peut recevoir un surlignage emphasis en ligne (couleur d'accent / pop de mot actif) — il reste sur le rail. |
| embed | un pic promu — le battement principal | un grand mot composité derrière le sujet (occlusion matte), entrée + sortie conçues |
Le rail porte la plupart du texte ; l'embed est le pic rare et mérité. La rareté est par battement/bloc, pas par clip : ≤1 héros par bloc (pensée), jamais deux co-visibles, ≥ un battement d'air entre les fenêtres héros (le compilateur avertit en dessous de 0,6s). Un clip court → généralement 1–2 ; une longue explication → ~un par section. Parmi plusieurs héros, le plus grand conçu est l'APEX (lui seul obtient le lockup embed complet + augmentation de largeur) ; les plus petits sont des pics MINEURS qui chevauchent leur colonne comme des lignes d'emphase surdimensionnées (fg, mouvement amorti) — tous les battements n'ont pas besoin de la vitrine matte, ce qui maintient précisément l'apex comme un événement. Incorporer chaque mot reste l'erreur courante.
Les identités de surface de rail construisent exactement cela (rail = rail.html, embed = le climax dans index.html). Les identités à flux de colonnes abandonnent le rail et transforment tout en style embed — les recommander uniquement pour des demandes d'ambiance plutôt que textuelles, jamais pour des explications / voice-over où les mots doivent être lus (CATALOG.md encode cela par identité).
Étape 0 — choisir UNE identité dans le CATALOG
Un frontal, trois moteurs derrière. L'utilisateur choisit une IDENTITÉ dans CATALOG.md (17 entrées : 12 classiques + 5 thématiques) ; le moteur, le compilateur et le fichier de conception sont dérivés par recherche dans la ligne du catalogue. Ne jamais poser la question "Standard vs Cinématique vs Thème" — ce sont des noms back-end (un produit a une seule UX même avec plusieurs moteurs). Le catalogue encode tout ce dont le routage a besoin : surface de lecture, voix, recommandation pour, besoins de scène, notes d'adjacence pour les paires vraiment proches (loud↔ordnance, neon↔neonsign, cream↔stardust).
Procédure : sonder le clip → présélectionner 2–3 identités du catalogue → recommander UNE avec une raison d'une ligne → l'utilisateur choisit → concevoir le fichier de cette identité. Les identités sont verrouillées par moteur (pas de combinaisons croisées ; en ouvrir une est un événement de validation — voir dna/README.md).
Toujours présenter votre recommandation et laisser l'utilisateur choisir avant de concevoir. Ne pas choisir silencieusement par défaut.
(Le tableau complet des identités se trouve dans CATALOG.md — source unique de vérité pour le routage. Les docs moteur ci-dessous décrivent le contrat de conception de chaque backend.)
Heuristique de recommandation : utiliser les "Heuristiques de présélection" dans CATALOG.md — elles sont au niveau de l'identité (par exemple "炸" présélectionne ordnance/stomp/terminal/loud et choisit PAR CE QUI doit exploser), jamais au niveau de la catégorie. En cas de doute → anchor.
- Cinématique → écrire
plan.jsonpour un modèle verrouillé, compilé parmake-composition.cjs. - Thème → lire themes/README.md, concevoir
theme.json, exécuterscripts/render-theme.sh(compile + rend + réaction de plateau → final_fx.mp4).
Porte de décision — EXÉCUTER EN PREMIER
Sonder la vidéo et classer la scène avant l'un ou l'autre mode.
ffprobe <video.mp4> # specs
ffmpeg -ss <t> -i <video.mp4> -vframes 1 sample.png # à 20/50/80%
Lire les échantillons. Refuser si :
- Plusieurs locuteurs / coupures franches (scinder et rendre chaque plan, ou refuser)
- Pas de sujet humain (cette compétence est pour les têtes parlantes)
- Moins de 3 secondes, aucune parole, ou visage jamais clairement visible —
transcribe.cjsavertit quand l'audio est quasi silencieux (Whisper hallucine des mots comme "Thank you." sur le silence) ; l'écouter et refuser plutôt que de sous-titrer des mots fabriqués - La source a déjà des légendes / sous-titres incrustés / graphiques de texte lourds — l'ajout d'un second système de légendes entre en conflit et les images sont livrées intactes (pas de recouvrement/inpainting). Le texte incrusté apparaît souvent seulement au milieu du clip : échantillonner une planche contact à 1 ips (
ffmpeg -i in.mp4 -vf "fps=1,scale=160:-1,tile=10x5" sheet.png), ne pas se fier à 3 trames ponctuelles. - La transcription est de mauvaise qualité — un discours non natif / avec un fort accent peut être transcrit en charabia assuré. Lire
transcript.jsonpour vérifier avant de concevoir ; si cela ne ressemble pas à une langue, essayerWHISPER_MODEL=mediumune fois, sinon refuser (un rail textuel de mots fabriqués est pire que pas de légendes). - Caméra à l'épaule avec mouvement rapide (le matte scintille)
Sondages pré-vol (ne coûtent rien, évitent les pires échecs)
- Sondage de coupure. Échantillonner des images à 20%, 50%, 80%. Si un sujet/scène différent apparaît, rognir le clip avant la coupure.
- Sondage de letterbox / pillarbox. Barres noires sur la première image ? Calculer le rectangle de contenu sûr et contraindre le placement des légendes à l'intérieur.
- Sondage de luminance. Échantillonner la luminance moyenne de la région des légendes —
sous 60→ le texte clair se lit tel quel,60-180→ ajouter le cache du glyphe,180+→ texte opaque + cache (jamais de texte clair nu). Les modèles cinématiques sont cream+screenet VERROUILLÉS — utiliser ce sondage pour choisir une identité appropriée (scènes lumineuses →ink, ou le thèmeanchorà rail opaque), jamais pour en recolorer une. - Recommandation d'identité par ton (vous recommandez ; l'utilisateur choisit — voir Étape 0 + CATALOG.md). explication / interview / mots à lire absolument → identités de surface rail/panneau ; poétique / social / "cinématique" → identités à flux de colonnes par registre ; "炸 / 特效 / VFX" / mondes nommés → identités thématiques. En cas de doute →
anchor(les mots se lisent, la scène est sûre) — mais présenter une présélection et laisser l'utilisateur choisir.
Pipeline — 5 étapes
1. hyperframes init <projet> --non-interactive --video <video.mp4>
2. bash scripts/prepare.sh <projet> # matte ∥ transcription (parallèle) → zones de sécurité. Une commande.
# → frames_fg/ transcript.json safe-zones.json
3. [ÉTAPE AGENT — la seule étape créative] concevoir un petit JSON ; voir ci-dessous par mode
Cinématique : concevoir plan.json → node scripts/fill-timings.cjs → fit-fonts.cjs → make-composition.cjs
Thème : concevoir theme.json → bash scripts/render-theme.sh <projet> (compile + rend + fx plateau)
4. node scripts/preview-frames.cjs <projet> # ~2s/image aperçus composites → § QA visuel (AVANT le rendu)
5. bash scripts/render-and-composite.sh <projet> # portes → final.mp4 + snapshot historique/
(Mode Thème : IGNORER les étapes 3b/5 — render-theme.sh exécute déjà la compilation + le rendu-et-composition
+ _postfx.sh ; le livrable est final_fx.mp4, final.mp4 est pré-réaction plateau)
L'étape 1 init vérifie les compétences installées par rapport aux dernières sur GitHub et met à jour l'ensemble global si certaines sont obsolètes.
L'étape 3 diffère selon le mode :
Étape 3 — Mode Cinématique (embed pur)
- Lire
safe-zones.jsonen premier. Les plans de narration vont danszones.hugLeft/hugRight— des bandes propres jouxtant la silhouette (un texte loin du corps se lit comme flottant, pas intégré ; les coins éloignés sont le repli, pas la valeur par défaut). Le héros par défaut estheroAnchor/heroBands.best(centré SUR le sujet, ~30–55 % occulté).recommendation:"fg"déplace la NARRATION au premier plan pour la lisibilité ; le héros reste intégré chaque fois queheroBands.feasible— hero-fg est le dernier recours. - L'ADN est l'identité que vous avez choisie à l'Étape 0 (CATALOG.md) — ne pas rouvrir le choix ici. Vérifier sa validité contre la scène (bande héros brillante luma > 150 veut
ink; les conseils complets de choix vivent dans le catalogue, couvrant tous les dix incluant neon / glitch / chrome / velocity). Indiquer votre choix + pourquoi ; l'utilisateur décide. L'ADN verrouille le type/palette/blend/mouvement + le triple acte du héros ; les zones de sécurité v2 (palette/optics/lighting) le paramètrent pour CETTE scène automatiquement. - Concevoir
<projet>/cinematic.json—"dna": "<nom>"+ blocs de pensée, pas de groupes bruts : chaque bloc = lignes de mots (groupés 2–5 aux limites des clauses) + le plan dans lequel il s'empile +csspar ligne (taille/poids/style uniquement — pas de positions) + au plus UNE ligne marquée"hero": true(le mot promu ;"text"pour la forme d'affichage). Schéma : en-tête descripts/make-cinematic.cjs. - Compiler :
node scripts/make-cinematic.cjs <projet>— abaisse les blocs → plan.json → index.html. Généré pour vous : timings séquencés par transcription, accumulation dans le bloc, page-flip entre les blocs, le LOCKUP du héros (le pré-contexte d'un bloc héros, le HÉROS et le post-contexte s'empilent comme UNE composition liée centrée sur le sujet — ordre de lecture haut→bas = ordre parlé par construction ; le contexte flotte au PREMIER plan tandis que le héros s'intègre DERRIÈRE = le sandwich de profondeur ; une règle de masse maintient le héros dominant son contexte), division apex/héros mineur, ordre de lecture par construction, repli fg selon les zones de sécurité. Ensuite, les portes s'exécutent normalement. (La conception manuelle de plan.json directement reste possible pour des designs que les blocs ne peuvent pas exprimer — puis exécuterfill-timings.cjs+fit-fonts.cjs+make-composition.cjsvous-même.)
Étape 3 — Mode Thème (constitution thématique)
Lire themes/README.md EN PREMIER — registres de paradigme/scène, liens, règles strictes, et le schéma exact de theme.json.
- Choisir un ADN de thème par registre de contenu (chaque
themes/<nom>.jsonavoice+when). Indiquer votre choix + pourquoi ; l'utilisateur décide. - Concevoir
<projet>/theme.json—dna,lines(textuelle, ordre de transcription ; 1–5 mots chacun — pourtakeoverchaque ligne est une CARTE),minors(mots d'emphase),hero:{match}(le mot/la phrase climax ; le laisser HORS delinespour les scènes embed, le garder DANSlinespour les scènes en ligne et panneau+redact). - Rendre :
bash scripts/render-theme.sh <projet>— compile (porte de complétude textuelle au moment de la compilation), rend les deux couches, compose, applique la réaction plateau →final_fx.mp4. Utiliserpreview-frames.cjsentre la compilation et le rendu pour le QA visuel.
QA visuel — prévisualiser AVANT de rendre
node scripts/preview-frames.cjs <projet> [t…] compose des images de prévisualisation fidèles en ~2s chacune
(couches de légendes capturées d'écran au moment de la recherche + image vidéo réelle + occlusion matte + superposition rail = à quoi
ressemblera la composition finale à ce moment). Les échantillons par défaut = chaque fenêtre de groupe/climax.
Un rendu complet prend des minutes — ne jamais l'utiliser pour découvrir des problèmes de mise en page.
Vérifier les prévisualisations (<projet>/preview/sheet.png) par rapport à...