btcson66-rgb/ecommerce-video-pipeline-skill

Procédure Opérationnelle Standard (SOP) de Production Automatisée de Vidéos Courtes Premium — Version Multi-Marques Flagship

⚠️ 【Règle d’Airain : interdiction absolue de tricher ou de bâcler】

1. Chaque vidéo finale doit impérativement être composée de 3 séquences AI réellement distinctes :
   • S1 (Gemini App) : dynamique lifestyle (streetwear européen, couloir d’affaires, promenade sur court de tennis).
   • S2 (Gemini / Flow) : plan rapproché push-in sur objet posé (table en bois de café, banc de touche).
   • S3 (Google Flow 3D Turntable) : rotation 360° (minimum 5 secondes pour économiser des points + étiquette Asset Chips authentique).
2. Interdiction stricte d’utiliser des diaporamas d’images statiques (Ken Burns / Zoompan) comme séquence principale !
3. Interdiction de boucler avec 1 ou 2 séquences seulement ; la séquence S3 en rotation 360° ne doit jamais manquer !

---

I. Structure standard des 3 séquences & Règles de pub pure

1. Architecture standard des 3 séquences (S1 + S2 + S3)

• S1 (Gemini App dynamique porté, 8s 9:16) :
  • Sacs : promenade urbaine, entrée dans un couloir d’affaires, montrant le balancement naturel épaule/main (uniquement l’apparence extérieure, jamais de plan micro sur l’ouverture de la fermeture éclair ou les coutures intérieures).
  • Lunettes de soleil sport : promenade sur un court de tennis ensoleillé, sur une piste de course, avec plan serré main ajustant la monture.
  • Lunettes de soleil rétro : promenade sur une promenade de palmiers en bord de mer, tenue urbaine ensoleillée.
• S2 (Gemini / Flow plan rapproché push-in, 5~8s 9:16) :
  • Sacs : posé sur une table en bois de café en terrasse, lumière du soleil révélant la texture du cuir et les détails métalliques.
  • Lunettes : café glacé sur une table en bois de café haut de gamme, plan push-in lisse sur la monture métallique artisanale et les verres G-15 ; ou plan serré raquette sur un banc de touche.
• S3 (Google Flow 3D Turntable rotation, 5s 9:16 durée minimale pour économiser des points) :
  • Rotation 360° sur un présentoir, avec présentation multi-couleurs ou un seul tour complet monochrome.

2. Mode publicité commerciale pure de la marque (par défaut « Sans Shopee » Pure Brand Commercial)

• Sauf demande explicite de l’utilisateur de mentionner Shopee, utiliser uniquement le mode publicité d’image de marque institutionnelle pure.
• La capsule supérieure, le cartouche de sous-titres, le bouton CTA d’achat, la voix off et le caption.txt ne doivent contenir aucune occurrence de « Shopee » ; utiliser uniformément « Édition limitée officielle / En stock », « Cliquez ci-dessous pour découvrir / acheter ».

---

II. Étape 1 : Capture d’images authentiques, prétraitement AI-friendly et double vérification

1. Capture d’images originales haute définition et vérification des caractéristiques :
   • Enregistrer la marque réelle (FANTINI, ESPNER, etc.), le modèle, le prix, les coloris en stock et les détails caractéristiques.
2. Préparation préalable des images de référence AI-friendly (Pre-processing Reference Image) :
   • Utiliser scripts/preprocess_ai_ref.py pour supprimer les bordures promotionnelles de l’image principale, centrer le produit et produire une image 1024×1024 RGB sur fond propre (*_gemini_studio.jpg ou *_gemini_hero.jpg), évitant ainsi toute distorsion de taille lors de la reconnaissance par l’IA.
3. Double vérification (anti-mauvaise correspondance + anti-écran noir) :
   • Utiliser obligatoirement read_file pour inspecter visuellement l’image de référence et confirmer une correspondance à 100% avec le produit réel.
   • Exécuter scripts/validate_assets.py pour vérifier que l’image est en mode RGB (interdiction d’utiliser directement une image RGBA à fond transparent).

---

