Como usar IronPPT com Cursor
Quando um agente de IA move um gerador de deck de relatório C# do Open XML SDK para o IronPPT ao traduzir cada chamada de slide diretamente, o novo deck difere do antigo. O Open XML SDK começa a partir de um pacote vazio. Um novo IronPPT PresentationDocument já contém um slide, então um porte direto que adiciona um slide de título e um slide por aluno salva um deck cujo primeiro slide está em branco. Em nossos testes, o mesmo porte também produziu slides 4:3 onde o gerador antigo escrevia 16:9.
Cursor é um editor de código AI construído na base de código do VS Code, com um agente que edita arquivos e executa comandos. A migração abaixo usa duas de suas características, os links de documentação que o agente lê e as regras de projeto comprometidas em .cursor/rules. Move um gerador de deck de relatório escolar para IronPPT. O gerador constrói um deck de relatório de período por turma a partir de um arquivo de lista, com um slide de título, um slide por aluno e um slide de encerramento, e o deck migrado deve manter cada linha de texto aprovada pela escola.
Para as chamadas envolvidas, veja o guia de adicionar slide e o guia de adicionar texto.
Início RápidoCom o repositório ReportDecks aberto, cole este prompt em um novo chat de Agente.
@src/ReportDecks/ @TestData/expected/
Add an inspect command to Program.cs that prints the outline of a deck.
It runs as `dotnet run --project src/ReportDecks -- inspect <deck.pptx>`.
Before you write it, check https://ironsoftware.com/ppt/csharp/llms.txt.
From there, open the guides on adding slides and on license keys.
The command opens the deck with IronPPT and prints one line per slide, in this form:
- The slide number, a colon and a space.
- The text of each non-empty paragraph on the slide, in order, joined with " | ".
The outlines in TestData/expected use the same form.
The program reads IRONPPT_LICENSE_KEY from the environment itself.
It sets License.LicenseKey from that value before it opens or saves a deck.
Never show the license key in output, and don't dump the environment variables.
Keep IronPPT on version 2026.10.1 and leave OpenXmlDeckWriter alone for now.
Then build the term report for TestData/classes/7B.json, inspect it and show me what it prints.
Não cole a chave de licença em um chat, onde o agente pode copiá-la para um arquivo de origem, um commit ou um log de build. IronPPT 2026.10.1 não lê IRONPPT_LICENSE_KEY por si só. Ele procura uma configuração chamada IronPPT.LicenseKey no ambiente ou na configuração do aplicativo, por isso o prompt define License.LicenseKey no código. Sem uma chave, construir slides na memória e ler um deck funcionou, e Save lançou uma LicensingException antes de gravar o arquivo. O guia de chave de licença descreve onde armazenar a chave.
Fluxo de trabalho mínimo (5 etapas)
- Baixar a biblioteca PowerPoint C# do NuGet
- Adicione uma regra de projeto em .cursor/rules que contenha o link da documentação do IronPPT
- Registre na regra que um novo deck já contém um slide e usa 4:3
- Referencie o código do deck e o roteiro aprovado em cada solicitação
- Compare cada deck salvo com esse roteiro, depois confirme cada nome de membro na referência de API
Qual modelo Cursor você deve usar para trabalhos com IronPPT?
Composer é o modelo agêntico próprio do Cursor. O seletor de modelos também oferece os modelos Grok da SpaceXAI, que o Cursor co-desenvolveu, e modelos da OpenAI, Anthropic, Google e outros laboratórios. O teste executado abaixo usou o Composer 2.5.
Como você fornece a documentação do IronPPT ao Cursor?
Inclua o link da documentação do IronPPT na solicitação, ou armazene-o em uma regra que toda a equipe compartilha. O llms.txt do IronPPT lista cada guia e a referência de API, e llms-full.txt condensa 16 páginas de documentação em um único arquivo. Em outubro de 2026, o menu de @ do Cursor anexa arquivos, pastas, terminais, chats, diferenças do Git e o navegador, de modo que a solicitação dá ao agente a documentação do IronPPT como um link.
O guia de adicionar slide observa que uma nova apresentação já contém um slide em branco. O skill.md do IronPPT chama o mesmo objeto de nova, apresentação vazia, e nenhuma página que llms.txt vincula declara o tamanho do slide de um novo deck.
@src/ReportDecks/ParentEveningDeck.cs
Answer five questions about IronPPT, and don't change any files:
1. How many slides does a new PresentationDocument hold before AddSlide is called?
2. Where does AddSlide put the new slide, and what does it return?
3. Where does text passed to PresentationDocument.AddText end up?
4. Can IronPPT set the slide size, and what size does a new deck use?
5. Can IronPPT write speaker notes?
Base every answer on https://ironsoftware.com/ppt/csharp/llms.txt or a page it links to.
Name the page each answer comes from.
If no page answers a question, tell me so rather than guess.
Como você escreve regras de projeto que codificam suas convenções do IronPPT?
Uma regra de projeto é um arquivo .mdc armazenado em .cursor/rules e versionado com o repositório. Cursor ignora um arquivo .md simples nessa pasta, porque um arquivo sem frontmatter não lhe dá uma maneira de decidir quando carregar a regra.
A regra abaixo lista seus padrões de arquivo em globs, separados por vírgulas conforme a página de regras do Cursor especifica, e define alwaysApply como falso. Cursor então a carrega para solicitações que envolvem o código do deck ou os testes. Salve como .cursor/rules/ironppt-decks.mdc.
---
description: IronPPT conventions for the report deck code
globs: src/ReportDecks/**/*.cs, tests/**/*.cs
alwaysApply: false
---
Follow these rules in the report deck code:
- Build decks with IronPPT 2026.10.1 from NuGet, namespace IronPPT.
- Don't add another presentation package.
- Look up IronPPT members in https://ironsoftware.com/ppt/csharp/llms.txt and its linked pages.
- The program reads the key from IRONPPT_LICENSE_KEY.
- Never write the key to output or files.
- A new PresentationDocument starts with one slide already, and AddSlide appends after it.
- Fill that first slide, or remove it once the deck has another slide.
- A new PresentationDocument is 4:3.
- For a 16:9 deck with the school's title slide, open TestData/templates/hollybrook-16x9.pptx.
- On slides you add, put the lines in one TextBox as Paragraphs.
- Each AddText call on a slide creates another text box of the same size, with no position.
- PresentationDocument.AddText joins its text to the last paragraph of the last slide.
- Don't use PresentationDocument.AddText.
- Check every deck you save with the inspect command against TestData/expected.
- If an IronPPT member isn't in the docs, say so and cite the page you searched.
As regras se aplicam a solicitações de Agente. A página de regras do Cursor afirma que regras não afetam Tab e que regras de usuário não são aplicadas a edições inline, então reveja essas sugestões manualmente contra a regra.
Como mapear chamadas do Open XML SDK para IronPPT?
O Open XML SDK grava uma parte do pacote por parte, então o gerador antigo também cria o slide mestre, o layout, o tema e o mestre de notas. IronPPT cria essas partes ele mesmo.
| Open XML SDK | IronPPT |
|---|---|
PresentationDocument.Create com uma parte de apresentação, mestre, layout e tema | new PresentationDocument(), ou o construtor com um caminho de template |
Um SlidePart adicionado à parte de apresentação e listado em SlideIdList | AddSlide(new Slide()), que adiciona o slide |
Espaços reservados de título e corpo preenchidos com A.Paragraph e A.Run | Slide.AddChild com um TextBox, um Paragraph por linha |
| Texto em um espaço reservado existente | Texts[i].Text em um slide do template carregado |
SlideSize definido para 12192000 por 6858000 | Sem equivalente, então o tamanho vem do template |
Um NotesSlidePart por slide | Não existe equivalente |
Save para um arquivo ou qualquer Stream | Save(string), apenas um caminho de arquivo |
IronPPT.dll incorpora sua própria cópia dos tipos do Open XML SDK, todos internos, então o projeto foi construído com ambos os pacotes referenciados durante a migração.
Por que um novo deck de IronPPT começa com um slide extra?
O slide embutido de um novo PresentationDocument usa um layout de título cujos espaços reservados de título e subtítulo estão vazios. AddSlide é anexado depois dele e retorna o slide que foi dado, então cada slide de um porte direto aparece uma posição mais tarde do que no roteiro aprovado.
Remover esse slide muito cedo falha. Chamar Remove nele enquanto é o único slide gerou uma InvalidOperationException afirmando que uma apresentação deve conter pelo menos um slide. Uma vez que um segundo slide existia, a mesma chamada teve sucesso.
O tamanho do slide é a segunda diferença. Um novo deck medido 9144000 por 6858000 EMU, um slide 4:3. A referência de API documenta Slide.Width e Slide.Height com um exemplo que define a largura para 960 pontos, mas nenhuma das propriedades altera o tamanho do slide do deck. Defini-los para 960 por 540 pontos gravou 12192000 por 6858000 EMU nas extensões das formas do slide e deixou o tamanho do slide em ppt/presentation.xml em 9144000 por 6858000 EMU. Um deck carregado de um arquivo 16:9 manteve 12192000 por 6858000 EMU durante o salvamento, junto com seus espaços reservados e notas. O repositório portanto mantém o slide de título da escola em TestData/templates/hollybrook-16x9.pptx.
Como você planeja e executa uma migração para IronPPT?
Pressione Shift+Tab na entrada do chat até que o Modo de Planejamento seja selecionado, então envie a solicitação abaixo. Cursor grava o plano como um arquivo Markdown editável.
@src/ReportDecks/OpenXmlDeckWriter.cs @TestData/expected/7B-term-report.txt
Plan how to move the term report deck from the Open XML SDK to IronPPT.
Don't write any code until I approve the plan.
Leave ParentEveningDeck out of it, since it already uses IronPPT.
The plan needs to answer these questions:
- Which IronPPT call replaces each Open XML SDK step the writer takes?
- How does the deck keep 16:9 slides and avoid an extra blank slide?
- Where do the tutor comments go, given that they're speaker notes today?
- How does the build command keep its arguments and its output path?
Roster.cs and DeckText.cs stay as they are.
End with a list of the assumptions you made.
Corrija quaisquer erros no plano. Então construa o plano no Modo de Planejamento, ou volte para o Agente e envie esta solicitação.
@ironppt-decks
Go ahead with the approved plan.
If IronPPT can't write speaker notes, the tutor comments go in a text file beside the deck:
- For out/7B-term-report.pptx, the file is out/7B-term-report.comments.txt.
- It holds one "Name: comment" line per pupil, in roster order.
Work through these steps in order:
1. Build and inspect the 7B term report.
2. Count the lines that match TestData/expected/7B-term-report.txt.
3. Replace OpenXmlDeckWriter with an IronPPT class named TermReportDeck.
4. Remove DocumentFormat.OpenXml from the project file.
5. Build the solution, then build, inspect and count again.
Tell me both match counts, before and after, and show me the diff.
A menção @ironppt-decks anexa a regra pelo nome.
Qual recurso do Cursor se adapta a cada mudança?
Selecione um recurso com base no escopo da mudança. Tab completa uma edição que o desenvolvedor iniciou. Para uma seleção que uma frase pode descrever, use edição inline (Ctrl+K). O Agente gerencia mudanças em vários arquivos e trabalhos que requerem um build, e o Modo de Planejamento adiciona um plano para revisão antes que o Agente faça quaisquer mudanças no código.
Envie esta solicitação no Agente. Ele nomeia o método que muda, então não precisa de seleção no editor.
@src/ReportDecks/
Make TermReportDeck.Write check its own output once it saves the deck:
- Reopen the saved deck with IronPPT.
- Throw if the slide count isn't the pupil count plus 2.
- Throw if any slide has no text, with that slide's number in the message.
Have the build command print that message and exit with code 3.
Then build the decks for TestData/classes/7B.json and TestData/classes/8A.json.
Show me what each build prints.
Como o IronPPT coloca o texto que um slide adiciona?
Cinco chamadas de Slide.AddText em um slide produziram cinco formas de 1905000 por 1270000 EMU no mesmo espaço reservado do corpo. O hub de agentes de IA explica por que tais formas compartilham uma posição. Um TextBox que contém um Paragraph por linha produz uma forma com as linhas em ordem. Uma verificação do roteiro não detecta uma caixa deixada no tamanho padrão, porque lê apenas o texto.
PresentationDocument.AddText se comporta de maneira diferente do método de slide. Ele adicionou seu texto como uma nova execução no final do último parágrafo do último slide, sem espaço ou quebra de linha. Ao ler de volta através de Slide.Texts, as duas execuções aparecem como itens separados. Slide.Paragraphs retorna a linha que um visualizador vê, por isso o comando de inspecionar lê parágrafos.
Como você depura o deck que IronPPT já escreve?
O deck da reunião de pais já usava IronPPT antes da migração.
@src/ReportDecks/ParentEveningDeck.cs @TestData/expected/7B-parents-evening.txt
Find out why none of the 7B evening deck's lines match 7B-parents-evening.txt.
The office also reports black bars at the sides when the hall screen shows it.
Diagnose it before you touch any code:
1. Build the evening deck, inspect it and compare it with the expected outline.
2. List each line that differs.
3. Explain what in ParentEveningDeck causes each difference.
After that, fix ParentEveningDeck and keep it on IronPPT.
Add the output check the term report has, with pupils plus 1 as the slide count.
Inspect the deck again and tell me how many lines match before and after the fix.
Saída
Os desenhos abaixo mostram um slide de compromisso do deck antes da correção e um do deck após ela.

