bruc3van/bruce-pptx-generator

Gerador de PPTX do Bruce

Roteamento de Tarefas

Escolha o caminho correto com base no tipo de tarefa e carregue o arquivo correspondente.

Tarefa	Carregar Arquivo
Editar um PPTX de modelo existente	editing.md + pptxgenjs.md
Criar do zero (usando presets de estilo)	workflow.md + arquivo de preset + pptxgenjs.md + qa.md

Presets de Estilo

Ao usar um preset, carregue o arquivo de preset — ele contém layouts de página completos, funções de componentes, paletas de cores e regras de densidade de conteúdo.

Seleção de Estilo

Se o usuário não especificar um estilo, o padrão recomendado é o Plano Huawei. Para confirmar, use AskUserQuestion para perguntar: Qual é a sensação que o público deve ter ao final desta apresentação?

Preset	Sensação do Público	Fonte	Arquivo	Cenários de Uso
McKinsey Azul	Lógica rigorosa	YaHei + Arial Black	mckinsey-style.md	Relatórios estratégicos, consultoria, propostas para a gestão
Plano Huawei	Autoridade profissional	YaHei + Arial Black	huawei-style.md	Apresentação de produtos, apresentação da empresa, soluções, propostas para clientes governamentais/empresariais
Minimalismo Apple	Toque o coração	YaHei + Arial Black	apple-minimal-style.md	Lançamentos de produtos, Demos, Discursos de Visão, Roadshows externos
Pitch Deck	Vender	YaHei + Arial Black	pitch-deck-style.md	Roadshows de financiamento, propostas de Roadmap, Business Case
Análise de Dados	Explicar claramente	YaHei + Arial Black	data-analysis-style.md	Relatórios de pesquisa de usuários, resultados A/B, Revisões de OKR, reuniões de métricas
Tecnologia Escura	Inovação e ousadia	YaHei + Arial Black	dark-tech-style.md	Lançamentos de produtos, apresentações técnicas, demonstrações de capacidade de IA

Informe o preset recomendado ao usuário e explique o motivo, depois entre no fluxo de trabalho. Se o usuário não estiver satisfeito, permita a seleção manual.

Princípios de Inferência de Dados

Expressões vagas são proibidas na apresentação. Cada argumento deve ser apoiado por números específicos. Quando a entrada do usuário não tiver dados:

1. Priorizar perguntas de acompanhamento: Quando houver 1 a 3 lacunas de dados na entrada, use AskUserQuestion para perguntar sobre todos os números ausentes de uma só vez, explicando onde cada número será usado em qual slide.
2. Permitir estimativas: Quando houver muitas lacunas ou o usuário disser explicitamente "gere diretamente", use valores de referência típicos do setor e indique na parte inferior do slide "Referência do setor, substitua pelos dados reais", e informe ao usuário na resposta quais são estimativas.
3. Proibir placeholders vazios: É proibido escrever "XX%", "N unidades", "centenas de milhares de usuários" sem preencher números específicos.

Palavras de gatilho para perguntas de acompanhamento (aparecem e perguntam por números):

"muitos usuários", "aumento significativo", "redução considerável", "crescimento rápido", "grande quantidade", "notavelmente", "eficazmente"

Padrão de Entrega Premium (Obrigatório)

Cada apresentação deve atingir o padrão de "casa pronta para morar", sendo proibido entregar slides "cruelmente" com apenas "título + uma frase".

Riqueza de Conteúdo (cada slide de conteúdo deve atender)

1. Dados ou estatísticas devem existir: Cada argumento central deve ser apoiado por um número, proporção, tempo ou dado do setor. Exemplo: "Taxa de abandono de acompanhamento de doenças crônicas > 60%", "Cobre 118 milhões de idosos solitários".
2. Tagline deve existir: Cada cartão ou módulo deve ter uma frase de posicionamento precisa de 12 a 20 caracteres, explicando "que problema isso resolve". Exemplo: "Autenticação de identidade de nível financeiro, controle total do acesso aos dados".
3. Bullet deve ter prefixo visual: Use quadrados/pontos/números como prefixo, proibindo empilhamento de texto puro. Cada bullet deve ser uma frase semântica completa, não uma única palavra-chave.
4. Elementos visuais não textuais devem existir: Exceto para o Minimalismo Apple, cada slide de conteúdo deve incluir pelo menos um componente visual não textual (ícone SVG, cartão de dados, fluxograma, anel de progresso, matriz de comparação, diagrama de arquitetura, cartão KPI). Páginas de lista de texto puro são consideradas "cruas" e devem ter elementos visuais adicionados. O estilo Minimalismo Apple tem como núcleo a simplicidade e moderação; adicione elementos visuais conforme necessário.
5. Limite superior de densidade gráfica (evitar transbordamento):
   • Cada slide pode usar no máximo um componente gráfico grande (fluxograma OU matriz OU conjunto de anéis de progresso OU pirâmide, escolha um, proibido empilhar)
   • Proibido ter dois gráficos grandes na mesma página: anel de progresso + matriz, pirâmide + fluxograma = alto risco de transbordamento
   • A área de conteúdo tem apenas 3,95" de altura (y:1.05 → y:5.0); com gráficos grandes, o espaço restante para texto é limitado. Antes de adicionar, estime se o texto cabe.
   • Proibido escrever do zero os seguintes componentes (não estão na biblioteca de presets, precisam implementar o algoritmo): funil, gráfico de Gantt, gráfico de radar. Se houver funções correspondentes no arquivo de preset atual, use-as; caso contrário, não use.
