O que SlidePatch faz?
Use os scripts fornecidos com esta skill. Resolva seus caminhos relativamente a este arquivo, independentemente do diretório de trabalho do agente host. O host precisa ter execução local de comandos e visualização de imagens; esta skill não possui APIs específicas do DSH ou chaves de API de modelo.
Para uma nova instalação, execute python <skill>/scripts/slidepatch.py doctor (adicione --charts para migração de gráficos ou --equations para conversão de equações). Isso verifica dependências e registro do Office sem abrir aplicativos. Um resultado "pronto" não substitui a verificação nativa.
Conversão nativa de equações
Para solicitações de conversão de texto de fórmula independente, imagens ou equações MathType/OLE em equações nativas do PowerPoint, use inspect-equations e convert-equations. Leia references/equations.md para o plano, transcrição e contrato de verificação. Este modo precisa do Pandoc além do Windows/PowerPoint; outros modos não requerem Pandoc. Ele preserva o layout do arquivo, a contagem de páginas e objetos não especificados, não usa modelo e não reconverte equações nativas existentes. LaTeX explícito de objeto inteiro produz candidatos; o Agente revisa e transcreve imagens e pré-visualizações OLE em cache sem ativar OLE ou analisar binários MathType. Deixe objetos não claros intactos e reporte-os. A migração com modelo atualmente rejeita equações nativas para evitar perda de estrutura matemática; não trate a conversão como suporte automático para migrar as equações resultantes.
Migração e paginação de apresentação completa
Para uma solicitação de migrar a apresentação inteira ou permitir paginação, prefira migrate. Leia references/batch.md para o contrato de cobertura e formato de evidência.
python <skill>/scripts/slidepatch.py migrate <source.pptx> --template <template.pptx> --output <new-output.pptx> --evidence <fresh-evidence-directory>
O motor visita cada slide de origem em ordem. Ele identifica páginas de capa, sumário, seção numerada e conteúdo comum; prefere o tipo de página de modelo correspondente; e reutiliza planos de fundo nativos, gráficos e layouts do modelo. Uma página de sumário pode usar um estilo de página de conteúdo quando não há um modelo de sumário dedicado. Revise a classificação e fallback em plan.json; esta é uma inferência geométrica/tipográfica, não compreensão irrestrita de imagem.
Preserve a família, tamanho, peso e cor da fonte do modelo. Medições nativas de texto determinam a capacidade. Mantenha grupos completos juntos quando possível; equilibre o volume de texto entre partições de página com grupos igualmente curtos. Se um único grupo for muito grande, divida nos limites de objeto de corpo, parágrafo ou frase, preservando fatias exatas de caracteres. Páginas de continuação de grupo muito grande alinham o conteúdo no topo. Títulos, cabeçalhos de grupo e rodapés se repetem como contexto explícito; as fatias de corpo devem reconstruir a fonte exatamente uma vez e em ordem. Nunca reescreva números da fonte ou renumere silenciosamente um sumário. Uma frase que não couber sem alterar a tipografia do modelo faz com que toda a operação falhe.
Este modo suporta texto editável comum, placeholders de texto de origem suportados e imagens/gráficos nativos incorporados com estrutura clara. Os limites do placeholder de origem estão em references/plan.md. Para páginas de mídia, leia references/media.md: imagens e seus cortes permanecem nativos, gráficos mantêm pastas de trabalho incorporadas, e legendas associadas permanecem com seus ativos durante layout e paginação. Páginas de mídia usam modelos de conteúdo. Decorações não textuais, placeholders não suportados, grupos, animações, links externos e estruturas ambíguas permanecem não suportados. A falha em qualquer página impede a publicação de toda a saída; nunca entregue uma apresentação parcial. Cada página gerada é reaberta, renderizada, verificada contra a fonte/plano de fundo do modelo, e realmente editada e salva em uma cópia de prova separada. A saída é publicada somente após todas as verificações de página, texto e mídia passarem.
Revise cada after-N.png, especialmente títulos de capa/seção, fallback de página de sumário e limites de paginação. Leia as verificações por página e a lista de páginas editáveis em report.json. Entregue o PPTX verificado, a pré-visualização e um breve resumo da correspondência fonte-saída. Informe que o contexto repetido é intencional quando páginas foram divididas. Os originais permanecem inalterados.
Modo mesmo arquivo (plano v1)
- A entrada é um
.pptxexistente; fonte e referência são slides diferentes nesse arquivo, com o mesmo design e layout e gráficos mestres ocultos. - Fonte: formas comuns, linhas e caixas de texto horizontais. Referência: estas mais imagens decorativas. Nenhum grupo, placeholder, gráfico, SmartArt, animação, transição, hiperlink ou objeto rotacionado em qualquer um dos slides selecionados.
- Cada objeto de texto da fonte mapeia exatamente para um objeto de texto da referência, e vice-versa. As formas não textuais da fonte devem ser explicitamente identificadas como decorações a serem substituídas. Pare para esclarecimento se um objeto puder conter evidência visual significativa.
- A operação substitui os objetos locais do slide fonte por cópias nativas dos objetos de referência e os preenche com as strings exatas da fonte. Ela adota a tipografia da referência, incluindo alterações de ênfase; não promete preservar a formatação de caracteres da fonte.
- Sem sumarização de conteúdo, divisão de página, redução automática de fonte ou reconstrução de imagem para editável. Se os slides selecionados não se encaixarem nesses limites, explique a limitação específica em vez de reconstruir a apresentação através de uma ferramenta não relacionada.
Modo modelo separado (plano v2)
Use apply-template para um slide fonte e um modelo em arquivos PPTX separados. Este modo produz um novo slide nas dimensões do modelo; ele não reescreve a apresentação fonte nem inclui os outros slides do modelo. Escolha v1 quando o usuário precisar preservar os outros slides da apresentação fonte.
Inspecione ambos os arquivos, incluindo gráficos de layout/mestre herdados agora listados sob inheritance. Veja as pré-visualizações reais e escolha uma página de conteúdo em vez de assumir que o slide 2 é um modelo adequado. Preserve a identidade visual e as decorações. Classifique explicitamente cada objeto de modelo local como decoração mantida ou conteúdo de exemplo removido; não retenha fotos de modelo não relacionadas como evidência para o conteúdo fonte.
Crie um posicionamento por objeto de texto fonte. Um posicionamento nomeia uma forma de texto comum do modelo como doadora de estilo e fornece limites em pontos. A mesma doadora pode servir a múltiplos posicionamentos, portanto o número de textos fonte e modelo pode diferir. O motor duplica objetos nativos dentro do modelo, preservando seu layout/mestre e tema. O texto vem diretamente da fonte; os planos não contêm strings de substituição. Redução de fonte e reescrita de conteúdo permanecem não suportadas.
As restrições da fonte do v1 se aplicam, exceto que o v2 também aceita os placeholders de texto de origem suportados. Slots de texto vazios seguros são explicitamente registrados como descartados; texto de origem herdado ativo causa rejeição em vez de omissão silenciosa. Doadores de estilo devem ser formas de texto horizontais comuns não rotacionadas, e não placeholders/grupos. Decorações de layout/mestre do modelo permanecem nativas, incluindo imagens herdadas e placeholders de layout não utilizados. Decorações locais mantidas não devem ter texto. Os planos registram quais objetos são removidos; o planejamento automático pode propor essas decisões, enquanto o Agente revisa seu significado.
Layout automático (preferido para modelos separados)
Para uma fonte apenas com texto, com um título claro e texto de corpo, incluindo placeholders de texto de origem suportados, primeiro execute:
python <skill>/scripts/slidepatch.py plan-template <source.pptx> --template <template.pptx> --source-slide 1 --out <fresh-planning-directory>
Isso gera um plan.json v2 normal sem página alvo, IDs de forma ou coordenadas fornecidas manualmente. selection.json registra funções inferidas da fonte, páginas de modelo candidatas, decisões de decoração baseadas em geometria, layouts candidatos, medições de ajuste e razões de rejeição. Status planned significa que um plano existe, não que um PPTX passou pela verificação final.
O planejador usa hierarquia de fontes e proximidade espacial para associar títulos e corpos; não usa nomes de forma ou números de página do modelo. Requer um título superior distinto, reconhece rodapés inferiores com fonte curta e suporta linhas/colunas agrupadas ou parágrafos sem cabeçalho. Ele busca layouts de linha, empilhado, duas colunas e três colunas, usando os limites de texto nativos do PowerPoint com os tamanhos de fonte originais do modelo. O texto quebra; sem reescrita de strings ou redução de fonte. As caixas candidatas não devem sobrepor umas às outras ou às decorações mantidas. Planos de fundo de página inteira e placeholders de layout não utilizados são excluídos das verificações de obstáculo.
Leia selection.json, veja source.png e o template-N.png selecionado, e verifique se as associações de função e a remoção de imagens de exemplo fazem sentido. A classificação automática de imagens usa geometria e legendas próximas, não compreensão de imagem. Não afirme correspondência semântica universal. Para um resultado inequívoco, prossiga diretamente para apply-template com o plano gerado e então revise a saída renderizada. O usuário não precisa fornecer coordenadas ou aprovar escolhas rotineiras já cobertas por sua solicitação.
Se o planejamento de página única rejeitar funções ambíguas, decorações incertas, objetos não suportados ou conteúdo com capacidade excedida, leia a razão registrada. Quando a paginação estiver autorizada, use migrate. Caso contrário, inspecione os objetos reais antes de usar um plano v2 explícito revisado. Nunca omita conteúdo silenciosamente, reduza fontes ou altere o escopo de páginas autorizado. Fontes com imagens, decorações não textuais, hierarquia mista/não clara, gráficos ou grupos ainda precisam de um fluxo de trabalho explícito ou de conteúdo não suportado.
Execução
Instale requirements.txt em um ambiente virtual Python 3.10+. Use esse interpretador para cada comando. O PowerPoint para desktop deve estar utilizável na sessão do Windows logada. Primeiro inspecione:
python <skill>/scripts/slidepatch.py inspect <source.pptx> --out <fresh-inspection-directory>
Leia inventory.json e veja ambas as pré-visualizações relevantes slide-N.png. Corresponda as funções de conteúdo usando os objetos reais e a aparência. Nunca infira IDs de forma a partir de sua ordem ou reconstrua o texto protegido de memória.
Para modo mesmo arquivo, crie um plano JSON usando o esquema em references/plan.md. Para modelos separados, prefira plan-template; use um plano v2 revisado manualmente quando a inferência automática não for adequada. Copie hashes e IDs dos inventários atuais. Preserve o escopo pretendido pelo usuário. Uma solicitação clara autorizada com um mapeamento inequívoco pode prosseguir; pergunte apenas quando uma ambiguidade material de conteúdo não puder ser resolvida a partir dos arquivos.
python <skill>/scripts/slidepatch.py apply <source.pptx> --plan <plan.json> --output <new-output.pptx> --evidence <fresh-evidence-directory>
Para um modelo separado, inspecione-o também e, em seguida, use um plano v2:
python <skill>/scripts/slidepatch.py inspect <template.pptx> --out <fresh-template-inspection>
python <skill>/scripts/slidepatch.py apply-template <source.pptx> --template <template.pptx> --plan <v2-plan.json> --output <new-output.pptx> --evidence <fresh-evidence-directory>
O motor prepara a apresentação editada, reabre e renderiza no PowerPoint, compara objetos de texto e números exatos, verifica slides não alvo e testa uma edição de texto real e movimento de forma em uma cópia de prova separada. Ele publica a saída somente após essas verificações passarem. Nunca chama PowerPoint Quit nem fecha apresentações não relacionadas. Copiar/colar nativo usa a área de transferência do sistema.
O modo modelo, em vez disso, verifica o resultado de um único slide, ambos os hashes originais, todas as strings da fonte local, objetos nativos salvos e camadas de decoração renderizadas idênticas antes/depois. Sangria decorativa existente é permitida; novo conteúdo deve caber. Ele usa Duplicata nativa sem a área de transferência. O PPTX ainda pode conter layouts, mestres ou mídia de modelo não utilizados; este protótipo não sanitiza ativos de pacote ocultos.
Revisão e entrega
Leia report.json; o status de saída e o relatório devem ambos indicar sucesso. Veja before-<source>.png, before-<reference>.png e after-<source>.png. Verifique se o estilo corresponde e não há corte, sobreposição não intencional ou ordem de leitura incorreta. As verificações geométricas não substituem a revisão visual.
Para modo modelo, veja source-before.png, template-before.png, after-1.png, além de template-shell.png e output-shell.png. Verifique a nova composição contra a linguagem visual do modelo; apenas corresponder strings de texto é insuficiente.
Entregue o novo PPTX com uma pré-visualização e um resumo conciso das verificações e do escopo. editability-proof.pptx contém deliberadamente um marcador de edição e é evidência, não o entregável final. Se qualquer verificação falhar, relate o problema; nunca apresente um arquivo preparado ou de prova como a apresentação final. Escolha caminhos novos em novas tentativas, mantendo as evidências de falha disponíveis.