Pipeline Shorts (neutre thématiquement)
Une seule liste de montage (<short>/edl.json) et une voix off donnent une vidéo terminée : des clips animés dans une fenêtre photo thématique, des sous-titres par mots, un écran d'accroche, un cercle de mise en valeur, une couverture, une liste d'effets sonores et un mixage à -14 LUFS.
Tout ce qui est spécifique à une chaîne (sujet, langues, public, règles de contenu, aspect visuel, voix, crédits, planning) se trouve dans CHANNEL.md du projet. Lisez-le d'abord et suivez-le par rapport aux valeurs par défaut ci-dessous. Si le fichier est manquant ou contient des sections vides, demandez au propriétaire (ou copiez engine/templates/CHANNEL.md et remplissez-le avec lui) avant de produire quoi que ce soit.
Compétences associées : shorts-script-voice (sujet, script, voix) et shorts-packaging (fichiers finis, textes de publication).
Avant tout
- Les scripts du kit (
setup.sh,shorts-init.sh,doctor.sh,install-codex.sh) se trouvent dans le dossierscripts/du kit : le dossier du plugin, ou$SHORTS_HOME/kit/scripts/(setup.shetinstall-codex.shen conservent une copie). - Travaillez à partir d'un dossier projet qui contient
_pipeline/,_tools/,_fonts/,CHANNEL.md(créez-en un avecscripts/shorts-init.sh <dir>). Toutes les commandes ci-dessous s'exécutent depuis la racine de ce dossier. - Exécutez
scripts/doctor.sh <project-dir>une fois par machine. Il vérifie toutes les dépendances (programmes système, paquets Python, modèles, espace disque) et doit se terminer par "All good." Sinon :scripts/install-system-deps.shpour ffmpeg/Python/curl,scripts/setup.shpour le reste. La liste complète se trouve dansDEPENDENCIES.mddu kit. SHORTS_HOME(par défaut~/.shorts-studio) contient l'environnement virtuel Python et les modèles vocaux. Exportez-le si vous le placez ailleurs.- Lisez
_pipeline/README.md(référence du moteur) etreferences/edl-notes.mdavant d'écrire une liste de montage.
Le flux de travail (chaque étape a sa propre vérification)
| # | Étape | Commande / sortie | Vérification |
|---|---|---|---|
| 1 | Sujet + script | compétence shorts-script-voice | une affirmation, sources attribuées, propriétaire OK quand le profil le demande |
| 2 | Voix | $SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json, puis _tools/words.py <short>/vo | lisez vo/words.json : chaque mot est correct |
| 3 | Séquences | _tools/grab.py <sujet> '<url>' <début> <fin> --tag NOM (journal dans _footage/SOURCES.md), ou vos propres enregistrements | planche contact de chaque clip ; politique depuis CHANNEL.md |
| 4 | Liste de montage | copiez references/edl-template.json, modifiez le contenu | build.py <edl> --words affiche les tokens des sous-titres |
| 5 | Rendu | python3 _pipeline/build.py <short>/edl.json --theme <thème> (3-10 min ; 4K60 est lent) | pas d'erreur ; le fichier est plus récent que l'edl |
| 6 | Couverture | ... build.py <edl> --cover | "safe-zone violations: none", lisible à 180 px de large |
| 7 | Vérification | python3 _pipeline/check.py <short>/<nom>-<thème>-silent.mp4 <short>/edl.json | affiche ALL CHECKS PASS ; vous avez regardé chaque planche contact |
| 8 | Son | $SHORTS_HOME/venv/bin/python _pipeline/sound/mix.py <short> --theme <thème> --music <nom> --strict | -14.0 +/-0.5 LUFS, crête réelle <= -1.0 dBTP, erreurs de mots proches de 0 |
| 9 | Empaquetage | compétence shorts-packaging | fichier + couverture + texte de publication dans ready/ |
Planches contact d'un clip source : ffmpeg -ss <t> -i <fichier> -t <d> -vf "fps=2,scale=320:-1,tile=7x4" -frames:v 1 out.png
(écrivez en PNG : la sortie JPEG de certaines sources échoue avec "non full-range YUV"). Limites de plans :
ffmpeg -i <fichier> -vf "scale=320:180,select='gt(scene,0.25)',showinfo" -an -f null - 2>&1 | grep -o "pts_time:[0-9.]*".
Thèmes : case-file (papier dossier), panel-heist (planche BD), vice-dusk (crépuscule néon), classic ; le profil en choisit un.
À quoi ressemble une bonne short (valeurs par défaut ; le profil les surcharge)
- 18-45 s, un argument de l'accroche à la conclusion, un cut toutes les 1.5-3 s, chaque plan bouge, l'écran d'accroche est présent dès la frame 0
(
hook.y1170 le maintient dégagé de l'étiquette d'exposition), un moment héroïque avec un cercle rouge sur quelque chose que la frame montre vraiment. - L'image suit les mots. Les sous-titres sont des phrases de 2-3 mots (
break_before) ; les noms restent en un seul groupe. - Le dernier plan revient sur la première frame (la vidéo boucle).
- Tout texte lisible reste dans la zone de sécurité du téléphone : y 300-1580, x 130-950 (x <= 860 pour y 1000-1600). check.py l'applique.
- Fenêtre photo haute
"aspect": "3:4"(900x1200) sur des clips en 1080p et plus ; les sources 720p ou letterboxées ne peuvent pas la remplir.
Leçons durement acquises (détails dans references/lessons.md)
- L'edl est plus récent que le rendu ? Le rendu est obsolète. Reconstruisez avant de juger check.py.
- Plans figés (frames consécutives qui diffèrent à peine pendant > 0.3 s) font échouer check.py. Les écrans statiques, les couleurs unies et les sujets immobiles ont besoin d'un mouvement à vitesse constante :
"move_ease": "linear", une plage de zoom de 0.15-0.4 et un panoramique de 150+ px source.floatseul ne suffit pas (la sinusoïde ralentit jusqu'à zéro à ses extremums). - Limites de zoom : sources 4K <= 1.00, 1080p <= 1.25, 720p <= 1.0 (check.py affiche la limite par clip).
- Superpositions de créateur (filigrane, facecam, tiers inférieur, sous-titres, bannières stylisées) n'atteignent jamais l'image : recadrez avec la surcharge d'image
sourcesde premier niveau, déplacez le recadrage ou choisissez d'autres frames. Regardez chaque cut frame. - Honnêteté : les étiquettes, les cercles et les sous-titres ne disent que ce que la frame montre ; attribuez les faits à leur source dans la voix.
- Couverture : un recadrage plein cadre d'une frame source ; la plaque se place à
tab_y(330) et cache le haut de l'image. Pour un sujet près du haut, définisseztab_yvers 1090 etstamp_yvers 410. - Un rendu à la fois (un rendu 4K60 utilise tous les cœurs) ; ne lancez jamais un second rendu du même dossier.
Délégation d'un montage à un sous-agent
Donnez à l'agent BRIEF.md (créé par shorts-init à partir de references/editor-brief.md) ainsi que le script, les fichiers vocaux et la liste des clips. La session principale écrit le script et la voix, revérifie chaque plan elle-même et effectue le mixage sonore : le rapport d'un agent est une affirmation, pas une preuve. Vérifiez les heures des fichiers (mp4 silencieux plus récent que l'edl, journal de check plus récent que le mp4) avant d'accepter.