Communitygithub.com

machengjie321/legendas-automaticas-powerpoint

Adicione legendas editáveis e temporizadas a uma apresentação do PowerPoint e exporte um MP4 com avanço automático usando o Microsoft PowerPoint para desktop no Windows. Ideal para vídeos com legendas baseados em slides, incluindo demonstrações silenciosas e apresentações de pesquisa.

O que é legendas-automaticas-powerpoint?

Esta skill converte uma apresentação PPTX existente em uma versão legendada e editável, além de gerar um vídeo MP4 com avanço automático dos slides. Diferente de soluções que produzem apenas imagens estáticas ou arquivos SRT, ela insere legendas como caixas de texto nativas do PowerPoint com efeitos de entrada e saída, facilitando a edição posterior. A skill suporta duas abordagens principais: (1) rascunhar legendas automaticamente a partir do conteúdo do deck, ou (2) aceitar legendas fornecidas pelo usuário por meio de texto, documento ou arquivo de narração. Para criar a linha do tempo das legendas, ela utiliza um CSV padronizado com tempos calculados a partir da duração do texto ou de timings reais de narração. Todo o processo é executado no Microsoft PowerPoint para desktop no Windows utilizando scripts PowerShell que interagem com o modelo de objeto do PowerPoint. A skill também oferece um fluxo de trabalho opcional de revisão manual, onde o usuário pode verificar o layout e as legendas antes da exportação final, garantindo que o resultado esteja de acordo com as expectativas. É especialmente útil para criar vídeos acessíveis com legendas precisas e sincronizadas, preservando a formatação original dos slides.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Legendas automáticas e vídeo do PowerPoint

Converta um PPTX local existente em uma apresentação legendada editável e um vídeo. Mantenha o deck original intacto. As legendas são caixas de texto nativas do PowerPoint com efeitos de entrada e saída, em vez de imagens de slide achatadas ou um resultado apenas em SRT.

Entradas e decisões

Resolva um PPTX de origem específico (caminho absoluto existente, nome exato do anexo ou deck aberto explicitamente identificado), o diretório de saída, a política de duração, o idioma da legenda e a fonte da legenda antes da autoria. As fontes de legenda podem ser um documento nomeado, texto explicitamente fornecido por slide, um arquivo de narração nomeado ou uma solicitação explícita para rascunhar a partir do deck. Verifique se os arquivos referenciados existem e se as legendas correspondem à ordem real dos slides. Se o deck de origem ou a fonte da legenda permanecerem ambíguos na conversa, pergunte apenas por essa informação faltante; não selecione um deck histórico não relacionado nem invente uma fonte de script. Um exemplo de solicitação colada com caminhos de espaço reservado não é um deck de entrada real.

Identifique qualquer mídia real a ser incluída. Reutilize os ativos fornecidos e os valores medidos. Se nenhum áudio for fornecido, escreva legendas concisas a partir do conteúdo do slide; não descreva isso como transcrição de fala. Quando houver áudio, alinhe as legendas à narração real.

Para rascunhar legendas a partir de slides, aceitar texto por slide ou um documento, e estimar o tempo a partir do comprimento do texto, leia autoria e temporização de legendas. O scripts/captions-to-timeline.py incluído converte Markdown/TXT normalizado no CSV de animação com taxas de leitura ajustáveis para palavras em inglês e caracteres em chinês. Use tempos de fala reais quando houver narração.

Produza uma linha do tempo UTF-8 antes de animar. Leia o contrato da linha do tempo para o esquema e as fórmulas de temporização. A posição de um slide no arquivo (slide_index) pode diferir do seu número de página impresso (slide_number). Nem nove slides nem 160 segundos são um padrão universal.

Captação de legendas em primeiro lugar

Suporte dois caminhos de preparação de legendas: (A) rascunhar a partir do PPTX especificado; (B) normalizar as legendas fornecidas pelo usuário sem rascunhá-las novamente. Para o caminho B, preserve a redação, ordem, valores e unidades; traduza ou refine apenas quando solicitado. Mantenha os mapeamentos de página não resolvidos e as alterações propostas que alteram o significado em notas de revisão separadas. Ambos os caminhos podem convergir para revisão, edição e confirmação do usuário antes da produção quando esse fluxo de trabalho em etapas for solicitado. Suporte um fluxo de trabalho de rascunho-edição-produção: quando solicitado, leia automaticamente o deck especificado e salve um rascunho de legenda padrão por slide, além de notas de revisão separadas. Não exija que o usuário preencha o modelo manualmente primeiro. Sinalize conteúdo ilegível e afirmações incertas nas notas de revisão, em vez de fabricar legendas. Quando o usuário solicitar revisão manual antes da produção, entregue o rascunho e aguarde o arquivo editado. No estágio de produção posterior, trate esse arquivo editado como a fonte de verdade da legenda; preserve sua redação, recalcule o tempo a partir dele e não o substitua por um novo script derivado do deck. Este estágio de revisão é o escopo do fluxo de trabalho solicitado, não uma etapa obrigatória para exportação de uma passagem explicitamente autorizada.

