NoahYUYE/image-to-editable-ppt

Image vers PPT modifiable

Reconstruire la référence en tant qu'objets réels de diapositive. Privilégier un résultat hybride : objets PowerPoint natifs pour le texte et la géométrie, couches d'images transparentes pour les objets complexes rendus.

Compétence complémentaire requise

Lire et suivre la compétence disponible concernant les présentations/PPT avant de rédiger. Utiliser sa bibliothèque PowerPoint, la configuration de l'espace de travail, l'exportation, le rendu et les vérifications de débordement. Si aucune compétence de présentation n'est disponible, signaler cette limitation au lieu d'inventer un flux de travail PPT non pris en charge.

Contrat par défaut

Sauf indication contraire de l'utilisateur :

• Créer une diapositive par image de référence.
• Adapter le rapport hauteur/largeur de la source avec une taille de diapositive personnalisée.
• Conserver la mise en page, la hiérarchie, la palette, les ombres, les dégradés et la direction visuelle.
• Rendre le texte, les titres, les badges, les pilules, les flèches, les plateformes, les lignes, les anneaux et la géométrie simple natifs et modifiables.
• Conserver les produits complexes, les personnes, les rendus 3D et les illustrations détaillées en tant qu'éléments d'image transparents séparés.
• Nommer chaque objet clairement pour le volet Sélection de PowerPoint.
• Traduire le texte visible uniquement sur demande ; utiliser un langage naturel adapté au public et le conserver modifiable.
• Livrer uniquement le fichier PPTX final, sauf si un autre artefact est demandé.

Ne pas prétendre qu'un objet matriciel intégré est vectoriel-modifiable en interne. Il est modifiable uniquement en tant qu'image indépendante : déplacer, redimensionner, recadrer, recolorer de manière externe ou remplacer.

Flux de travail

1. Inspecter la référence

Visualiser l'image en détail original. Enregistrer ses dimensions en pixels et son rapport hauteur/largeur. Inventorier chaque couche visible avant la rédaction :

1. arrière-plan et texture décorative ;
2. connecteurs, flèches, plateformes et géométrie structurelle ;
3. badges numérotés, étiquettes, titres et texte de corps ;
4. icônes simples ;
5. objets complexes ou rendus ;
6. effets d'éclairage, ombres, lueurs et incrustations.

Consulter references/reconstruction-playbook.md lors du choix de la manière d'implémenter chaque couche.

2. Établir le plan d'éditabilité

Choisir l'implémentation par couche avant de construire :

• Zones de texte natives pour toute copie visible.
• Formes natives pour la géométrie simple et les effets que PowerPoint peut reproduire de manière fiable.
• Lignes/connecteurs natifs pour les relations et flèches lorsque c'est pratique.
• PNG transparents indépendants pour les objets complexes dont le redessin interne réduirait la fidélité.
• Un seul arrière-plan matriciel uniquement pour la texture qui n'est pas vraiment modifiable ; ne jamais inclure de texte ou d'objets de premier plan majeurs dans cet arrière-plan.

Ne jamais utiliser l'image source complète comme arrière-plan visible de la diapositive et la recouvrir de doublons modifiables. Cela ne constitue pas une reconstruction véritablement modifiable.

3. Préparer l'espace de travail de la tâche

Suivre les règles actives de sortie de fichiers. Pour une tâche de projet, utiliser un répertoire sous <project-root>/_codex/YYYYMMDD-task-slug/ avec final/, working/ et _tmp/. Placer les recadrages extraits, les aperçus de rendu et les preuves d'assurance qualité dans _tmp/ ; placer uniquement les livrables finaux dans final/.

4. Extraire les éléments complexes

Créer un JSON de région après avoir identifié visuellement les boîtes de recadrage, puis exécuter :

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

Utiliser mode: near-white uniquement lorsque le recadrage est entouré d'un fond blanc ou presque blanc. Utiliser mode: preserve lorsque la suppression de la transparence endommagerait l'objet. Inspecter chaque élément extrait en taille réelle et resserrer les boîtes de recadrage pour supprimer les lignes, plateformes, texte ou flèches voisins.

Le script est destiné uniquement au recadrage et au masquage de transparence. Ne pas utiliser Python pour redessiner des visuels de présentation.

5. Reconstruire dans l'ordre arrière-avant

Créer les couches dans cet ordre :

1. arrière-plan de la diapositive et texture décorative subtile ;
2. flèches et connecteurs ;
3. plateformes et grandes formes structurelles ;
4. lignes de guidage et badges numérotés ;
5. zones de texte et pilules ;
6. éléments d'image extraits ;
7. accents de premier plan.

Utiliser le système de coordonnées en pixels de la source comme système de coordonnées de la diapositive lorsque la bibliothèque de présentation prend en charge les unités en pixels. Cela rend le placement prévisible et préserve le rapport d'origine.

Garder chaque élément significatif séparé. Pour les structures répétées, utiliser une dénomination cohérente comme Icône de transport étape 2, Étiquette de transport étape 2 et Plateforme supérieure étape 2.

6. Reconstruire et localiser le texte

Transcrire chaque élément de texte visible. Préserver la hiérarchie plutôt que de préserver aveuglément la taille de police. Utiliser des polices condensées uniquement lorsque cela est nécessaire pour correspondre à la largeur d'origine. Conserver les titres sur une seule ligne lorsque la conception l'exige.

Pour la traduction :

• préserver le sens métier ;
• préférer un anglais de présentation naturel plutôt qu'une traduction mot à mot ;
• maintenir une terminologie cohérente sur toute la diapositive ;
• vérifier l'orthographe, la capitalisation, les séparateurs et les sauts de ligne après le rendu.

7. Valider dans trois vues

Toujours effectuer les trois vérifications :

1. inspecter l'image source en détail original ;
2. exporter et inspecter l'aperçu de la bibliothèque de présentation ;
3. effectuer le rendu du PPTX final avec le moteur de rendu de la compétence de présentation et inspecter le résultat en taille réelle.

Exécuter le test de débordement de la compétence de présentation. Corriger tout débordement involontaire, chevauchement, rognage, habillage de texte, glyphe manquant, artefact de recadrage ou icône déplacée. Ne pas considérer l'aperçu programmatique comme suffisant, car le rendu PowerPoint peut différer.

Utiliser references/reconstruction-playbook.md pour la liste de contrôle d'assurance qualité finale et les compromis de fidélité.

8. Livrer de manière transparente

Retourner le PPTX final et indiquer :

• quelles familles d'éléments sont natives et entièrement modifiables ;
• quels éléments restent des images matricielles indépendantes ;
• si le rapport hauteur/largeur de la source a été préservé ;
• si les vérifications de débordement et de rendu final ont réussi.

Ne pas surestimer la fidélité. Décrire la reconstruction comme approximative lorsque les polices exactes, les vecteurs source ou les fichiers de conception en couches n'étaient pas disponibles.