Slide 3 do deck da reunião de pais antes da correção, desenhado a partir do XML do arquivo salvo. O slide 4:3 contém duas formas de texto na mesma posição. O desenho mostra a geometria armazenada, não uma renderização do PowerPoint.

Slide 2 do deck da reunião de pais após a correção, desenhado a partir do XML do arquivo salvo. O slide 16:9 contém uma caixa de texto de 1905000 por 1270000 EMU. O desenho mostra a geometria armazenada, não uma renderização do PowerPoint.
Como você escreve testes de regressão para os decks?
@src/ReportDecks/ @TestData/
Write xUnit tests in tests/ReportDecks.Tests and add that project to the solution.
The tests cover these cases:
- The 7B term report matches every line of TestData/expected/7B-term-report.txt.
- The 7B evening deck matches every line of TestData/expected/7B-parents-evening.txt.
- Both decks are 16:9, which is 12192000 by 6858000 EMU in ppt/presentation.xml.
- Every slide after the first keeps its text in one text box.
- The 8A term report has 5 slides, with pupils in roster order.
- The comments file has one line per pupil, in roster order.
- The output check throws for a saved deck with an empty slide and names that slide.
If the output check has no method of its own that takes a saved deck, add one.
Write test decks to a temp folder, not to out/.
Run dotnet test, then give me the pass and fail totals.
Slide.Width e Slide.Height retornaram valores vazios em um novo deck e em um deck 16:9 aberto, então o teste de tamanho lê ppt/presentation.xml.
O que os prompts produziram em uma execução real?
Cada build e inspeção abaixo foram repetidos em um novo build de Release de cada commit que mudou o código, e um script separado leu cada deck salvo.
- Antes da mudança, o deck do Open XML SDK correspondeu a todas as 8 linhas do roteiro aprovado.
- Após a mudança para IronPPT, o deck de relatório de período também correspondeu a todas as 8 linhas.
- O deck migrado manteve slides 16:9 de 12192000 por 6858000 EMU ao abrir o template da escola.
- O Cursor preencheu o slide de título do template, então o deck 7B continha 8 slides e nenhum slide em branco.
- Cada slide de aluno continha seu texto em uma única caixa de texto de 1905000 por 1270000 EMU sem posição própria.
- O deck do Open XML SDK continha 6 slides de notas, e o deck do IronPPT não continha nenhum.
- Os seis comentários do professor foram para 7B-term-report.comments.txt, uma linha por aluno na ordem da lista.
- Cursor respondeu as cinco perguntas de documentação das páginas citadas e não alterou nenhum arquivo.
- Cursor não encontrou página que declare onde PresentationDocument.AddText coloca seu texto.
- Para o tamanho do slide, Cursor citou Slide.Width e Slide.Height. Essa resposta estava incorreta.
- A verificação de saída rejeitou uma lista com uma entrada de aluno vazia, imprimiu "slide 2 não tem texto" e saiu com código 3.
- Antes da correção, o deck da noite coincidiu com 0 de 7 linhas e usou slides 4:3.
- Após a correção, o deck da noite coincidiu com 7 de 7 linhas em slides 16:9.
- As contagens de coincidência que Cursor relatou concordaram com verificações independentes em ambos os decks.
- A suíte xUnit passou em 9 de 9 testes, que cobriam os sete casos solicitados.
- Cada build de Release teve 0 erros, e o projeto de teste adicionou 1 aviso do analisador xUnit.
- Alguns passos foram executados de forma diferente da página. Todos os sete prompts passaram pelo Cursor CLI em uma única sessão sem cabeça. O CLI ignorou perguntas do Cursor sobre notas do orador no prompt 03 e sobre saída de erro no prompt 05. Os prompts 05 a 07 foram executados no Modo de Planejamento quando a sessão retomou, então uma mensagem de acompanhamento, "Construa o plano.", executou cada plano. Para a diferença no prompt 04, o Cursor comparou os roteiros com o arquivo esperado em vez de mostrar a mudança de código.
O guia do GitHub Copilot limita parte de suas convenções do IronPPT aos projetos de origem e teste com um arquivo de instruções específico para o caminho, conforme os globs aqui. O guia Claude Code também aprova um plano antes que seu gerador de deck seja escrito. O registro de execução lista a versão do Cursor, modelo e duração desta execução, e a máquina de teste.
Solução de problemas
- Como adicionar slides quando um deck gerado começa com um slide em branco
- Classe TextBox quando as linhas de um slide se sobrepõem
- Como gerenciar slides quando um slide deve ser removido ou ocultado
- Usando chaves de licença quando o código gerado lança uma exceção de licença na gravação
Questões?
Se você tiver dúvidas, entre em contato com support@ironsoftware.com
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.