Comment utiliser IronPPT avec Cursor

Curtis Chau
Curtis Chau
Mis à jour : 19 octobre 2026

Lorsqu'un agent IA déplace un générateur de présentations de rapports C# du SDK Open XML vers IronPPT en traduisant directement chaque appel de diapositive, la nouvelle présentation diffère de l'ancienne. Le SDK Open XML commence avec un package vide. Un nouvel IronPPT PresentationDocument contient déjà une diapositive, de sorte qu'un port direct qui ajoute une diapositive de titre et une diapositive par élève sauvegarde une présentation dont la première diapositive est vide. Dans nos tests, le même port a également produit des diapositives au format 4:3 là où l'ancien générateur écrivait du 16:9.

Cursor est un éditeur de code IA basé sur VS Code, avec un agent qui édite les fichiers et exécute des commandes. La migration ci-dessous utilise deux de ses fonctionnalités, les liens de documentation lus par l'agent et les règles de projet engagées dans .cursor/rules. Il déplace un générateur de présentations de rapports d'une école vers IronPPT. Le générateur crée une présentation de rapport de période par classe à partir d'un fichier de liste, avec une diapositive de titre, une diapositive par élève et une diapositive de clôture, et la présentation migrée doit conserver chaque ligne de texte approuvée par l'école.

Pour les appels concernés, voir le guide d'ajout de diapositives et le guide d'ajout de texte.

Démarrage rapide
NuGetInstaller avec NuGet

PM > Install-Package IronPPT

Installez IronPPT en exécutant la commande ci-dessus dans la console du gestionnaire de packages NuGet, ou recherchez le package dans le gestionnaire de packages NuGet.

Avec le dépôt ReportDecks ouvert, collez cette invite dans une nouvelle conversation d'agent.

@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.
Text

Ne collez pas la clé de licence dans une conversation, où l'agent pourrait la copier dans un fichier source, un commit ou un journal de build. IronPPT 2026.10.1 ne lit pas IRONPPT_LICENSE_KEY par lui-même. Il recherche un paramètre nommé IronPPT.LicenseKey dans l'environnement ou la configuration de l'application, c'est pourquoi l'invite définit License.LicenseKey dans le code. Sans clé, construire des diapositives en mémoire et lire une présentation a fonctionné, et Save a déclenché une LicensingException avant d'écrire le fichier. Le guide de la clé de licence décrit où stocker la clé à la place.



Quel modèle Cursor devriez-vous utiliser pour travailler avec IronPPT ?

Composer est le propre modèle agentique de Cursor. Le sélecteur de modèle offre également les modèles Grok de SpaceXAI, que Cursor a co-développés, ainsi que des modèles d'OpenAI, Anthropic, Google et d'autres laboratoires. Le test ci-dessous a utilisé Composer 2.5.

Comment fournir la documentation d'IronPPT à Cursor ?

Incluez le lien de documentation d'IronPPT dans la demande, ou stockez-le dans une règle partagée par toute l'équipe. Le llms.txt d'IronPPT liste chaque guide et la référence API, et llms-full.txt condense 16 pages de documentation en un seul fichier. Depuis octobre 2026, le menu @ de Cursor permet de joindre des fichiers, dossiers, terminaux, discussions, différences Git et le navigateur, donc la demande fournit à l'agent la documentation d'IronPPT sous forme de lien.

Le guide d'ajout de diapositives indique qu'une nouvelle présentation contient déjà une diapositive vide. Le skill.md d'IronPPT appelle le même objet une nouvelle présentation vide, et aucune page liée par llms.txt n'indique la taille de la diapositive d'une nouvelle présentation.

@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.
Text

Comment écrire des règles de projet qui codifient vos conventions IronPPT ?

Une règle de projet est un fichier .mdc stocké dans .cursor/rules et versionné avec le dépôt. Cursor ignore un fichier .md ordinaire dans ce dossier, car un fichier sans frontmatter ne lui fournit pas les moyens de décider quand charger la règle.

La règle ci-dessous liste ses modèles de fichiers dans globs, séparés par des virgules comme spécifié dans la page des règles de Cursor, et définit alwaysApply sur false. Cursor la charge ensuite pour les demandes impliquant le code de la présentation ou les tests. Enregistrez-la sous .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.
Markdown
Veuillez noter: Cursor lit également AGENTS.md à la racine ou dans n'importe quel sous-dossier. Ce fichier n'a pas de métadonnées initiales et pas de modèles de fichiers, donc une règle qui dépend des motifs globaux appartient à .cursor/rules.

Les règles s'appliquent aux demandes Agent. La page des règles de Cursor indique que les règles n'affectent pas Tab et que les règles utilisateur ne sont pas appliquées aux modifications en ligne, donc vérifiez manuellement ces suggestions par rapport à la règle.

