Que fait slidepatch ?
Utilisez les scripts fournis avec cette compétence. Résolvez leurs chemins relatifs par rapport à ce fichier, quel que soit le répertoire de travail de l'agent hôte. L'hôte doit être capable d'exécuter des commandes locales et d'afficher des images ; cette compétence ne possède pas d'API spécifiques à DSH ni de clés d'API de modèle.
Pour une nouvelle installation, exécutez python <compétence>/scripts/slidepatch.py doctor (ajoutez --charts pour la migration de graphiques ou --equations pour la conversion d'équations). Cette commande vérifie les dépendances et l'enregistrement Office sans ouvrir les applications. Un résultat "prêt" ne remplace pas une vérification native.
Conversion d'équations natives
Pour les demandes de conversion de texte de formule autonome, d'images ou d'équations MathType/OLE en équations PowerPoint natives, utilisez inspect-equations et convert-equations. Lisez references/equations.md pour le plan, la transcription et le contrat de vérification. Ce mode nécessite Pandoc en plus de Windows/PowerPoint ; les autres modes ne nécessitent pas Pandoc. Il préserve la disposition du diaporama, le nombre de pages et les objets non spécifiés, n'utilise pas de modèle, et ne reconvertit pas les équations natives existantes. Les objets LaTeX explicites complets produisent des candidats ; l'Agent examine et transcrit les images et les aperçus OLE mis en cache sans activer OLE ni analyser les binaires MathType. Laissez les objets peu clairs intacts et signalez-les. La migration de modèle rejette actuellement les équations natives pour éviter la perte de structure mathématique ; ne considérez pas la conversion comme un support automatique pour la migration des équations résultantes.
Migration et pagination complètes du diaporama
Pour une demande de migration de l'intégralité de la présentation ou d'autorisation de pagination, préférez migrate. Lisez references/batch.md pour le contrat de couverture et le format des preuves.
python <compétence>/scripts/slidepatch.py migrate <source.pptx> --template <modèle.pptx> --output <nouveau-sortie.pptx> --evidence <répertoire-de-preuves-nouveau>
Le moteur visite chaque diapositive source dans l'ordre. Il identifie les pages de couverture, de sommaire, de section numérotée et de contenu ordinaire ; préfère le type de page de modèle correspondant ; et réutilise les arrière-plans, graphiques et mises en page natifs du modèle. Une page de sommaire peut utiliser un style de page de contenu lorsqu'il n'existe pas de modèle de sommaire dédié. Vérifiez la classification et le repli dans plan.json ; il s'agit d'une inférence géométrique/typographique, pas d'une compréhension d'image sans restriction.
Préservez la famille, la taille, le poids et la couleur de la police du modèle. Les mesures de texte natives déterminent la capacité. Gardez les groupes complets ensemble lorsque c'est possible ; équilibrez le volume de texte entre les partitions de page de groupe entier les plus courtes. Si un seul groupe est trop grand, divisez-le aux limites d'objet corps, de paragraphe ou de phrase, en préservant les tranches de caractères exactes. Les pages de continuation de groupe surdimensionné alignent le contenu en haut. Les titres, en-têtes de groupe et pieds de page se répètent comme contexte explicite ; les tranches de corps doivent reconstruire la source exactement une fois et dans l'ordre. Ne réécrivez jamais les numéros sources et ne renumérotez pas silencieusement une table des matières. Une phrase qui ne peut pas tenir sans modifier la typographie du modèle entraîne l'échec de l'ensemble de l'opération.
Ce mode prend en charge le texte éditable ordinaire, les espaces réservés de texte source pris en charge et les images incorporées/graphiques natifs avec une structure claire. Les limites des espaces réservés sources sont dans references/plan.md. Pour les pages média, lisez references/media.md : les images et leurs rognages restent natifs, les graphiques conservent leurs classeurs incorporés, et les légendes associées restent avec leurs éléments lors de la mise en page et de la pagination. Les pages média utilisent des modèles de contenu. Les décorations non textuelles, les espaces réservés non pris en charge, les groupes, les animations, les liens externes et les structures ambiguës restent non pris en charge. L'échec sur une page empêche la publication de l'ensemble du résultat ; ne livrez jamais un diaporama partiel. Chaque page générée est rouverte, rendue, vérifiée par rapport à la police/arrière-plan de son modèle, et effectivement éditée et sauvegardée dans une copie de preuve séparée. La sortie est publiée uniquement après la réussite de toutes les vérifications de page, de texte et de média.
Examinez chaque after-N.png, en particulier les titres de couverture/section, le repli de la page de sommaire et les limites de pagination. Lisez les vérifications par page et la liste des pages éditables dans report.json. Livrez le PPTX vérifié, l'aperçu et un court résumé source-sortie des pages. Indiquez que le contexte répété est intentionnel lorsque les pages ont été divisées. Les originaux restent inchangés.
Mode même fichier (plan v1)
- L'entrée est un
.pptxexistant ; la source et la référence sont des diapositives différentes de ce fichier avec la même conception et la même mise en page et des graphiques de masque cachés. - Source : formes ordinaires, lignes et zones de texte horizontales. Référence : ces formes plus des images décoratives. Pas de groupes, espaces réservés, graphiques, SmartArt, animations, transitions, liens hypertexte ou objets pivotés sur l'une ou l'autre diapositive sélectionnée.
- Chaque objet texte source correspond exactement à un objet texte de référence, et vice versa. Les formes non textuelles de la source doivent être explicitement identifiées comme décorations à remplacer. Arrêtez-vous pour clarification si un objet pourrait contenir une preuve visuelle significative.
- L'opération remplace les objets locaux de la diapositive source par des copies natives des objets de référence et les remplit avec les chaînes source exactes. Elle adopte la typographie de la référence, y compris les changements d'emphase ; elle ne promet pas la préservation du formatage des caractères de la source.
- Pas de résumé de contenu, de fractionnement de page, de réduction automatique de police ou de reconstruction image-à-éditable. Si les diapositives sélectionnées ne correspondent pas à ces limites, expliquez la limitation spécifique au lieu de reconstruire le diaporama via un outil non lié.
Mode modèle séparé (plan v2)
Utilisez apply-template pour une diapositive source et un modèle dans des fichiers PPTX séparés. Ce mode produit une nouvelle diapositive dans les dimensions du modèle ; il ne réécrit pas le diaporama source et n'inclut pas les autres diapositives du modèle. Choisissez le v1 lorsque l'utilisateur demande de préserver les autres diapositives du diaporama source.
Inspectez les deux fichiers, y compris les graphiques de masque/mise en page hérités désormais listés sous inheritance. Visualisez les aperçus réels et choisissez une page de contenu plutôt que de supposer que la diapositive 2 est un modèle approprié. Préservez l'image de marque et les décorations. Classez explicitement chaque objet de modèle local comme décoration conservée ou contenu d'exemple supprimé ; ne conservez pas de photos de modèle non liées comme preuve du contenu source.
Créez un placement par objet texte source. Un placement nomme une forme de texte ordinaire du modèle comme donneur de style et donne des limites en points. Le même donneur peut servir plusieurs placements, donc les nombres de textes source et modèle peuvent différer. Le moteur duplique les objets natifs à l'intérieur du modèle, préservant sa mise en page/masque et son thème. Le texte provient directement de la source ; les plans ne contiennent pas de chaînes de remplacement. La réduction de police et la réécriture de contenu restent non prises en charge.
Les restrictions source du v1 s'appliquent, sauf que le v2 accepte également les espaces réservés de texte source pris en charge. Les emplacements de texte sûrs vides sont explicitement enregistrés comme supprimés ; le texte source hérité actif provoque un rejet plutôt que d'être silencieusement omis. Les donneurs de style doivent être des formes de texte horizontales non pivotées ordinaires, pas des espaces réservés/groupes. Les décorations de mise en page/masque du modèle restent natives, y compris les images héritées et les espaces réservés de mise en page inutilisés. Les décorations locales conservées ne doivent pas avoir de texte. Les plans enregistrent les objets supprimés ; la planification automatique peut proposer ces décisions, tandis que l'Agent examine leur signification.
Mise en page automatique (préférée pour les modèles séparés)
Pour une source de texte uniquement avec un titre et un corps de texte clairs, y compris les espaces réservés de texte source pris en charge, exécutez d'abord :
python <compétence>/scripts/slidepatch.py plan-template <source.pptx> --template <modèle.pptx> --source-slide 1 --out <répertoire-de-planification-nouveau>
Ceci génère un plan.json v2 normal sans page cible, ID de forme ou coordonnées fournis manuellement. selection.json enregistre les rôles source inférés, les pages de modèle candidates, les décisions de décoration basées sur la géométrie, les mises en page candidates, les mesures d'ajustement et les raisons de rejet. Le statut planned signifie qu'un plan existe, pas qu'un PPTX a passé la vérification finale.
Le planificateur utilise la hiérarchie des polices et la proximité spatiale pour associer les titres et les corps ; il n'utilise pas les noms de formes ou les numéros de page du modèle. Il nécessite un titre supérieur distinct, reconnaît les pieds de page inférieurs en petite police, et prend en charge les lignes/colonnes groupées ou les paragraphes sans titre. Il recherche les mises en page ligne, empilée, deux colonnes et trois colonnes, en utilisant les limites de texte natives de PowerPoint avec les tailles de police d'origine du modèle. Le texte est renvoyé à la ligne ; aucune réécriture de chaîne ni réduction de police ne se produit. Les boîtes candidates ne doivent pas se chevaucher entre elles ni avec les décorations conservées. Les arrière-plans pleine page et les espaces réservés de mise en page inutilisés sont exclus des vérifications d'obstacle.
Lisez selection.json, visualisez source.png et les template-N.png sélectionnés, et vérifiez que les associations de rôles et la suppression d'images d'exemple ont du sens. La classification automatique des images utilise la géométrie et les légendes à proximité, pas la compréhension d'image. Ne prétendez pas à une correspondance sémantique universelle. Pour un résultat non ambigu, passez directement à apply-template avec le plan généré, puis examinez le résultat rendu. L'utilisateur n'a pas besoin de fournir de coordonnées ou d'approuver les choix de routine déjà couverts par sa demande.
Si la planification d'une seule page rejette des rôles ambigus, des décorations incertaines, des objets non pris en charge ou un contenu surcapacité, lisez la raison enregistrée. Lorsque la pagination est autorisée, utilisez migrate. Sinon, inspectez les objets réels avant d'utiliser un plan v2 explicite examiné. N'omettez jamais silencieusement du contenu, ne réduisez pas les polices et ne modifiez pas la portée de page autorisée. Les sources avec des images, des décorations non textuelles, une hiérarchie mixte/peu claire, des graphiques ou des groupes nécessitent toujours un workflow explicite ou non pris en charge.
Exécution
Installez requirements.txt dans un environnement virtuel Python 3.10+. Utilisez cet interpréteur pour chaque commande. PowerPoint de bureau doit être utilisable dans la session Windows connectée. Inspectez d'abord :
python <compétence>/scripts/slidepatch.py inspect <source.pptx> --out <répertoire-d-inspection-nouveau>
Lisez inventory.json et visualisez les aperçus slide-N.png pertinents. Faites correspondre les rôles de contenu en utilisant les objets réels et l'apparence. N'inférez jamais les ID de forme à partir de leur ordre et ne reconstruisez pas le texte protégé de mémoire.
Pour le mode même fichier, créez un plan JSON en utilisant le schéma dans references/plan.md. Pour les modèles séparés, préférez plan-template ; utilisez un plan v2 examiné manuellement lorsque l'inférence automatique ne convient pas. Copiez les hachages et les ID à partir des inventaires actuels. Préservez la portée prévue par l'utilisateur. Une demande claire autorisée avec un mappage non ambigu peut procéder ; ne demandez que lorsqu'une ambiguïté de contenu matérielle ne peut pas être résolue à partir des fichiers.
python <compétence>/scripts/slidepatch.py apply <source.pptx> --plan <plan.json> --output <nouveau-sortie.pptx> --evidence <répertoire-de-preuves-nouveau>
Pour un modèle séparé, inspectez-le également, puis utilisez un plan v2 :
python <compétence>/scripts/slidepatch.py inspect <modèle.pptx> --out <inspection-modèle-nouveau>
python <compétence>/scripts/slidepatch.py apply-template <source.pptx> --template <modèle.pptx> --plan <plan-v2.json> --output <nouveau-sortie.pptx> --evidence <répertoire-de-preuves-nouveau>
Le moteur prépare le diaporama édité, le rouvre et le rend dans PowerPoint, compare les objets texte exacts et les nombres, vérifie les diapositives non cibles, et teste une véritable édition de texte et un déplacement de forme sur une copie de preuve séparée. Il publie la sortie uniquement après la réussite de ces vérifications. Il n'appelle jamais PowerPoint Quit et ne ferme pas de présentations non liées. Le copier-coller natif utilise le presse-papiers système.
Le mode modèle vérifie plutôt le résultat d'une diapositive, les deux hachages d'origine, toutes les chaînes source locales, les objets natifs sauvegardés et les couches de décoration rendues identiques avant/après. Les débordements décoratifs existants sont autorisés ; le nouveau contenu doit tenir. Il utilise Duplicate natif sans le presse-papiers. Le PPTX peut encore contenir des mises en page, des masques ou des médias de modèle inutilisés ; ce prototype n'assainit pas les éléments de package cachés.
Révision et livraison
Lisez report.json ; le code de sortie et le rapport doivent tous deux indiquer un succès. Visualisez before-<source>.png, before-<reference>.png et after-<source>.png. Vérifiez que le style correspond et qu'il n'y a pas de coupure, de chevauchement involontaire ou d'ordre de lecture incorrect. Les vérifications géométriques ne remplacent pas la révision visuelle.
Pour le mode modèle, visualisez source-before.png, template-before.png, after-1.png, plus template-shell.png et output-shell.png. Vérifiez la nouvelle composition par rapport au langage visuel du modèle ; une simple correspondance des chaînes de texte ne suffit pas.
Livrez le nouveau PPTX avec un aperçu et un résumé concis des vérifications et de la portée. editability-proof.pptx contient délibérément un marqueur d'édition et est une preuve, pas le livrable final. Si une vérification échoue, signalez le problème ; ne présentez jamais un fichier préparé ou de preuve comme le diaporama final. Choisissez des chemins frais lors des nouvelles tentatives, en gardant les preuves d'échec disponibles.