Communitygithub.com

machengjie321/sous-titres-automatiques-powerpoint

Ajoutez des sous-titres minutés modifiables à un diaporama PowerPoint et exportez une vidéo MP4 à avancement automatique à l'aide de Microsoft PowerPoint sur Windows. Idéal pour les vidéos sous-titrées par diapositive, y compris les démonstrations silencieuses et les présentations de recherche.

Qu'est-ce que sous-titres-automatiques-powerpoint ?

Cette compétence transforme un fichier PPTX local en une présentation sous-titrée modifiable et une vidéo MP4, tout en préservant le fichier source intact. Contrairement aux solutions qui livrent seulement un fichier SRT ou des images aplaties, elle crée des sous-titres sous forme de zones de texte PowerPoint natives avec des effets d'entrée et de sortie. Elle est conçue pour les utilisateurs de Microsoft Windows avec PowerPoint installé, exploitant le modèle objet de PowerPoint via un script PowerShell pour automatiser la création des effets de fondu. Le flux de travail prend en charge plusieurs sources de sous-titres : texte par diapositive, document nommé, fichier de narration, ou génération automatique à partir du contenu du diaporama. La compétence gère le minutage des sous-titres via un fichier CSV de chronologie, ajuste la mise en page pour réserver une zone de sous-titres, et exporte le résultat final en PPTX, MP4, PDF et/ou PNG. Elle offre également un flux de travail par étapes avec relecture utilisateur, ou un processus en un seul passage pour les utilisateurs avancés. Les vérifications de qualité incluent l'inspection visuelle des diapositives et l'échantillonnage de la vidéo pour confirmer la synchronisation et la lisibilité.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/machengjie321/codex-PPTtoVideo-skills/tree/HEAD/powerpoint-auto-subtitles

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Sous-titres automatiques PowerPoint et vidéo

Transformez un PPTX local existant en une présentation sous-titrée modifiable et une vidéo. Conservez le fichier source intact. Les sous-titres sont des zones de texte PowerPoint natives avec des effets d'entrée et de sortie, et non des images de diapositives aplaties ou un simple fichier SRT.

Entrées et décisions

Identifiez un fichier PPTX source spécifique (chemin absolu existant, nom exact de la pièce jointe, ou fichier ouvert explicitement identifié), le répertoire de sortie, la politique de durée, la langue des sous-titres et la source des sous-titres avant la création. Les sources de sous-titres peuvent être un document nommé, un texte explicitement fourni par diapositive, un fichier de narration nommé, ou une demande explicite de rédaction à partir du diaporama. Vérifiez que les fichiers référencés existent et que les sous-titres correspondent à l'ordre réel des diapositives. Si le diaporama source ou la source des sous-titres reste ambigu dans la conversation, demandez uniquement cette information manquante ; ne sélectionnez pas un diaporama historique non lié et n'inventez pas de source de script. Un exemple de demande copié avec des chemins factices n'est pas un diaporama d'entrée réel.

Identifiez tout média réel à inclure. Réutilisez les ressources fournies et les valeurs mesurées. Si aucun audio n'est fourni, rédigez des sous-titres concis à partir du contenu de la diapositive ; ne décrivez pas cela comme une transcription vocale. Lorsqu'un audio existe, alignez les sous-titres sur la narration réelle.

Pour rédiger des sous-titres à partir des diapositives, accepter du texte par diapositive ou un document, et estimer le minutage à partir de la longueur du texte, consultez rédaction et minutage des sous-titres. Le script inclus scripts/captions-to-timeline.py convertit du Markdown/TXT normalisé en CSV d'animation avec des taux de lecture ajustables pour les mots anglais et les caractères chinois. Utilisez les minutages réels de la parole lorsqu'une narration existe.

Produisez une chronologie UTF-8 avant d'animer. Consultez le contrat de chronologie pour le schéma et les formules de minutage. La position d'une diapositive dans le fichier (slide_index) peut différer de son numéro de page imprimé (slide_number). Neuf diapositives ou 160 secondes ne sont pas une valeur par défaut universelle.

Réception axée sur les sous-titres