Comment mapper les appels du SDK Open XML à IronPPT ?

Le SDK Open XML écrit un package partie par partie, donc l'ancien générateur crée également le maître des diapositives, la disposition, le thème et le maître des notes. IronPPT crée ces parties lui-même.

Open XML SDKIronPPT
PresentationDocument.Create avec une partie de la présentation, maître, disposition et thèmenew PresentationDocument(), ou le constructeur avec un chemin de modèle
Un SlidePart ajouté à la partie présentation et listé dans SlideIdListAddSlide(new Slide()), qui ajoute la diapositive
Espaces réservés de titre et de corps remplis avec A.Paragraph et A.RunSlide.AddChild avec un TextBox, un Paragraph par ligne
Texte dans un espace réservé existantTexts[i].Text sur une diapositive du modèle chargé
SlideSize défini sur 12192000 par 6858000Pas d'équivalent, donc la taille vient du modèle
Un NotesSlidePart par diapositiveAucun équivalent
Save vers un fichier ou tout StreamSave(string), seulement un chemin de fichier

IronPPT.dll incorpore sa propre copie des types du SDK Open XML, tous internes, donc le projet est construit avec les deux packages référencés pendant la migration.

Pourquoi une nouvelle présentation IronPPT commence-t-elle avec une diapositive supplémentaire ?

La diapositive intégrée d'un nouveau PresentationDocument utilise une mise en page de titre dont les espaces réservés de titre et de sous-titre sont vides. AddSlide s'ajoute après cela et retourne la diapositive qui lui a été donnée, de sorte que chaque diapositive d'un port direct apparaît une position plus tard que dans le plan approuvé.

Supprimer cette diapositive trop tôt échoue. Appeler Remove alors qu'elle est la seule diapositive a déclenché une InvalidOperationException indiquant qu'une présentation doit contenir au moins une diapositive. Une fois qu'une deuxième diapositive a existé, le même appel a réussi.

La taille de la diapositive est la deuxième différence. Une nouvelle présentation mesurait 9144000 par 6858000 EMU, une diapositive au format 4:3. La référence API documente Slide.Width et Slide.Height avec un exemple qui fixe la largeur à 960 points, mais aucune propriété ne change la taille de la diapositive de la présentation. Les définir sur 960 par 540 points écrivait 12192000 par 6858000 EMU dans les dimensions des formes de la diapositive et laissait la taille de la diapositive dans ppt/presentation.xml à 9144000 par 6858000 EMU. Une présentation chargée à partir d'un fichier 16:9 conservait 12192000 par 6858000 EMU après la sauvegarde, avec ses espaces réservés et ses notes. Le dépôt conserve donc la diapositive de titre de l'école dans TestData/templates/hollybrook-16x9.pptx.

Comment planifier et exécuter une migration vers IronPPT ?

Appuyez sur Maj+Tab dans la saisie de chat jusqu'à ce que le mode Plan soit sélectionné, puis envoyez la demande ci-dessous. Cursor écrit le plan sous forme de fichier Markdown éditable.

@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.
Text

Corrigez les erreurs dans le plan. Ensuite, construisez le plan en mode Plan, ou revenez à Agent et envoyez cette demande.

@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.
Text

La mention @ironppt-decks attache la règle par nom.

Quel élément de Cursor convient à chaque changement ?

Sélectionnez une fonctionnalité basée sur l'ampleur du changement. Tab complète une modification que le développeur a commencée. Pour une sélection qu'une phrase peut décrire, utilisez l'édition en ligne (Ctrl+K). Agent gère les modifications sur plusieurs fichiers et les travaux nécessitant un build, et le mode Plan ajoute un plan à examiner avant qu'Agent ne modifie le code.

Envoyez cette demande dans Agent. Il nomme la méthode à laquelle il apporte des modifications, donc aucune sélection n'est nécessaire dans l'éditeur.

@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.
Text

Comment IronPPT place-t-il le texte qu'une diapositive ajoute ?

Cinq appels Slide.AddText sur une diapositive ont produit cinq formes de 1905000 par 1270000 EMU sur le même espace réservé de corps. Le hub des agents IA explique pourquoi ces formes partagent une position. Un TextBox qui contient un Paragraph par ligne donne une forme avec les lignes dans l'ordre. Un contrôle de l'outline ne détecte pas une boîte laissée à la taille par défaut, car il ne lit que le texte.

PresentationDocument.AddText se comporte différemment de la méthode de diapositive. Il a ajouté son texte comme une nouvelle course à la fin du dernier paragraphe de la dernière diapositive, sans espace ni saut de ligne. Relisant via Slide.Texts, les deux courses apparaissent comme des éléments séparés. Slide.Paragraphs renvoie la ligne qu'un spectateur voit, c'est pourquoi la commande d'inspection lit les paragraphes.