6. Área de nota/insight na parte inferior deve existir: Na parte inferior de cada módulo central, deve haver uma frase de 1 a 2 linhas de explicação complementar, reforçando o valor ou dando uma sugestão de ação.

Princípios de Atualização de Componentes

Cada estilo tem componentes de Cartão Rico Premium correspondentes; use-os preferencialmente, proibido regredir para cartões básicos com apenas title + desc:

Estilo	Capa Premium	Componentes de Conteúdo Premium	Componentes Básicos Proibidos
Plano Huawei	createRichCover	addHuaweiRichCard, makePainPointCard, addHuaweiProcessFlow	Uso básico de addHuaweiNumberedCard (apenas title+desc, sem tagline/bullet/nota inferior)
McKinsey Azul	createRichCover	addMcKinseyRichCard, makeProgressRing + cartão KPI	addMcKinseyCard(value, label, desc)
Minimalismo Apple	createRichCover	addAppleRichCard, addAppleKPI	addAppleBullets usado sozinho
Pitch Deck	createRichCover	addPitchRichCard, addTractionCard	Páginas de lista de texto puro
Tecnologia Escura	createRichCover	addDarkRichCard, addFeatureItem	Apenas título + parágrafo de corpo
Análise de Dados	createRichCover	addDataRichCard, createChartWithInsightsSlide	Páginas de análise de texto puro

• A página de capa deve ter elementos visuais decorativos (formas geométricas, decorações SVG, cartões de capacidade à direita, etc.), sendo proibido ter apenas título e data.
• Nota: createRichCover tem assinaturas de parâmetros diferentes em cada estilo (a versão Huawei tem metrics/valueSlogan, a versão Apple tem spotlight, a versão Pitch Deck tem traction/stage). Consulte os exemplos de chamada do arquivo de preset atual antes de usar; não aplique parâmetros de um estilo em outro.

Regras Obrigatórias

As seguintes regras se aplicam a cada slide de cada apresentação.

Dimensões — 10" × 5,625" (LAYOUT_16x9). Cada elemento deve satisfazer x + w ≤ 10 e y + h ≤ 5,625.

Cores — Hexadecimal de 6 dígitos, sem # (por exemplo, "FF0000"). Proibido usar "#FF0000" — causa corrupção de arquivo.

Fontes — Chinês: Microsoft YaHei | Inglês: Arial (ou fonte alternativa especificada no preset atual)

Fontes Proibidas — As seguintes fontes são proibidas para exibição/título: 宋体, 仿宋, Times New Roman. Elas parecem amadoras em apresentações modernas.

Objeto theme — Duas camadas de convenção, devem ser diferenciadas claramente:

① Camada de entrada de compile.js / subagente (rigorosamente 5 chaves)

Chave	Uso
theme.primary	Cor mais escura — título, texto principal
theme.secondary	Cor de destaque — elementos interativos, realces
theme.accent	Cor de acento icônica (por exemplo, linha laranja)
theme.light	Preenchimento claro — fundo de cartão, linhas zebradas
theme.bg	Cor de fundo do slide

O objeto theme definido em compile.js só passa essas 5 chaves. O subagente também declara apenas essas 5 no comentário DESIGN INTENT. Proibido usar nesta camada: background, text, muted, darkest, lightest ou outros nomes de chave inventados.

② Camada interna do arquivo de preset de estilo (permite chaves estendidas)

As funções de componente em cada arquivo de preset (como addHuaweiRichCard, makePainPointCard) podem referenciar chaves estendidas definidas no arquivo de preset, como theme.border, theme.bodyText, theme.mutedText, theme.orangeLight, etc. Essas chaves estão definidas no bloco theme constante do arquivo de preset e não são violações.

Marca de página — Todos os slides, exceto a capa, devem ter:

• Circular: x: 9.3, y: 5.1, w: 0.4, h: 0.4
• Cápsula: x: 9.1, y: 5.15, w: 0.6, h: 0.35
• Mostrar apenas o número da página (por exemplo, "3"), proibido usar o formato "3/12"

createSlide() deve ser uma função síncrona — Proibido usar async. compile.js não fará await dela.

Itens Proibidos (Armadilhas Comuns de Qualidade na Geração por IA)

Estes são os padrões que mais facilmente fazem a apresentação parecer de baixa qualidade; evite ativamente a cada geração:

Densidade de Conteúdo

• Mais de 6 bullet points em um único slide de conteúdo — divida em dois slides se exceder
• Cada bullet com mais de 20 caracteres — simplifique ou use layout de cartão
• Mais de 3 slides consecutivos com o mesmo tipo de layout

Visual

• Cor de fundo inconsistente entre slides (slides de conteúdo devem usar uniformemente theme.bg)
• Adicionar gradiente a cada elemento — gradiente é apenas para destaque, não abuse
• Todo o conteúdo centralizado — parece monótono; alinhamento à esquerda tem mais hierarquia
• Empilhamento de blocos decorativos sem lógica de layout

Texto

• Título copiando a primeira frase do corpo — o título deve ser a conclusão ou ideia principal, não uma descrição
• Texto em inglês misturado com fontes Songti/Fangsong — texto em inglês deve usar a fonte inglesa especificada
• Valores de cor com prefixo # ("#1F3864" → alterar para "1F3864") — causa corrupção de arquivo

Instalação de Dependências

npm install -g pptxgenjs