btcson66-rgb/ecommerce-video-pipeline-skill

Procedimiento Operativo Estándar (SOP) de Producción Automatizada de Videos Cortos Premium — Edición Multimarca Universal

⚠️ 【Regla de Hierro: Prohibido Absolutamente la Pereza y el Montaje】

1. Cada video final debe estar compuesto exclusivamente por 3 videos AI reales y distintos:
   • S1 (Gemini App): Dinámica de uso en la vida real (paseo callejero europeo, pasillo de negocios, paseo en cancha de tenis).
   • S2 (Gemini / Flow): Primer plano de colocación del producto y push-in suave (mesa de madera de cafetería al aire libre, banco lateral).
   • S3 (Google Flow 3D Turntable): Exhibición de rotación 360° (mínimo 5 segundos para ahorrar puntos + etiquetas de Asset Chips de producto auténtico).
2. ¡Prohibido estrictamente el uso de imágenes estáticas con movimiento (Ken Burns / Zoompan) como video principal!
3. ¡Prohibido terminar el proyecto con solo 1 o 2 segmentos! ¡El plano de rotación 360° de S3 es obligatorio!

---

I. Arquitectura Estándar de 3 Segmentos de Cámara y Normativa de Anuncios Puros

1. Arquitectura Estándar de 3 Segmentos de Cámara (S1 + S2 + S3)

• S1 (Dinámica de uso con Gemini App, 8 segundos 9:16):
  • Bolsos: Paseo urbano, entrada a pasillo de negocios, mostrando el balanceo natural al hombro/mano (solo se muestra el exterior, absolutamente no se toman primeros planos macro de la tapa interior o cremalleras de la cartera).
  • Gafas de sol deportivas: Paseo en cancha de tenis soleada, paseo en pista deportiva con primer plano de mano tocando la montura.
  • Gafas de sol retro: Paseo en avenida de palmeras junto al mar, conjunto de paseo callejero soleado.
• S2 (Primer plano con push-in de Gemini / Flow, 5 a 8 segundos 9:16):
  • Bolsos: Colocación en mesa de madera de cafetería al aire libre, luz solar incidiendo en la textura del cuero y detalles metálicos.
  • Gafas de sol: Mesa de madera de cafetería al aire libre con café helado, push-in suave a primer plano de la montura metálica artesanal y lentes G-15; o banco lateral con primer plano de raqueta.
• S3 (Rotación 360° con Google Flow 3D Turntable, 5 segundos 9:16, duración mínima para ahorrar puntos):
  • Exhibición en rotación 360° sobre plataforma, con introducción de cambio de color o rotación completa de un solo color.

2. Modo de Anuncio Oficial Puro de Marca (Modo "Sin Shopee" Predeterminado, Pure Brand Commercial)

• A menos que el usuario solicite específicamente etiquetar Shopee, se adopta el modo de anuncio de imagen oficial de marca pura.
• En el cápsula superior, tarjeta de subtítulo inferior, botón CTA de compra, voz en off y caption.txt está estrictamente prohibido cualquier mención de "Shopee", se etiqueta uniformemente como "Oficial / En stock", "Haz clic abajo para explorar / comprar".

---

II. Paso 1: Captura de Imágenes de Producto Auténtico, Preprocesamiento Amigable para AI y Doble Verificación

1. Captura de imágenes originales de alta calidad y verificación de características:
   • Registrar la marca real (FANTINI, ESPNER, etc.), modelo, precio, colores disponibles y características detalladas.
2. Preparación previa de imágenes de referencia para identificación amigable con AI (Pre-processing Reference Image):
   • Usar scripts/preprocess_ai_ref.py para eliminar los bordes de texto promocional de la imagen principal del producto, centrarla y generar una imagen RGB de 1024×1024 con fondo limpio (*_gemini_studio.jpg o *_gemini_hero.jpg), evitando distorsiones de tamaño en la identificación de la IA.
3. Doble verificación (prevención de desajustes + pantalla negra):
   • Es obligatorio usar read_file para inspeccionar visualmente la imagen de referencia, confirmando que coincide al 100% con el producto real.
   • Ejecutar scripts/validate_assets.py para confirmar que la imagen está en modo RGB (está estrictamente prohibido usar imágenes con fondo transparente RGBA directamente).

---

III. Paso 2: Normas de Generación con Motor Doble Gemini (Veo) y Google Flow (Omni 1.1 Flash)

