Análise de Deck de Referência PPTX

Inspecione um deck de referência como evidência de design. Esta habilidade nunca copia, clona ou muta um deck de origem.

Contrato

Implemente a extração necessária sob demanda com um pequeno script python-pptx local da tarefa. Capture apenas as informações necessárias para o novo deck:

• contexto de prompt compacto: contagem e tamanho de slides, resumos de texto, contagens de formas, estilos, sinais de marca, uso de modelo e ritmo de layout;
• extração completa: summary, slides e evidências layout_tree somente leitura;
• diagnósticos de pasta: um resultado por deck mais um manifesto;
• análise de estilo mestre: cores, fontes, distribuição de tamanho, uso de mestre/layout e padrões de fluxo;
• catálogo de modelo derivado: índices de origem baseados em zero, funções de layout, regiões utilizáveis, placeholders, estruturas visuais e restrições.

Regras

• Mantenha o deck de origem somente leitura e crie independentemente cada coordenada de slide de destino.
• Use as utilidades OOXML incluídas apenas para temas brutos, relacionamentos, notas, comentários, animações, mídia, mestres ou layouts que a extração de alto nível não possa expor.
• Registre as partes inspecionadas e as exceções de análise no manifesto de análise.
• Não use conteúdo extraído, fontes, imagens ou ativos proprietários em um deck gerado sem permissão explícita e evidência de licença.

Inspeção de Pacote OOXML

Instale defusedxml de requirements.txt antes de usar as utilidades incluídas.

1. Execute scripts/inspect.py <deck.pptx> para um relatório JSON compacto da ordem dos slides, texto, tokens de tema, relacionamentos, notas, comentários, animações e mídia.
2. Execute scripts/validate_package.py <deck.pptx> --output <report.json> para XML malformado, relacionamentos internos quebrados, lacunas de tipo de conteúdo, links de layout duplicados e partes órfãs.
3. Execute scripts/unpack.py <deck.pptx> <output-dir> apenas quando evidências de pacote bruto forem necessárias.
4. Resolva os destinos de relacionamento em relação ao proprietário .rels; nunca infira a ordem dos slides a partir de nomes de arquivos.

Segurança

• Nunca modifique um deck fornecido ou copie cegamente partes do pacote para um novo deck.
• Execute os scripts de um espaço de trabalho confiável; eles rejeitam travessia de caminho, links simbólicos, membros de tamanho excessivo e bombas de arquivo.
• Analise XML não confiável com defusedxml; não habilite expansão de entidade, carregamento de DTD ou acesso à rede.
• Trate as cores do tema como tokens, a menos que sejam totalmente resolvidas em relação ao esquema de cores.

Veja references/reference-deck-analysis.md para formas de saída, references/reference-deck-analysis-patterns.md para padrões apenas de documentação e references/ooxml-parsing.md para mapas de partes do pacote.