NoahYUYE/image-to-editable-ppt

Imagen a PPT Editable

Reconstruye la referencia como objetos reales de diapositiva. Favorece un resultado híbrido: objetos nativos de PowerPoint para texto y geometría, capas de imagen transparentes para objetos renderizados complejos.

Habilidad complementaria requerida

Lee y sigue la habilidad de presentación/PPT disponible antes de crear. Usa su biblioteca de PowerPoint requerida, configuración del espacio de trabajo, exportación, renderizado y comprobaciones de desbordamiento. Si no hay una habilidad de presentación disponible, informa de esa limitación en lugar de inventar un flujo de trabajo PPT no compatible.

Contrato predeterminado

A menos que el usuario indique lo contrario:

• Crea una diapositiva por imagen de referencia.
• Coincide con la relación de aspecto de la fuente usando un tamaño de diapositiva personalizado.
• Preserva el diseño, la jerarquía, la paleta, las sombras, los degradados y la dirección visual.
• Haz que el texto, los encabezados, las insignias, las píldoras, las flechas, las plataformas, las líneas, los anillos y la geometría simple sean nativos y editables.
• Mantén productos complejos, personas, renders 3D e ilustraciones detalladas como elementos de imagen transparentes separados.
• Nombra cada objeto claramente para el Panel de selección de PowerPoint.
• Traduce el texto visible solo cuando se solicite; usa un lenguaje natural orientado a la audiencia y mantenlo editable.
• Entrega solo el PPTX final a menos que se solicite otro artefacto.

No afirmes que un objeto rasterizado incrustado es internamente editable como vector. Solo es editable como imagen independiente: mover, redimensionar, recortar, recolorear externamente o reemplazar.

Flujo de trabajo

1. Inspecciona la referencia

Visualiza la imagen en detalle original. Registra sus dimensiones en píxeles y relación de aspecto. Inventaría cada capa visible antes de crear:

1. fondo y textura decorativa;
2. conectores, flechas, plataformas y geometría estructural;
3. insignias numéricas, etiquetas, títulos y cuerpo de texto;
4. iconos simples;
5. objetos complejos o renders;
6. efectos de iluminación, sombras, brillos y superposiciones.

Lee references/reconstruction-playbook.md al elegir cómo implementar cada capa.

2. Establece el plan de editabilidad

Elige la implementación por capa antes de construir:

• Cuadros de texto nativos para todo el texto visible.
• Formas nativas para geometría simple y efectos que PowerPoint pueda reproducir de forma fiable.
• Líneas/conectores nativos para relaciones y flechas cuando sea práctico.
• PNGs transparentes independientes para objetos complejos cuyo redibujo interno reduciría la fidelidad.
• Un fondo rasterizado único solo para textura que no sea significativamente editable; nunca incluyas texto ni objetos principales en primer plano en ese fondo.

Nunca uses la imagen fuente completa como fondo visible de la diapositiva y la cubras con duplicados editables. Eso no es una reconstrucción genuinamente editable.

3. Prepara el espacio de trabajo de la tarea

Sigue las reglas activas de salida de archivos. Para una tarea de proyecto, usa un directorio bajo <project-root>/_codex/YYYYMMDD-task-slug/ con final/, working/ y _tmp/. Coloca recortes extraídos, vistas previas renderizadas y evidencia de QA en _tmp/; coloca solo los entregables finales en final/.

4. Extrae elementos complejos

Crea un JSON de región después de identificar visualmente los cuadros de recorte, luego ejecuta:

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

Usa mode: near-white solo cuando el recorte esté rodeado por un fondo blanco o casi blanco. Usa mode: preserve cuando la eliminación de transparencia dañaría el objeto. Inspecciona cada recurso extraído a tamaño completo y ajusta los cuadros de recorte para eliminar líneas, plataformas, texto o flechas vecinos.

El script es solo para recortar y enmascarar transparencia. No uses Python para redibujar visuales de presentación.

5. Reconstruye en orden de atrás hacia adelante

Crea las capas en este orden:

1. fondo de diapositiva y textura decorativa sutil;
2. flechas y conectores;
3. plataformas y formas estructurales grandes;
4. líneas guía e insignias numéricas;
5. cuadros de texto y píldoras;
6. elementos de imagen extraídos;
7. acentos de primer plano.

Usa el sistema de coordenadas de píxeles de la fuente como sistema de coordenadas de la diapositiva cuando la biblioteca de presentación admita unidades de píxel. Esto hace que la colocación sea predecible y preserva la relación original.

Mantén cada elemento significativo separado. Para estructuras repetidas, usa nombres consistentes como Icono de transporte Etapa 2, Etiqueta de transporte Etapa 2 y Plataforma superior Etapa 2.

6. Reconstruye y localiza el texto

Transcribe cada elemento de texto visible. Preserva la jerarquía en lugar de preservar ciegamente el tamaño de la fuente. Usa fuentes condensadas solo cuando sea necesario para ajustarse al ancho original. Mantén los encabezados en una línea cuando el diseño lo requiera.

Para la traducción:

• preserva el significado comercial;
• prefiere el lenguaje natural orientado a la audiencia sobre la traducción palabra por palabra;
• mantén la terminología consistente en toda la diapositiva;
• verifica la ortografía, mayúsculas, separadores y saltos de línea después del renderizado.

7. Valida en tres vistas

Siempre realiza las tres comprobaciones:

1. inspecciona la imagen fuente en detalle original;
2. exporta e inspecciona la vista previa de la biblioteca de presentación;
3. renderiza el PPTX final con el renderizador de la habilidad de presentación e inspecciona ese resultado a tamaño completo.

Ejecuta la prueba de desbordamiento de la habilidad de presentación. Corrige cualquier desbordamiento no deseado, superposición, recorte, ajuste de texto, glifo faltante, artefacto de recorte o icono desplazado. No trates la vista previa programática como prueba suficiente porque el renderizado de PowerPoint puede diferir.

Usa references/reconstruction-playbook.md para la lista de verificación final de QA y las compensaciones de fidelidad.

8. Entrega de forma transparente

Devuelve el PPTX final y declara:

• qué familias de elementos son nativas y totalmente editables;
• qué elementos permanecen como imágenes rasterizadas independientes;
• si se preservó la relación de aspecto de la fuente;
• si las comprobaciones de desbordamiento y renderizado final se superaron.

No sobreestimes la fidelidad. Describe la reconstrucción como aproximada cuando no estén disponibles las fuentes exactas, vectores fuente o archivos de diseño en capas.