1. Prevención de Contaminación de Caché en Conversaciones Múltiples de Gemini (Regla de Hierro de Aislamiento de Sesión)

• Al cambiar de producto, en la aplicación Gemini se debe iniciar una conversación completamente nueva (New Chat) para evitar que el caché del backend utilice incorrectamente las imágenes del producto anterior.
• Después de descargar el video, se debe extraer inmediatamente un fotograma con ffmpeg e inspeccionarlo visualmente con read_file. Si el diseño está contaminado por la conversación anterior o los detalles no coinciden, se debe regenerar inmediatamente con Google Flow.

2. Ahorro de Puntos con Duración Mínima y Control Preciso de Asset Chips en Google Flow

• S3: Exhibición de Rotación 360° del Turntable 3D al Final (Obligatorio usar Google Flow):
  • Después de subir la imagen del producto auténtico, se debe hacer clic en "Añadir material" debajo del cuadro de entrada, marcar la imagen del producto auténtico e insertarla como etiqueta condicional (Asset Chips).
  • Configurar la duración mínima (5 segundos) para ahorrar consumo de puntos, y luego en postproducción usar setpts de FFmpeg para una extensión en cámara lenta suave hasta la longitud necesaria para la locución.
• Relevo sin costuras cuando se agoten los créditos de Gemini o se necesiten primeros planos precisos:
  • Si Gemini alcanza el límite de 3 videos por ronda (enfriamiento de 5 horas), S1/S2 se generan directamente con Google Flow, sin necesidad de esperar.

---

IV. Paso 3: Locución de Voz Masculina Seria y Compresión de Video de Doble Versión "Sin Corte, Sin Congelación" con FFmpeg

Script de compresión automatizada estándar: scripts/render_video_template.py

1. Estándar de Locución (Sin Corte de Voz):
   • Usar uniformemente edge-tts con voz masculina seria taiwanesa estándar: zh-TW-YunJheNeural (rate="-1%", pitch="-2Hz").
   • Límite flexible de 24 segundos eliminado por completo: la duración del segmento se determina dinámicamente por la longitud completa de la oración (target_dur = audio_dur + 0.8s, incluyendo adelay=350|350 y espacio de respiración al final), está estrictamente prohibido usar atrim para cortar la locución.
2. Extensión Suave del Fotograma (Prohibido Absolutamente el Fotograma Congelado - Zero Freeze Frame):
   • ¡Prohibido usar tpad=stop_mode=clone para congelar el fotograma final!
   • Cuando la duración del video original (por ejemplo, 5s u 8s) es menor que la duración objetivo del segmento, se debe usar uniformemente setpts=(seg_dur/v_dur)*PTS para una extensión en cámara lenta suave y dinámica, o combinarlo con un zoom push-in suave, asegurando un movimiento de cámara continuo durante todo el segmento.
   • Especificaciones de salida obligatorias: 1080x1920, -r 30 (30.0 fps CFR, frecuencia de cuadros constante), libx264, yuv420p.
3. Producción Sincronizada de Dos Versiones (Versión Multicolor + Versión de Rotación 360° de un Solo Color):
   • final.mp4: S1 + S2 + S3 (tarjeta de cambio de color multicolor).
   • final_single_color.mp4: S1 + S2 + S3 (tarjeta de exhibición de rotación 360° de un solo color principal).
4. Inspección Visual del Video Final:
   • Extraer final_check_s1.jpg, final_check_s2.jpg, final_check_s3.jpg y usar read_file para inspección visual.

---

V. Paso 4: Entrega del Conjunto de 7 Archivos en Lista Blanca de Google Drive

1. Lista Estándar del Conjunto de 7 Archivos:
   • final.mp4 (versión de introducción multicolor)
   • final_single_color.mp4 (versión de rotación 360° de un solo color)
   • cover.jpg (portada de alta calidad 1080×1920)
   • caption.txt (texto de comunidad oficial y Hashtags, sin Shopee)
   • title.txt (título SEO)
   • product_url.txt (URL del producto)
   • qa.json (registro de control de calidad aprobado)
2. Proceso de Subida en Lista Blanca:
   • Copiar los 7 archivos a C:\Users\User\AppData\Local\Temp\<Product_ID>\.
   • En Google Drive 02_手機待發布, crear una subcarpeta (<Número>_<Marca>_<Nombre Corto del Producto>) y completar la subida.