btcson66-rgb/ecommerce-video-pipeline-skill

Procedimento Operacional Padrão (POP) para Produção Automatizada de Vídeos Curtos Premium — Versão Multi-Marcas Completa

⚠️ 【Regra de Ferro: Proibido Preguiça e Colagem】

1. Cada vídeo final DEVE e só PODE ser composto por 3 vídeos de IA reais e distintos:
   • S1 (Gemini App): Ação lifestyle com uso real do produto (street style europeu, corredor corporativo, passeio na quadra de tênis).
   • S2 (Gemini / Flow): Close-up premium com produto em repouso e suave aproximação (mesa de madeira em café ao ar livre, banco à beira da quadra).
   • S3 (Google Flow 3D Turntable): Exibição giratória de 360° (mínimo de 5 segundos para economizar pontos + Asset Chips com etiqueta autêntica).
2. Proibido usar efeitos de câmera em imagem estática (Ken Burns / Zoompan) como plano principal!
3. Proibido concluir com apenas 1 ou 2 segmentos; o close-up giratório S3 é obrigatório!

---

I. Estrutura Padrão de 3 Segmentos de Câmera e Normas de Anúncio Puro

1. Arquitetura Padrão de 3 Segmentos (S1 + S2 + S3)

• S1 (Ação com uso real no Gemini App, 8s 9:16):
  • Bolsas: Passeio urbano, entrada em corredor corporativo, mostrando balanço natural no ombro/na mão (apenas aparência externa, proibido close-ups macro de interior, zíper ou acabamento).
  • Óculos esportivos: Quadra de tênis ensolarada, passeio em pista de atletismo com close-up da mão ajustando a armação.
  • Óculos vintage: Passeio em avenida de palmeiras à beira-mar, estilo urbano sob o sol.
• S2 (Close-up com suave aproximação no Gemini/Flow, 5~8s 9:16):
  • Bolsas: Colocada sobre mesa de madeira em café ao ar livre, luz solar destacando textura do couro e detalhes metálicos.
  • Óculos: Sobre mesa de madeira em café premium ao ar livre com café gelado, suave aproximação em close-up da armação artesanal e lentes G-15; ou sobre banco à beira da quadra com close-up de raquete.
• S3 (Exibição giratória 360° no Google Flow, 5s 9:16 – duração mínima para economizar pontos):
  • Girando 360° em um suporte de exibição, com introdução de múltiplas cores ou volta completa em cor única.

2. Modo de Anúncio Comercial Puro da Marca (Modo "Sem Shopee" – Anúncio de Marca Premium)

• A menos que o usuário solicite explicitamente a marcação com Shopee, o padrão é o modo de anúncio de imagem oficial da marca pura.
• Na cápsula superior, legenda inferior, botão CTA de compra, narração e caption.txt é proibido usar qualquer menção a "Shopee"; use padronizadamente: "Edição Limitada Exclusiva / Disponível", "Clique abaixo para Explorar / Comprar".

---

II. Passo 1: Captura de Imagens Autênticas, Pré-processamento Otimizado para IA e Dupla Verificação

1. Capturar imagens originais em alta qualidade e verificar características:
   • Registrar a marca real (FANTINI, ESPNER etc.), modelo, preço, cores disponíveis e detalhes característicos.
2. Preparar imagens de referência amigáveis para IA (Pré-processamento):
   • Usar scripts/preprocess_ai_ref.py para remover bordas promocionais da imagem principal, centralizá-la e gerar uma imagem RGB limpa de fundo neutro em 1024×1024 (*_gemini_studio.jpg ou *_gemini_hero.jpg), evitando que a IA identifique dimensões distorcidas.
3. Dupla Verificação (Prevenir correspondência errada + tela preta):
   • Usar read_file para inspecionar visualmente a imagem de referência, confirmando 100% de correspondência com o produto real.
   • Executar scripts/validate_assets.py para confirmar que a imagem está no modo RGB (proibido usar RGBA com fundo transparente diretamente).

---

III. Passo 2: Normas de Geração com Motor Duplo Gemini (Veo) e Google Flow (Omni 1.1 Flash)

