ekomen77/erko-ai-video-engine

Moteur de production vidéo animée Erko AI (erko-ai-video-engine)

Cette compétence fournit le pipeline complet, éprouvé sur le terrain, avec les actifs, polices, rigs de personnages, assistant IA expressif (Clawd), et le moteur de rendu Headless Chrome + FFmpeg pour produire des vidéos YouTube explicatives en 1080p 30 ips dans le style ekomen77.

1. Règles d'Or (CRITIQUES — Ne Jamais Enfreindre)

1. ZÉRO Modification du Visage/Bouche du Personnage (%100 Saf Karakter):
   • Ne JAMAIS recadrer, coller, rapiécer ou dessiner des bouches/ellipses synthétiques sur les sprites du personnage.
   • Toujours utiliser les PNG transparents normalisés et intacts dans ./resources/pure_poses/pose_01.png à pose_13.png.
2. Poses Calmes et Stables du Personnage (Pas de Changement Rapide en Parlant):
   • Ne JAMAIS changer la pose du personnage en fonction de l'amplitude audio image par image (amp < 0.12), car les pauses entre les mots provoquent un scintillement frénétique du corps à 3–5 Hz.
   • Ne JAMAIS appliquer une oscillation sinusoïdale continue (jelly wobble) au corps du personnage.
   • Garder 1 pose stable par scène (ou au plus 1 transition de pose intentionnelle lorsqu'un tampon/verdict majeur frappe).
3. Alterner entre le Studio avec Tableau Blanc et les Graphiques Plein Écran:
   • Scènes Studio (drawStudioBase): Utiliser pour les introductions narratives, les transitions et 1–2 cartes concises à l'intérieur du tableau mural (WB = { x: 1044, y: 274, w: 462, h: 294 }). Placer le personnage sur le plancher en bois ouvert (footX = 870, footY = 942, scale = 0.85).
   • Diagrams Plein Écran sur Papier Crème (drawFullScreenPaperBg): Masquer complètement le fond du studio (#EDE5D8 toile de papier) lors de l'affichage de 3+ grandes cartes, piliers d'architecture ou diagrammes en podium (x = 680..1800).
   • Grille Cyber Sombre Plein Écran (drawFullScreenCyberBg): Masquer le fond du studio et rendre un canevas sombre #0E1218 avec une grille de sol 3D rouge en perspective (horizonY = 560) lors de l'affichage de dumps hexadécimaux, terminaux de décompilation ou cartes de boîte noire verrouillées.
   • Règle pour pose_08.png (Chevalet "THE PLAN"): Parce que pose_08.png a son propre chevalet/blanc intégré, utiliser pose_08.png UNIQUEMENT dans les scènes de Diagramme Plein Écran sur Papier (footX = 285, footY = 885, scale = 0.82), jamais devant le tableau blanc mural du studio.
4. Typographie Turque & Système de Polices Maîtresses:
   • Scènes de Tableau Blanc (Panneau de Preuve d'Investigation): Utiliser ./resources/fonts/Kalam-Bold.ttf pour les titres et les légendes principales ; utiliser ./resources/fonts/PatrickHand-Regular.ttf pour les puces de corps, questions et notes. Les deux polices sont vérifiées avec un support natif à 100% des glyphes turcs (İ, ı, Ş, ş, Ğ, ğ, Ç, ç, Ö, ö, Ü, ü).
   • Scènes de Graphiques Plein Écran & Terminal: Utiliser ./resources/fonts/Montserrat-Black.ttf, ./resources/fonts/SpaceMono-Bold.ttf, ./resources/Fredoka-Bold.ttf et ./resources/JetBrainsMono-Bold.ttf.
   • Ne JAMAIS utiliser ctx.globalAlpha < 1 avant d'appeler drawChunkyText, car le contour noir traverserait le remplissage semi-transparent et rendrait les lettres grises et boueuses. Pour assombrir les cartes d'arrière-plan derrière un tampon, dessiner les cartes à globalAlpha = 1.0 puis dessiner un voile rectangulaire semi-transparent (rgba(237, 229, 216, 0.42)) sur les cartes avant de dessiner le tampon.
5. Toujours Fournir un MP4 Lisible:
   • Le moteur de rendu écrit le .mp4 final dans ./out/<prefixe>_1080p.mp4 à côté de vos fichiers projet.
   • Si une copie supplémentaire doit atterrir à un endroit pratique (Bureau, disque partagé), définir ERKO_DELIVER_DIR=<dossier> avant d'exécuter le rendu — le script copie automatiquement le MP4 terminé à cet endroit.
6. Règle pour le Compagnon IA Occasionnel (Clawd):
   • Clawd (la mascotte boîte peinte à la main procédurale de ./resources/clawd_assistant.js) est notre Agent / Assistant IA R.E.A. en direct.
   • Ne JAMAIS garder Clawd en permanence à l'écran — cela crée de l'encombrement visuel et distrait du narrateur.
   • Apparaître UNIQUEMENT pour les répliques choc, les moments eurêka, ou les assists interactifs (1–2 apparitions clés par chapitre, durant 3–8 secondes).
   • Exemples d'apparitions :
     • Surgir sur le bureau/bord du tableau blanc du studio avec des écouteurs ou une ampoule d'idée lors d'une percée.
     • Apparaître avec un fedora de détective ou un casque de chantier sur une carte plein écran pour casser un bloc de code verrouillé (furieux / déterminé), puis célébrer avec des lunettes de soleil (cool).
7. Règles de Studio Dynamique & Anti-Aplatissement (Rendre les Scènes Percutantes):
   • Zoom instantané dynamique de la caméra: Les scènes de studio ne doivent PAS rester à un zoom large fixe. Faire un zoom instantané à 1.15x–1.25x avec easeOutBack lors des répliques clés, puis revenir en arrière en douceur.
   • Changements d'éclairage thématiques du studio: Ajuster l'ambiance en fonction de l'ambiance narrative :
     • Travail profond de nuit (Chapitre 2): Baisser la lumière de la pièce, intensifier les écrans cyan/verts lumineux et faire palpiter les braises de la cheminée.
     • Moment eurêka de percée: Une aura dorée radieuse et chaude éclate derrière le personnage.
   • Émoticônes procédurales: Utiliser drawEmote('!', ...) / drawEmote('?', ...) / drawEmote('bulb', ...) / drawEmote('sweat', ...) à côté des personnages pour ponctuer visuellement les répliques du dialogue.
   • Secousse d'écran d'impact de tampon: Lorsqu'un tampon lourd (✔, ❌, BOMBA!) ou un buzzer d'erreur frappe, appliquer 3–5 images de tremblement de caméra subtil (x += sin(t*40)*4, y += cos(t*40)*4).
   • Transitions dessinées à la main: Utiliser drawBrushWipe(ctx, progress) ou drawIris(ctx, progress) entre les limites de scène majeures pour un flux narratif fluide.
8. Illustrations IA Personnalisées (Utilisation Rare + Références Exactes des Personnages + Pré-annonce):
   • L'épine dorsale reste le Studio + les Diagrammes Canvas: Ne PAS transformer la vidéo en diaporama d'images IA. Garder 85–90% de chaque chapitre en tant que nos classiques Cartes de Tableau Blanc Studio + Graphiques Plein Écran/Terminaux.
   • Ne Générer des Illustrations Personnalisées QUE Lorsque Vraiment Nécessaire: Au maximum 1 illustration personnalisée par chapitre pour une métaphore visuelle concrète (par exemple, chambre Sandbox, coffre RPG, salle d'audience historique).
   • Correspondance de Référence Stricte: Lors de la génération d'une image via image-generator, TOUJOURS passer les images de référence exactes pour Pickle (texture vert olive terne, sweat à capuche noir surdimensionné, jambes fines en bâton) et Clawd (boîte rectangulaire 10x6 couleur terre cuite, 4 pattes courtes, 2 bras courts, contour à l'encre gras).
   • Annoncer le Plan Visuel Avant le Rendu: Avant de rendre un nouveau chapitre, informer brièvement l'utilisateur du plan visuel scène par scène et si une illustration personnalisée sera utilisée.
9. Alignement Strict Pied-Ombre & Pas de Chevauchement de Props Latéraux:
   • Les 13 poses du personnage (pose_01..13.png) sont normalisées à 700x780 avec CHAR_CENTER_X = 350 et FOOT_BASELINE_Y = 741 (marge transparente inférieure de 39px).
   • Ne jamais utiliser un sprite de prop latéral non recadré (comme l'ancien chevalet 1050x780 pose_08) où un prop intégré se retrouve bloqué derrière des cartes de diagramme ou déplace le personnage loin de l'ombre au sol. pose_08.png a le chevalet retiré et Pickle centré à x = 350.
   • Dans drawCharacter, toujours dessiner le sprite à y = footY - ih + 29 * scale + breathY de sorte que la plante des pieds du personnage repose directement à l'intérieur de l'ellipse de l'ombre de contact (footY - 10).
10. Clawd Assistant Doit Toujours se Tenir sur une Surface Solide (Ne Jamais Flotter):
    • Ne jamais placer Clawd dans les airs ou en vol stationnaire devant des meubles/moniteurs.
    • Dans les Scènes Studio, placer Clawd debout fermement sur les planches de bois ouvertes juste à côté de Pickle (x = 685, y = 938), avec son ombre de contact nette directement sous ses 4 pattes.
    • Dans les Scènes de Diagramme Plein Écran, passer podium: true à drawClawd(...) (ou le placer sur une surface de sol/podium solide) afin qu'il se tienne sur un mini-podium en bois assorti avec une ombre de contact claire.
11. Découpage Polygonal Natif du Tableau Blanc du Studio (Pas de Patch Flottant #FAF6EE):
    • Ne jamais dessiner un ctx.fillRect(WB.x, WB.y, WB.w, WB.h) opaque sur studio_background_1080p.jpg, car le cadre métallique supérieur du tableau blanc d'arrière-plan a une pente de perspective subtile et un rectangle opaque crée une couture de patch/autocollant visible sur le cadre.
    • Toujours découper selon le polygone exact à 4 coins du tableau blanc intérieur ((1034, 294) -> (1510, 279) -> (1510, 580) -> (1034, 580)), dessiner directement sur la surface naturelle du tableau blanc du fond du studio, et faire pivoter le contenu du tableau blanc de -0.024 rad (-1.4°) autour de (WB.cx, WB.cy) afin que les en-têtes et les cartes s'alignent naturellement avec l'angle du tableau physique.
12. Superposition d'Interface YouTube Abonnement Authentique Plein Écran pour Appel à l'Action:
    • Ne jamais cacher les appels à l'action importants pour les spectateurs (Abone Ol, Bildirimleri Aç, Beğen) dans le petit tableau blanc du fond du studio.
    • Rendre une Superposition d'Interface Utilisateur de Page de Veille YouTube et d'Abonnement Authentique proéminente et centrée (drawYouTubeSubscribeOverlay), complète avec un aperçu de la fenêtre vidéo en direct, une barre de défilement YouTube rouge, un avatar de chaîne, et un curseur de souris animé cliquant sur ▶ ABONE OL ➔ ✔ ABONE OLUNDU et 🔔 TÜMÜ AÇIK! avec une explosion de confettis/ondulations.
13. Règle d'Accroche Provocatrice Obligatoire des 15 Premières Secondes (Uzun Videolar ve Shorts İçin Ortak Zorunluluk):
    • Format Bağımsızlığı: Bu kural hem tam uzunluktaki YouTube videolarında (Chapter 1 / Giriş) hem de YouTube Shorts / Reels videolarında İSTİSNASIZ zorunludur. Uzun video diye yavaş, sıkıcı veya teorik giriş yapılmaz.
    • Ne jamais commencer par une exposition documentaire/académique passive (par exemple, "Bugün sizlere X mimarisini anlatacağım..." veya "Yazılım dünyasında yeni bir gelişme var..." kesinlikle yasaktır).
    • Her videonun ilk 15 saniyesi (Uzun videoda Bölüm 1'in ilk saniyeleri, Shorts'ta giriş) izleyicinin ezberini bozan, bir yalanı çürüten veya dev bir iddia ortaya atan 3 adımlı yapıdan oluşur:
      • 0.0s – 5.0s (Şok İddia / The Shock Claim): Yerleşik bir yanılgıyı yüzlerine vur ("Yazılım şirketlerinin 'kırılamaz' dediği kapalı kutu programlar koca bir yalan!" / "ChatGPT'nin seni anladığını sanıyorsan fena halde kandırılıyorsun!").
      • 5.0s – 10.0s (İddiayı & Meydan Okumayı Yükselt / High Stakes): İddiayı cesur bir benzetmeyle zirveye çıkar ("İddia ediyorum: Bir ekibin 5 yılda gizlediği sistemi, tek bir yapay zeka ajanı 10 dakikada deşifre edebilir!" / "Karşındaki bir zeka değil, tarihin en büyük şans çarkı!").
      • 10.0s – 15.0s (İspat Kapısı / The Proof Gate): İzleyiciyi videonun kalanını izlemeye mecbur bırak ("İnanmıyor musun? Arkadaki sihri ve büyük illüzyonu adım adım ispatlıyorum, iyi izleyin!").
14. Formule Officielle du Tableau Blanc du Studio : Panneau de Preuve d'Investigation (Dedektif Panosu + Clawd):
    • Pas de Cartes de Dessin Animé Bon Marché ou de Cercles Tape-à-l'Œil: Ne jamais dessiner de boîtes Web arrondies épaisses ou de cercles rouges arbitraires autour des mots (ils encombrent le tableau, semblent amateurs et donnent l'impression de modèles IA génériques).
    • Bande Surligneur Néon à Pointe Biseautée: Les mots clés importants ont une bande surligneur fluorescente semi-transparente dessinée derrière le texte (rgba(253, 224, 71, 0.65) jaune néon, rgba(74, 222, 128, 0.5) vert menthe, rgba(251, 146, 60, 0.45) orange).
    • Carte de Preuve / Document de Type Polaroid Collé (drawPolaroid): Attacher une carte Polaroid d'apparence physique avec du ruban adhésif semi-transparent (rgba(180, 175, 165, 0.85)) sur le dessus, affichant la métaphore visuelle concrète (roue de roulette, dé 3D, architecture de puce, extrait de décompilateur).
    • Tampon encreur en caoutchouc incliné (drawRubberStamp): Pour démystifier les mythes ou confirmer les faits, tamponner directement sur l'affirmation à -8° à -12° avec une encre rouge à double bordure détériorée ([ ÇÜRÜTÜLDÜ ], [ KANITLANDI ], [ İLLÜZYON ], [ HACKLENDİ ]).
    • Note Post-It Jaune Collée (drawPostIt): Épinglée ou collée avec du ruban adhésif Scotch sur le côté pour les formules, pourcentages et règles.
    • Clawd sur le Rebord du Tableau Blanc: Clawd est assis fermement sur la bordure/plateau en bois sous le tableau blanc (x = 1045, y = 642, scale = 6), portant son fedora de détective marron avec une ampoule d'idée 💡 ou une émoticône de réaction, intégrant de manière transparente le duo dans le moment d'enseignement.
15. Anti-Patterns Stricts & Prévention des Échecs (Önceki Hataları Asla Tekrarlamama Kuralları):
    • Zéro "Syndrome de l'Autocollant" / Composition de Personnage Déconnectée (YASAK: Havada Asılı / Yapıştırma Karakterler): Le personnage doit physiquement toucher l'objet avec lequel il interagit, s'imprégner de la lumière ambiante (tamisée, cheminée chaude, cyber) et ne pas ressembler à un collage sans contact.
    • Zéro Maquette HTML/CSS Bon Marché (YASAK: Web Div'leri ve Emojilerle Sahte İllüstrasyon Yapmak): Ne jamais produire de fausses boîtes Web avec des emojis 🍎 🍒 777. Dessiner des cartes GitHub/terminal réalistes ou des diagrammes à la craie organiques.
    • Zéro Encombrement Visuel / Règle de Respiration (Görsel Dağınıklık Yasağı): Ne pas entasser 4–5 éléments complexes différents dans une scène. La scène doit être spacieuse et ciblée autour d'une seule analogie puissante.
    • Texture de Matériau Organique plutôt que des Vecteurs Stériles (Dijital Jilet Çizgi Yasağı): Les lignes de règle droites et stériles sont interdites. Les lignes doivent être granuleuses comme la craie, légèrement ondulées et avec des coins légèrement dépassants (overshoot).
16. Archétype Officiel de Scène Plein Écran : Tableau Noir Ardoise + Carte de Preuve Inclinée:
    • Sol: Texture d'ardoise foncée de tableau noir (#20201F / #282725 texture mate organique granuleuse, légères traces de poussière de gomme et vignette de bord).
    • Côté Gauche (Carte de Preuve / Artefact Polaroid): Inclinée de $-5.5^\circ$ vers la gauche (transform: rotate(-5.5deg)), bordure photo ivoire épaisse (#f2eee5), ombre portée douce et profonde, contenu de code ou terminal réel.
    • Côté Droit (Arbre Architectural à la Craie Organique): Boîte d'entrée supérieure $ ightarrow$ Boîte de traitement centrale $ ightarrow$ Boîtes de distribution inférieures.
17. Direction Visuelle & Typographique Officielle : "Doğal Tebeşir & Sıcak Amber" (Stil 2 - Kullanıcı Onaylı Ana Standart):
    • Hiyerarşi Tipografi:
      • Başlıklar, Büyük İddialar, Mühürler: ./resources/fonts/Kalam-Bold.ttf

...

[truncé pour la traduction]