Comment déboguer la présentation qu'IronPPT écrit déjà ?

La présentation de la soirée des parents utilisait déjà IronPPT avant la migration.

@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.
Text

Sortie

Les dessins ci-dessous montrent une diapositive de rendez-vous de la présentation avant la correction et une après.

Diapositive 3 de la présentation de la soirée des parents avant la correction, une diapositive 4:3 avec deux formes de texte superposées

Diapositive 3 de la présentation de la soirée des parents avant la correction, dessinée à partir de l'XML du fichier sauvegardé. La diapositive 4:3 contient deux formes de texte à la même position. Le dessin montre la géométrie stockée, pas un rendu PowerPoint.

Diapositive 2 de la présentation de la soirée des parents après la correction, une diapositive 16:9 avec une petite boîte de texte

Diapositive 2 de la présentation de la soirée des parents après la correction, dessinée à partir de l'XML du fichier sauvegardé. La diapositive 16:9 contient une boîte de texte de 1905000 par 1270000 EMU. Le dessin montre la géométrie stockée, pas un rendu PowerPoint.

Comment écrire des tests de régression pour les présentations ?

@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.
Text

Slide.Width et Slide.Height ont renvoyé des valeurs vides sur une nouvelle présentation et sur une présentation 16:9 ouverte, donc le test de taille lit ppt/presentation.xml.

Qu'est-ce que les messages ont produit lors d'une réelle exécution ?

Chaque construction et inspection ci-dessous a été répétée sur une nouvelle construction de Release de chaque commit ayant modifié le code, et un script séparé a lu chaque présentation sauvegardée.

  • Avant le déplacement, la présentation SDK Open XML correspondait aux 8 lignes du plan approuvé.
  • Après le déplacement vers IronPPT, la présentation de rapport de période correspondait également aux 8 lignes.
  • La présentation migrée conservait des diapositives 16:9 de 12192000 par 6858000 EMU en ouvrant le modèle de l'école.
  • Cursor remplissait la diapositive de titre du modèle, donc la présentation 7B contenait 8 diapositives et aucune diapositive vide.
  • Chaque diapositive d'élève contenait son texte dans une seule boîte de texte de 1905000 par 1270000 EMU sans position propre.
  • La présentation SDK Open XML contenait 6 diapositives de notes, et la présentation IronPPT n'en contenait aucune.
  • Les six commentaires des tuteurs sont allés à 7B-term-report.comments.txt, une ligne par élève, dans l'ordre de la liste.
  • Cursor a répondu aux cinq questions de documentation à partir des pages citées et n'a modifié aucun fichier.
  • Cursor n'a trouvé aucune page indiquant où PresentationDocument.AddText place son texte.
  • Pour la taille de la diapositive, Cursor a cité Slide.Width et Slide.Height. Cette réponse était incorrecte.
  • La vérification de la sortie a rejeté une liste avec une entrée d'élève vide, imprimé "la diapositive 2 n'a pas de texte" et s'est terminée avec le code 3.
  • Avant sa correction, la présentation de soirée correspondait à 0 des 7 lignes et utilisait des diapositives 4:3.
  • Après la correction, la présentation de soirée correspondait à 7 des 7 lignes sur des diapositives 16:9.
  • Les décomptes de correspondance signalés par Cursor étaient conformes aux vérifications indépendantes sur les deux présentations.
  • La suite xUnit a réussi 9 des 9 tests, qui couvraient les sept cas demandés.
  • Chaque construction de Release comportait 0 erreurs, et le projet de test ajoutait 1 avertissement de l'analyseur xUnit.
  • Certaines étapes ont été exécutées différemment de la page. Les sept invites ont traversé le CLI Cursor dans une session sans tête. Le CLI a passé les questions de Cursor sur les notes des présentateurs dans l'invite 03 et sur la sortie d'erreur dans l'invite 05. Les invites 05 à 07 ont été exécutées en mode Plan lorsque la session a repris, donc un message de suivi, "Construire le plan.", a réalisé chaque plan. Pour la différence dans l'invite 04, Cursor a comparé les plans avec le fichier attendu au lieu de montrer la modification du code.

Le guide GitHub Copilot limite une partie de ses conventions IronPPT aux projets source et test avec un fichier d'instructions spécifique au chemin, comme le font les motifs ici. Le guide Claude Code approuve également un plan avant que son générateur de présentations ne soit écrit. Le journal d'exécution répertorie la version de Cursor, le modèle et la durée de cette exécution, ainsi que la machine de test.


Dépannage


Des questions ?

Si vous avez des questions, contactez support@ironsoftware.com

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 7,110Version :2026.11tout juste publié