1. Prevenção de Contaminação de Cache em Conversas Múltiplas do Gemini (Regra de Isolamento de Sessão)

• Ao trocar de produto, inicie uma Nova Conversa (New Chat) no Gemini App para evitar que o cache do servidor use imagens do produto anterior por engano.
• Após o download do vídeo, extraia quadros imediatamente com ffmpeg e inspecione visualmente com read_file . Se o design estiver contaminado pela conversa antiga ou detalhes não corresponderem, regenere imediatamente no Google Flow.

2. Controle Preciso de Duração Mínima no Google Flow para Economia de Pontos + Asset Chips

• S3 3D Turntable de 360° no Final (Obrigatório usar Google Flow):
  • Após fazer upload da imagem autêntica, clique em "Adicionar Mídia à Caixa de Prompt" abaixo da entrada de prompt, marque a imagem autêntica e insira-a como etiqueta condicional (Asset Chips).
  • Defina a duração mínima (5 segundos) para economizar pontos; na pós-produção, use FFmpeg setpts para suavizar em câmera lenta até a duração necessária da narração.
• Transição Sem Costura quando a cota do Gemini acabar ou precisar de close-ups precisos:
  • Se o Gemini atingir o limite de 3 vídeos por rodada (resfriamento de 5 horas), S1/S2 podem ser gerados diretamente pelo Google Flow sem espera.

---

IV. Passo 3: Narração Masculina Estável e Compactação Dupla com FFmpeg "Sem Corte e Sem Congelamento"

Script de compressão automatizada padrão: scripts/render_video_template.py

1. Padrão de Narração (Sem corte de áudio):
   • Usar uniformemente edge-tts com voz masculina estável de Taiwan: zh-TW-YunJheNeural (rate="-1%", pitch="-2Hz").
   • Removido o limite rígido de 24 segundos: a duração do parágrafo é determinada dinamicamente pelo comprimento da frase completa (target_dur = audio_dur + 0.8s, incluindo adelay=350|350 e espaço para respiração no final da frase). Proibido usar atrim para cortar a narração.
2. Extensão Suave de Quadros (Proibido Quadro Congelado - Zero Freeze Frame):
   • Proibido usar tpad=stop_mode=clone para congelar no quadro final!
   • Quando a duração do vídeo original (ex.: 5s ou 8s) for menor que a duração alvo do parágrafo, usar setpts=(seg_dur/v_dur)*PTS para extensão suave em câmera lenta dinâmica, ou combinar com suave aproximação (zoom in) para garantir movimento contínuo da câmera.
   • Especificações de saída obrigatórias: 1080x1920, -r 30 (30.0 fps CFR - taxa de quadros constante), libx264, yuv420p.
3. Produção Síncrona de Duas Versões (Versão Multicor + Versão 360° Giratória em Cor Única):
   • final.mp4: S1 + S2 + S3 (cartão de transição entre múltiplas cores).
   • final_single_color.mp4: S1 + S2 + S3 (cartão de exibição giratória 360° em cor única principal).
4. Inspeção Visual do Produto Finalizado:
   • Extrair final_check_s1.jpg, final_check_s2.jpg, final_check_s3.jpg e inspecionar visualmente com read_file.

---

V. Passo 4: Entrega do Pacote de 7 Arquivos na Lista Branca do Google Drive

1. Lista Padrão de 7 Arquivos:
   • final.mp4 (versão de apresentação multicor)
   • final_single_color.mp4 (versão giratória 360° em cor única)
   • cover.jpg (capa de alta qualidade 1080×1920)
   • caption.txt (legenda oficial para redes sociais com Hashtags, sem Shopee)
   • title.txt (título SEO)
   • product_url.txt (URL do produto)
   • qa.json (registro de aprovação no controle de qualidade)
2. Processo de Upload na Lista Branca:
   • Copiar os 7 arquivos para C:\Users\User\AppData\Local\Temp\<Product_ID>\.
   • No Google Drive, em 02_手機待發布, criar uma subpasta (<Número>_<Marca>_<Resumo do Produto>) e concluir o upload.