Prenez en charge deux chemins de préparation des sous-titres : (A) rédaction à partir du PPTX spécifié ; (B) normalisation des sous-titres fournis par l'utilisateur sans les réécrire. Pour le chemin B, préservez le libellé, l'ordre, les valeurs et les unités ; ne traduisez ou ne peaufinez que sur demande. Conservez les correspondances de pages non résolues et les modifications proposées qui changent le sens dans des notes de révision séparées. Les deux chemins peuvent converger vers une relecture, une édition et une confirmation par l'utilisateur avant la production lorsque ce flux de travail par étapes est demandé. Prenez en charge un flux de travail rédaction–édition–production : sur demande, lisez automatiquement le diaporama spécifié et enregistrez un brouillon standard de sous-titres par diapositive ainsi que des notes de révision séparées. N'exigez pas que l'utilisateur remplisse d'abord le modèle manuellement. Signalez le contenu illisible et les affirmations incertaines dans les notes de révision plutôt que d'inventer des sous-titres. Lorsque l'utilisateur demande une relecture manuelle avant la production, livrez le brouillon et attendez le fichier édité. Dans l'étape de production ultérieure, traitez ce fichier édité comme la source de vérité des sous-titres ; préservez son libellé, recalculez le minutage à partir de celui-ci, et ne l'écrasez pas avec un nouveau script dérivé du diaporama. Cette étape de relecture est une portée de flux de travail demandée, non une barrière obligatoire pour une exportation en un passage explicitement autorisée.

Commencez un nouveau flux de travail de sous-titres en aidant l'utilisateur à fournir des sous-titres au format standard par diapositive. Expliquez que ## Diapositive N identifie la diapositive PPTX réelle et que chaque ligne - est une réplique. Acceptez un fichier de sous-titres nommé ou un texte collé avec identification des diapositives. Normalisez les brouillons Word ou non structurés en un captions.md UTF-8 avant de calculer les minutages. Gardez les instructions visuelles et les tâches en dehors du texte des sous-titres. Vérifiez l'ordre des diapositives, les pages manquantes et les espaces réservés de modèle non remplacés. N'inventez pas de sous-titres manquants lorsque l'utilisateur a choisi un flux de travail avec script fourni ; ne rédigez à partir du diaporama que sur demande. Si l'utilisateur demande uniquement d'organiser le document de sous-titres, livrez ce document et la vérification de correspondance sans passer à l'animation/exportation. Réutilisez un fichier de sous-titres déjà valide au lieu de répéter la réception. Pour une demande de vidéo de bout en bout, la normalisation est une étape intermédiaire : continuez avec le minutage, l'animation native, l'exportation et l'assurance qualité de lecture réelle sans une étape d'approbation inutile. Arrêtez-vous après le document de sous-titres uniquement lorsque cette portée limitée est explicitement demandée, ou lorsque des entrées manquantes non résolues empêchent tout travail supplémentaire.

Vérification de la mise en page avant production

Pour un flux de travail par étapes avec relecture par l'utilisateur, réservez une zone de sous-titres inférieure cohérente avant l'animation. Commencez autour de 10–15 % de la hauteur de la diapositive, en vous adaptant à la longueur réelle des sous-titres et à la lisibilité plutôt qu'en imposant un ratio fixe. Préservez le style d'origine et le contenu mesuré. Repositionnez ou redimensionnez modérément le contenu du corps ; ne couvrez jamais le contenu original pour simuler un espace blanc. Gardez les axes, les légendes des figures, les pieds de page et les logos lisibles. Préservez les animations existantes lorsque vous modifiez la mise en page.

Fournissez un PPTX de mise en page modifiable séparé et des aperçus de relecture PDF/par diapositive. Montrez le sous-titre le plus long par diapositive dans les aperçus pour vérifier l'ajustement du texte ; ne laissez pas d'espaces réservés de sous-titres d'aperçu dans la source de production. Signalez les pages surchargées. Lorsque l'utilisateur demande une confirmation humaine de la mise en page, attendez-la avant l'animation/exportation finale, puis utilisez le diaporama de mise en page confirmé et le fichier de sous-titres confirmé comme entrées de production. Faites correspondre le placement de la bande d'assistance et les paramètres de police à la mise en page approuvée ; n'utilisez pas aveuglément les valeurs par défaut. Réutilisez une mise en page déjà approuvée plutôt que de répéter cette étape. Une autorisation explicite pour un flux de travail en un passage ne nécessite pas de barrière de relecture supplémentaire.

