NoahYUYE/image-to-editable-ppt

Imagem para PPT Editável

Reconstrua a referência como objetos reais de slide. Prefira um resultado híbrido: objetos nativos do PowerPoint para texto e geometria, camadas de imagem transparentes para objetos renderizados complexos.

Skill complementar obrigatório

Leia e siga o skill de apresentação/PPT disponível antes de começar. Use sua biblioteca PowerPoint, configuração de workspace, exportação, renderização e verificações de overflow. Se nenhum skill de apresentação estiver disponível, relate essa limitação em vez de inventar um fluxo de trabalho PPT não suportado.

Contrato padrão

A menos que o usuário diga o contrário:

• Crie um slide por imagem de referência.
• Corresponda à proporção de aspecto original com um tamanho de slide personalizado.
• Preserve o layout, hierarquia, paleta, sombras, gradientes e direção visual.
• Torne texto, títulos, etiquetas, pills, setas, plataformas, linhas, anéis e geometria simples nativos e editáveis.
• Mantenha produtos complexos, pessoas, renderizações 3D e ilustrações detalhadas como elementos de imagem transparentes separados.
• Nomeie cada objeto claramente para o Painel de Seleção do PowerPoint.
• Traduza texto visível apenas quando solicitado; use linguagem natural voltada ao público e mantenha-o editável.
• Entregue apenas o PPTX final, a menos que outro artefato seja solicitado.

Não afirme que um objeto raster incorporado é internamente editável como vetor. Ele é editável apenas como imagem independente: mover, redimensionar, cortar, recolorir externamente ou substituir.

Fluxo de trabalho

1. Inspecione a referência

Veja a imagem em detalhe original. Registre suas dimensões em pixels e proporção de aspecto. Inventarie cada camada visível antes de começar:

1. fundo e textura decorativa;
2. conectores, setas, plataformas e geometria estrutural;
3. etiquetas numéricas, rótulos, títulos e texto corrido;
4. ícones simples;
5. objetos complexos ou renderizações;
6. efeitos de iluminação, sombras, brilhos e sobreposições.

Consulte references/reconstruction-playbook.md ao decidir como cada camada deve ser implementada.

2. Estabeleça o plano de editabilidade

Escolha a implementação por camada antes de construir:

• Caixas de texto nativas para todo o texto visível.
• Formas nativas para geometria simples e efeitos que o PowerPoint pode reproduzir de forma confiável.
• Linhas/conectores nativos para relacionamentos e setas quando prático.
• PNGs transparentes independentes para objetos complexos cujo redesenho interno reduziria a fidelidade.
• Apenas um fundo raster para textura que não seja significativamente editável; nunca inclua texto ou objetos de primeiro plano importantes nesse fundo.

Nunca use a imagem fonte completa como fundo de slide visível e cubra-a com duplicatas editáveis. Isso não é uma reconstrução genuinamente editável.

3. Prepare o workspace da tarefa

Siga as regras ativas de saída de arquivo. Para uma tarefa de projeto, use um diretório sob <project-root>/_codex/YYYYMMDD-task-slug/ com final/, working/ e _tmp/. Coloque recortes extraídos, prévias de renderização e evidências de QA em _tmp/; coloque apenas entregáveis finais em final/.

4. Extraia elementos complexos

Crie um JSON de regiões após identificar visualmente as caixas de corte, então execute:

python scripts/extract_regions.py \
  --input <referencia.png> \
  --regions <regioes.json> \
  --out <dir-assets-tmp>

Use mode: near-white apenas quando o recorte estiver cercado por um fundo branco ou quase branco. Use mode: preserve quando a remoção de transparência danificaria o objeto. Inspecione cada ativo extraído em tamanho real e ajuste as caixas de corte para remover linhas, plataformas, texto ou setas vizinhas.

O script é apenas para recorte e máscara de transparência. Não use Python para redesenhar visuais de apresentação.

5. Reconstrua na ordem de trás para frente

Crie camadas nesta ordem:

1. fundo do slide e textura decorativa sutil;
2. setas e conectores;
3. plataformas e formas estruturais grandes;
4. linhas-guia e etiquetas numéricas;
5. caixas de texto e pills;
6. elementos de imagem extraídos;
7. acentos de primeiro plano.

Use o sistema de coordenadas de pixels da fonte como sistema de coordenadas do slide quando a biblioteca de apresentação suportar unidades de pixel. Isso torna o posicionamento previsível e preserva a proporção original.

Mantenha cada item significativo separado. Para estruturas repetidas, use nomes consistentes, como Ícone de transporte Stage 2, Rótulo de transporte Stage 2 e Plataforma Stage 2 topo.

6. Reconstrua e localize texto

Transcreva cada elemento de texto visível. Preserve a hierarquia em vez de preservar cegamente o tamanho da fonte. Use fontes condensadas apenas quando necessário para caber na largura original. Mantenha títulos em uma linha quando o design exigir.

Para tradução:

• preserve o significado de negócios;
• prefira inglês de apresentação natural em vez de tradução palavra por palavra;
• mantenha a terminologia consistente em todo o slide;
• verifique ortografia, capitalização, separadores e quebras de linha após a renderização.

7. Valide em três visualizações

Sempre realize as três verificações:

1. inspecione a imagem fonte em detalhe original;
2. exporte e inspecione a prévia da biblioteca de apresentação;
3. renderize o PPTX final com o renderizador do skill de apresentação e inspecione o resultado em tamanho real.

Execute o teste de overflow do skill de apresentação. Corrija qualquer overflow não intencional, sobreposição, corte, quebra de texto, glifo ausente, artefato de recorte ou ícone deslocado. Não trate a prévia programática como prova suficiente porque a renderização do PowerPoint pode diferir.

Use references/reconstruction-playbook.md para a lista de verificação final de QA e compensações de fidelidade.

8. Entregue com transparência

Retorne o PPTX final e informe:

• quais famílias de elementos são nativas e totalmente editáveis;
• quais elementos permanecem como imagens raster independentes;
• se a proporção de aspecto original foi preservada;
• se as verificações de overflow e de renderização final foram aprovadas.

Não superestime a fidelidade. Descreva a reconstrução como aproximada quando fontes exatas, vetores fonte ou arquivos de design em camadas não estiverem disponíveis.