Chat Motion Overlay

Transforme o conteúdo do chat em um clipe de sobreposição de movimento configurável, em vez de um único WeChat mock codificado.

Fluxo de Trabalho

1. Normalize a entrada do chat.

   • Se o usuário fornecer uma captura de tela, extraia as mensagens visíveis para o formato de transcrição em references/input-format.md.
   • Se o usuário fornecer texto simples, mantenha uma mensagem por batida e preserve a redação exata quando a autenticidade for importante.
   • Para capturas de tela, use avatares visíveis como pistas para a contagem de participantes e agrupamento de mensagens, mas não corte ou recrie imagens de avatar por padrão. Infira participantes e lados, em seguida, renderize com avatares predefinidos, a menos que o usuário forneça arquivos de avatar ou solicite explicitamente avatares derivados de capturas de tela.

2. Escolha uma configuração de cena.

   • Leia references/config-schema.md.
   • Decida o estilo do contêiner, modo de avatar, moldura do dispositivo, modo de apelido e formato de entrega antes de gerar o pacote.
   • Quando o usuário não fornecer informações suficientes, siga a política de perguntas em references/question-strategy.md.

3. Construa a especificação da cena.

   • Execute scripts/build_chat_overlay_spec.py com uma transcrição e um JSON de configuração opcional.
   • O script gera uma única especificação JSON que o Remotion pode renderizar diretamente.

4. Prepare um pacote renderizável.

   • Execute scripts/prepare_chat_overlay_bundle.py.
   • Ele copia o modelo Remotion, injeta src/chatSpec.ts e copia quaisquer arquivos de avatar carregados para public/.

5. Renderize a saída alvo.

   • Use os comandos de exportação exatos em references/output-modes.md.
   • Prefira MOV（透明背景，可直接导入剪映 / PR / FCP 叠加） para edição, WebM（透明背景，适合网页 / 浏览器播放） para navegadores e saídas de engenharia editáveis quando o usuário quiser continuar compondo downstream.

Dimensões Suportadas

• container: none, wechat, telegram, messenger
• avatarMode: preset, upload, mixed
• deviceFrame: none, iphone-dynamic-island
• nicknameMode: hidden, first-message-only, always
• deliveryFormat:
  • mov: MOV（透明背景，可直接导入剪映 / PR / FCP 叠加）
  • webm: WebM（透明背景，适合网页 / 浏览器播放）
  • remotion: Remotion 工程（适合继续编辑和拼装）
  • hyperframe: Hyperframe 工程（适合作为模块继续复用）
  • json: JSON 数据（适合程序处理 / 自定义渲染）
  • preview: 预览图 / 预览工程（适合先确认效果）

Regras de Saída

• Mantenha a raiz da composição transparente para saídas de sobreposição.
• Use container: none para movimento de bolha autônomo sem um shell de aplicativo.
• Use container: wechat|telegram|messenger quando o chrome da plataforma fizer parte da história.
• Trate os avatares carregados como ativos de conteúdo e copie-os para public/ para o pacote de renderização.
• Prefira avatares predefinidos quando o usuário não especificar arquivos de avatar. Avatares de captura de tela podem ajudar a identificar participantes, mas recomende arquivos de avatar fornecidos pelo usuário antes de tentar cortar ou recriar avatares de capturas de tela.
• Mantenha o comportamento controlado por configuração explícito; não altere silenciosamente as famílias de estilos.

Política de Perguntas

• Prefira inferência primeiro, perguntas depois.
• Se o usuário fornecer informações suficientes para um padrão sensato, continue e declare claramente as suposições.
• Pergunte apenas sobre escolhas de alto impacto ausentes.
• Mantenha o conjunto de perguntas em 1-3 itens.
• Prefira linguagem voltada para o usuário em vez de linguagem técnica.
• Pergunte sobre deliveryFormat usando rótulos 格式（场景描述）, não termos de renderização internos.
• Se o usuário disser que não se importa, continue com os padrões e anote-os no resultado.

Recursos

• Formato de transcrição: references/input-format.md
• Campos de configuração e exemplos: references/config-schema.md
• Estratégia de perguntas: references/question-strategy.md
• Comandos e destinos de saída: references/output-modes.md
• Transcrição/configuração para especificação: scripts/build_chat_overlay_spec.py
• Preparação do pacote Remotion: scripts/prepare_chat_overlay_bundle.py
• Modelo de renderização Remotion: assets/remotion-template/