Flux de travail

  1. Inspectez et préparez le diaporama. Préservez les graphiques, les tableaux, les médias, les notes et le design existant. Réservez une bande de sous-titres inférieure en dehors des étiquettes des graphiques et de la sortie vidéo. Réorganisez d'abord le contenu si nécessaire. Adaptez la taille des sous-titres aux dimensions réelles de la diapositive. Limitez les sous-titres à une ou deux lignes.
  2. Écrivez et vérifiez la chronologie. Donnez à chaque réplique un nom de forme unique CAPTION_…. Vérifiez les limites locales des répliques, les lacunes, les chevauchements, les durées des diapositives et le temps vidéo cumulé. Conservez le CSV final avec les sorties.
  3. Créez les effets de sous-titres natifs. Sur Windows avec PowerPoint de bureau, utilisez l'assistant fourni lorsque ses préconditions correspondent. Il crée des zones de texte modifiables et des effets d'entrée/sortie de fondu natifs via le modèle objet PowerPoint. Son modèle de minutage utilise des effets automatiques After Previous, ce qui évite toute ambiguïté sur les délais absolus dans les chaînes With Previous.
  4. Définissez l'avancement automatique des diapositives. Utilisez la durée de la chronologie pour chaque diapositive, désactivez le clic pour avancer et exportez en utilisant les minutages de diapositive enregistrés et les animations. Préservez les fonctionnalités de présentation non liées.
  5. Exportez via PowerPoint. Fournissez le PPTX animé, le MP4 réel, le CSV final et les PDF/PNG demandés. Les aperçus statiques montrent la première réplique sur chaque diapositive ; le PPTX conserve chaque réplique. Une vidéo de démonstration manquante reste un espace réservé clairement identifié.
  6. Vérifiez la sortie réelle. Inspectez les diapositives rendues et échantillonnez le MP4 à l'intérieur de chaque réplique, entre les transitions de diapositives et autour des fondus sélectionnés. Confirmez la durée, la lisibilité des sous-titres, la disparition correcte et l'absence de texte de sous-titre résiduel. Une inspection XML, un fichier SRT ou un statut d'exportation terminé ne suffit pas à établir une lecture correcte. Signalez explicitement les éléments non vérifiés.

Assistants

scripts/add-subtitles-and-export.ps1 accepte un PPTX local et un CSV de chronologie. Il écrit une copie, ajoute les sous-titres, exporte les PDF/PNG et, sauf indication contraire, un MP4. Il refuse les séquences d'animation existantes ou les objets de sous-titres car la fusion de ces séquences nécessite une création délibérée. Pour une source déjà animée, préservez et adaptez la chronologie existante à l'aide des outils de présentation disponibles plutôt que d'effacer tous les effets.

pwsh -NoProfile -File "<skill>/scripts/add-subtitles-and-export.ps1" `
  -InputPptx "C:/work/presentation.pptx" `
  -TimelineCsv "C:/work/subtitle_timeline.csv" `
  -OutputDirectory "C:/work/captioned-output"

Exécutez uniquement via une méthode d'exécution autorisée dans l'environnement actuel. L'assistant nécessite une session de connexion de bureau Windows avec Microsoft PowerPoint installé. Une erreur de session de connexion COM dans un bac à sable est une limitation d'environnement : utilisez le chemin d'exécution de bureau approuvé ou l'interface utilisateur native, et préservez toute frontière d'approbation requise. N'affaiblissez pas les paramètres de sécurité et ne contournez pas la stratégie d'exécution.

Pour l'assurance qualité vidéo, préférez un décodeur multimédia disponible. Le script optionnel scripts/extract-video-frames.ps1 utilise le décodage multimédia Windows et nécessite PowerShell 7 en mode STA. Consultez notes sur la lecture et l'exportation Office lors du dépannage ou de l'adaptation d'animations existantes.

Achèvement

Fournissez des liens concis vers les fichiers demandés. Indiquez si le minutage réel du MP4 et les modifications des sous-titres ont été vérifiés. Limitez la qualification : identifiez les médias réels manquants ou la lecture non testée sans donner l'impression qu'un espace réservé prouve une démonstration en direct.

Pour une explication en anglais destinée aux collègues, utilisez la présentation du flux de travail.

Skills associés