Inicie um novo fluxo de trabalho de legendas ajudando o usuário a fornecer legendas no formato padrão por slide. Explique que ## Slide N identifica o PPTX real e cada linha - é uma sugestão. Aceite um arquivo de legenda nomeado ou texto colado com rótulo de slide. Normalize rascunhos do Word ou não estruturados em um captions.md UTF-8 antes de calcular os tempos. Mantenha direções visuais e instruções de tarefa fora do texto da legenda. Verifique a ordem dos slides, páginas ausentes e espaços reservados de modelo não substituídos. Não invente legendas ausentes quando o usuário escolheu um fluxo de trabalho de script fornecido; rascunhe a partir do deck apenas quando solicitado. Se o usuário pedir apenas para organizar o documento de legenda, entregue esse documento e a verificação de mapeamento sem prosseguir para animação/exportação. Reutilize um arquivo de legenda já válido em vez de repetir a captação. Para uma solicitação de vídeo ponta a ponta, a normalização é uma etapa intermediária: continue através da temporização, animação nativa, exportação e QA de reprodução real sem uma etapa de aprovação desnecessária. Pare após o documento de legenda apenas quando esse escopo limitado for explicitamente solicitado, ou quando entradas faltantes não resolvidas impedirem mais trabalho.

Revisão de layout antes da produção

Para um fluxo de trabalho em etapas com revisão do usuário, reserve uma área de legenda inferior consistente antes da animação. Comece em torno de 10%–15% da altura do slide, adaptando-se ao comprimento real da legenda e à legibilidade, em vez de aplicar uma proporção fixa. Preserve o estilo original e o conteúdo medido. Reposicione ou redimensione moderadamente o conteúdo do corpo; nunca cubra o conteúdo original para simular espaço em branco. Mantenha eixos, legendas de figuras, rodapés e logotipos visíveis. Preserve as animações existentes ao alterar o layout.

Entregue um PPTX de layout editável separado e visualizações de revisão em PDF/por slide. Mostre a legenda mais longa por slide nas visualizações para verificar o ajuste do texto; não deixe espaços reservados de visualização de legenda na fonte de produção. Sinalize páginas lotadas. Quando o usuário solicitar confirmação humana do layout, aguarde antes da animação/exportação final e, em seguida, use o deck de layout confirmado e o arquivo de legenda confirmado como entradas de produção. Combine o posicionamento da faixa auxiliar/configurações de fonte com o layout aprovado; não use padrões cegamente. Reutilize um layout já aprovado em vez de repetir este estágio. A autorização explícita para um fluxo de trabalho de uma passagem não requer uma etapa de revisão extra.

Fluxo de trabalho

  1. Inspecione e prepare o deck. Preserve gráficos, tabelas, mídia, notas e design existentes. Reserve uma faixa de legenda inferior fora dos rótulos de plotagem e da saída de vídeo. Refluir o conteúdo primeiro, quando necessário. Adapte o tamanho da legenda às dimensões reais do slide. Mantenha as legendas em uma ou duas linhas.
  2. Escreva e verifique a linha do tempo. Dê a cada sugestão um nome de forma único CAPTION_…. Verifique os limites locais das sugestões, lacunas, sobreposições, durações dos slides e tempo cumulativo do vídeo. Mantenha o CSV final com as saídas.
  3. Crie efeitos de legenda nativos. No Windows com o PowerPoint para desktop, use o auxiliar fornecido quando suas pré-condições se encaixam. Ele cria caixas de texto editáveis e efeitos nativos de entrada/saída Fade através do modelo de objeto do PowerPoint. Seu modelo de temporização usa efeitos automáticos After Previous, o que evita ambiguidades sobre atrasos absolutos em cadeias With Previous.
  4. Defina o avanço automático de slides. Use a duração da linha do tempo para cada slide, desabilite o clique para avançar e exporte usando os tempos de slide gravados e as animações. Preserve recursos de apresentação não relacionados.
  5. Exporte através do PowerPoint. Entregue o PPTX animado, o MP4 real, o CSV final e os PDFs/PNGs solicitados. As visualizações estáticas mostram a primeira sugestão em cada slide; o PPTX retém cada sugestão. Um vídeo de demonstração ausente permanece um espaço reservado claramente rotulado.
  6. Verifique a saída real. Inspecione os slides renderizados e amostre o MP4 dentro de cada sugestão, através dos limites dos slides e ao redor dos fades selecionados. Confirme a duração, legendas legíveis, desaparecimento correto e nenhum texto de legenda residual. A inspeção XML, um arquivo SRT ou um status de exportação concluída por si só não estabelecem reprodução correta. Relate itens não verificados explicitamente.

Auxiliares

scripts/add-subtitles-and-export.ps1 aceita um PPTX local e um CSV de linha do tempo. Ele escreve uma cópia, adiciona legendas, exporta PDF/PNGs e, a menos que solicitado de outra forma, um MP4. Ele recusa sequências de animação existentes ou objetos de legenda porque mesclar essas sequências precisa de autoria deliberada. Para uma fonte já animada, preserve e adapte a linha do tempo existente usando as ferramentas de apresentação disponíveis, em vez de limpar todos os efeitos.

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"

Execute apenas através de um método de execução permitido no ambiente atual. O auxiliar requer uma sessão de login do Windows desktop com o Microsoft PowerPoint instalado. Um erro de sessão de login COM em sandbox é uma limitação de ambiente: use o caminho de execução de desktop aprovado ou UI nativa e preserve qualquer limite de aprovação necessário. Não enfraqueça as configurações de segurança nem contorne a política de execução.

Para QA de vídeo, prefira um decodificador de mídia disponível. O opcional scripts/extract-video-frames.ps1 usa decodificação de mídia do Windows e precisa do PowerShell 7 no modo STA. Leia notas de exportação e reprodução do Office ao solucionar problemas ou adaptar animações existentes.

Conclusão

Forneça links concisos para os arquivos solicitados. Indique se o tempo real do MP4 e as alterações de legenda foram verificados. Mantenha a qualificação restrita: identifique mídia real ausente ou reprodução não testada sem implicar que um espaço reservado prova uma demonstração ao vivo.

Para uma explicação em inglês adequada para colegas, use o passo a passo do fluxo de trabalho.

Habilidades Relacionadas