III. Étape 2 : Règles de génération double moteur Gemini (Veo) et Google Flow (Omni 1.1 Flash)

1. Prévention de la contamination du cache des conversations multiples de Gemini (Règle d’Airain d’Isolation de Session)

• En changeant de produit, obligatoirement ouvrir une nouvelle conversation (New Chat) dans l’application Gemini, afin d’éviter que le cache du backend n’utilise par erreur l’image du produit précédent.
• Après téléchargement de la vidéo, extraire immédiatement une trame avec ffmpeg et l’inspecter visuellement avec read_file . Si le style est contaminé par l’ancienne conversation ou si les détails ne correspondent pas, passer immédiatement à Google Flow pour une nouvelle génération.

2. Durée minimale Google Flow pour économiser des points + Contrôle précis des Asset Chips

• S3 : rotation 360° en fin de vidéo (Google Flow obligatoire) :
  • Après upload de l’image authentique, cliquer sur « Ajouter un asset dans le champ de prompt » sous le champ de saisie, cocher l’image authentique et l’insérer comme étiquette conditionnelle (Asset Chips) .
  • Définir la durée minimale (5 secondes) pour économiser les points ; en post-production, étendre via FFmpeg setpts en ralenti lissé jusqu’à la durée de la voix off.
• Relais sans couture lorsque le quota Gemini est épuisé ou pour des plans serrés précis :
  • Si Gemini atteint la limite de 3 vidéos par tour (temps de recharge 5h), S1 / S2 sont générées directement par Google Flow, sans attendre inutilement.

---

IV. Étape 3 : Voix off masculine posée et production double version FFmpeg « zéro coupure, zéro arrêt sur image »

Script de production automatisée standard : scripts/render_video_template.py

1. Standard de voix off (zéro coupure de parole) :
   • Utiliser uniformément edge-tts voix masculine posée taïwanaise : zh-TW-YunJheNeural (rate="-1%", pitch="-2Hz").
   • Suppression totale de la limite rigide de 24 secondes : la durée du segment est déterminée dynamiquement par la longueur complète de la phrase (target_dur = audio_dur + 0.8s, incluant adelay=350|350 et un blanc de respiration en fin de phrase). Interdiction d’utiliser atrim pour couper la voix off.
2. Extension fluide de l’image (zéro arrêt sur image) :
   • Interdiction d’utiliser tpad=stop_mode=clone pour figer la dernière trame !
   • Lorsque la durée de la vidéo originale (par ex. 5s ou 8s) est inférieure à la durée cible du segment, utiliser systématiquement setpts=(seg_dur/v_dur)*PTS pour un ralenti dynamique lissé, ou combiné avec un zoom avant push-in lissé, garantissant un mouvement continu tout au long du plan.
   • Spécifications de sortie obligatoires : 1080x1920, -r 30 (30.0 fps CFR), libx264, yuv420p.
3. Production simultanée de deux versions (multi-couleurs + monochrome 360°) :
   • final.mp4 : S1 + S2 + S3 (cartes de transition multi-couleurs).
   • final_single_color.mp4 : S1 + S2 + S3 (carte de rotation 360° couleur unique principale).
4. Vérification visuelle de la vidéo finale :
   • Extraire final_check_s1.jpg, final_check_s2.jpg, final_check_s3.jpg, utiliser read_file pour inspection visuelle.

---

V. Étape 4 : Livraison pack de 7 fichiers sur Google Drive liste blanche

1. Liste standard des 7 fichiers :
   • final.mp4 (version multi-couleurs)
   • final_single_color.mp4 (version rotation 360° monochrome)
   • cover.jpg (1080×1920 couverture haute qualité)
   • caption.txt (texte de communauté officiel et hashtags, sans Shopee)
   • title.txt (titre SEO)
   • product_url.txt (URL du produit)
   • qa.json (enregistrement de réussite du contrôle qualité)
2. Processus de téléchargement liste blanche :
   • Copier les 7 fichiers dans C:\Users\User\AppData\Local\Temp\<Product_ID>\.
   • Dans Google Drive 02_手機待發布, créer un sous-dossier (<Numéro>_<Marque>_<Nom court du produit>) et terminer l’upload.