Wie man IronPPT mit Cursor verwendet
Wenn ein KI-Agent einen C#-Berichtsdeck-Generator vom Open XML SDK zu IronPPT verschiebt, indem er jeden Folienaufruf direkt übersetzt, unterscheidet sich das neue Deck vom alten. Das Open XML SDK beginnt mit einem leeren Paket. Ein neues IronPPT PresentationDocument enthält bereits eine Folie, sodass ein direkter Port, der eine Titelfolie und eine Folie pro Schüler hinzufügt, ein Deck speichert, dessen erste Folie leer ist. In unseren Tests produzierte derselbe Port auch 4:3-Folien, wo der alte Generator 16:9 schrieb.
Cursor ist ein KI-Code-Editor, der auf der VS Code-Codebasis aufgebaut ist, mit einem Agenten, der Dateien bearbeitet und Befehle ausführt. Die folgende Migration nutzt zwei seiner Funktionen, die Dokumentationslinks, die der Agent liest und die Projektregeln, die in .cursor/rules festgelegt sind. Es verschiebt einen Berichtsdeck-Generator einer Schule zu IronPPT. Der Generator erstellt pro Klasse ein Berichtsdeck aus einer Namensliste, mit einer Titelfolie, einer Folie pro Schüler und einer Abschlussfolie, und das migrierte Deck muss jede genehmigte Textzeile der Schule beibehalten.
Für die beteiligten Aufrufe siehe den Folie hinzufügen-Leitfaden und den Text hinzufügen-Leitfaden.
SchnellstartÖffnen Sie das ReportDecks-Repository und fügen Sie diesen Prompt in einen neuen Agenten-Chat ein.
@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.
Fügen Sie den Lizenzschlüssel nicht in einen Chat ein, wo der Agent ihn in eine Quelldatei, einen Commit oder ein Build-Log kopieren könnte. IronPPT 2026.10.1 liest IRONPPT_LICENSE_KEY nicht selbstständig. Es sucht nach einer Einstellung namens IronPPT.LicenseKey in der Umgebung oder der Anwendungs-Konfiguration, weshalb der Prompt License.LicenseKey im Code setzt. Ohne Schlüssel funktionierte der Aufbau von Folien im Speicher und das Lesen eines Decks, und Save warf eine LicensingException, bevor die Datei geschrieben wurde. Der Lizenzschlüssel-Leitfaden beschreibt, wo der Schlüssel stattdessen gespeichert werden soll.
Minimaler Arbeitsablauf (5 Schritte)
- Laden Sie die C# PowerPoint-Bibliothek von NuGet herunter
- Fügen Sie eine Projektregel unter .cursor/rules hinzu, die den Dokumentationslink von IronPPT enthält.
- Vermerken Sie in der Regel, dass ein neues Deck bereits eine Folie enthält und 4:3 verwendet.
- Beziehen Sie sich in jeder Anfrage auf den Deck-Code und das genehmigte Schema.
- Vergleichen Sie jedes gespeicherte Deck mit diesem Schema und bestätigen Sie dann jeden Mitgliedsnamen in der API Referenz
Welches Cursor-Modell sollten Sie für IronPPT-Arbeiten verwenden?
Composer ist Cursors eigenes agentisches Modell. Der Modellwähler bietet auch die Grok-Modelle von SpaceXAI, die Cursor mitentwickelt hat, sowie Modelle von OpenAI, Anthropic, Google und anderen Laboren. Der folgende Testrun nutzte Composer 2.5.
Wie geben Sie Cursor die IronPPT-Dokumentation?
Fügen Sie den Dokumentationslink von IronPPT in die Anfrage ein oder speichern Sie ihn in einer Regel, die das gesamte Team teilt. IronPPT's llms.txt listet jeden Leitfaden und die API-Referenz, und llms-full.txt fasst 16 Dokumentationsseiten in einer einzigen Datei zusammen. Ab Oktober 2026 verbindet Cursor's @-Menü Dateien, Ordner, Terminals, Chats, Git-Diffs und den Browser, sodass die Anfrage dem Agenten die Dokumentation von IronPPT als Link gibt.
Der Folien-Hinzufügen-Leitfaden weist darauf hin, dass eine neue Präsentation bereits eine leere Folie enthält. IronPPT's skill.md nennt dasselbe Objekt eine neue, leere Präsentation, und keine Seite, auf die llms.txt verweist, gibt die Foliengröße eines neuen Decks an.
@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.
Wie schreiben Sie Projektregeln, die Ihre IronPPT-Konventionen codieren?
Eine Projektregel ist eine .mdc-Datei, die in .cursor/rules gespeichert und mit dem Repository versioniert wird. Cursor ignoriert eine einfache .md-Datei in diesem Ordner, da eine Datei ohne Frontmatter ihm keine Möglichkeit gibt, zu entscheiden, wann die Regel geladen werden soll.
Die folgende Regel listet ihre Dateimuster in globs auf, getrennt durch Kommas, wie auf Cursor's Regeln-Seite angegeben, und setzt alwaysApply auf false. Cursor lädt sie dann für Anfragen, die den Deck-Code oder die Tests betreffen. Speichern Sie sie als .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.
Regeln gelten für Agent-Anfragen. Auf Cursor's Regeln-Seite steht, dass Regeln Tab nicht beeinflussen und dass Benutzerregeln nicht auf Inline-Bearbeitungen angewendet werden, sodass Sie diese Vorschläge manuell im Vergleich zur Regel überprüfen sollte.
Wie ordnen Sie Aufrufe des Open XML SDK an IronPPT zu?
Das Open XML SDK schreibt ein Paket Stück für Stück, sodass der alte Generator auch den Folienmaster, das Layout, das Theme und den Notizen-Master erstellt. IronPPT erstellt diese Teile selbst.
| Open XML SDK | IronPPT |
|---|---|
PresentationDocument.Create mit einem Präsentationsteil, Master, Layout und Theme | new PresentationDocument(), oder der Konstruktor mit einem Template-Pfad |
Ein SlidePart zum Präsentationsteil hinzugefügt und in SlideIdList aufgelistet | AddSlide(new Slide()), das die Folie anhängt |
Titel- und Hauptplatzhalter gefüllt mit A.Paragraph und A.Run | Slide.AddChild mit einem TextBox, ein Paragraph pro Zeile |
| Text in einem vorhandenen Platzhalter | Texts[i].Text auf einer Folie der geladenen Vorlage |
SlideSize auf 12192000 mal 6858000 gesetzt | Kein Äquivalent, daher stammt die Größe aus der Vorlage |
Ein NotesSlidePart pro Folie | Kein Äquivalent |
Save zu einer Datei oder einem beliebigen Stream | Save(string), nur ein Dateipfad |
IronPPT.dll enthält seine eigene Kopie der Open XML SDK-Typen, alle intern, sodass das Projekt mit beiden während der Migration referenzierten Paketen gebaut wurde.
Warum beginnt ein neues IronPPT-Deck mit einer zusätzlichen Folie?
Die eingebaute Folie eines neuen PresentationDocument verwendet ein Titellayout, dessen Titel- und Untertitelplatzhalter leer sind. AddSlide fügt sich danach ein und gibt die ihm gegebene Folie zurück, sodass jede Folie eines direkten Ports an einer Position später als im genehmigten Schema erscheint.
Das Entfernen dieser Folie zu früh schlägt fehl. Remove darauf aufzurufen, während es die einzige Folie ist, warf eine InvalidOperationException, die besagt, dass eine Präsentation mindestens eine Folie enthalten muss. Sobald eine zweite Folie existierte, funktionierte derselbe Aufruf.
Die Foliengröße ist der zweite Unterschied. Ein neues Deck maß 9144000 mal 6858000 EMU, eine 4:3-Folie. Die API-Referenz dokumentiert Slide.Width und Slide.Height mit einem Beispiel, das die Breite auf 960 Punkte setzt, aber keine der Eigenschaften ändert die Foliengröße des Decks. Ihr Setzen auf 960 mal 540 Punkte schrieb 12192000 mal 6858000 EMU in die Ausdehnungen der Formen der Folie und ließ die Foliengröße in ppt/presentation.xml bei 9144000 mal 6858000 EMU. Ein aus einer 16:9-Datei geladenes Deck behielt 12192000 mal 6858000 EMU durch das Speichern, zusammen mit seinen Platzhaltern und Notizen. Das Repository bewahrt daher die Titelfolie der Schule in TestData/templates/hollybrook-16x9.pptx auf.
Wie planen und führen Sie eine Migration zu IronPPT durch?
Drücken Sie Shift+Tab im Chat-Eingabefeld, bis der Planmodus ausgewählt ist, und senden Sie dann die folgende Anfrage. Cursor schreibt den Plan als bearbeitbare Markdown-Datei.
@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.
Korrigieren Sie eventuelle Fehler im Plan. Dann bauen Sie den Plan im Planmodus, oder wechseln Sie zurück zu Agent und senden Sie diese Anfrage.
@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.
Die @ironppt-decks-Erwähnung hängt die Regel nach Name an.
Welches Cursor-Feature passt zu jeder Änderung?
Wählen Sie ein Feature basierend auf dem Umfang der Änderung. Tab vervollständigt eine Bearbeitung, die der Entwickler begonnen hat. Für eine Auswahl, die ein Satz beschreiben kann, verwenden Sie die Inline-Bearbeitung (Strg+K). Agent bearbeitet Änderungen über mehrere Dateien hinweg und Arbeiten, die einen Build erfordern, und der Planmodus fügt einen Plan zur Überprüfung hinzu, bevor Agent Code ändert.
Senden Sie diese Anfrage an Agent. Es nennt die Methode, die es ändert, daher ist keine Auswahl im Editor erforderlich.
@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.
Wie platziert IronPPT den Text, den eine Folie hinzufügt?
Fünf Slide.AddText-Aufrufe auf einer Folie produzierten fünf Formen von 1905000 mal 1270000 EMU auf demselben Körperplatzhalter. Der AI Agents Hub erklärt, warum solche Formen eine Position teilen. Ein TextBox, das einen Paragraph pro Zeile hält, gibt einer Form die Linien in Reihenfolge. Eine Umrissprüfung erkennt keine Box von Standardgröße, da sie nur den Text liest.
PresentationDocument.AddText verhält sich anders als die Folienmethode. Es fügte seinen Text als neuen Lauf am Ende des letzten Absatzes der letzten Folie hinzu, ohne Leerzeichen oder Zeilenumbruch. Zurückgelesen durch Slide.Texts erscheinen die beiden Läufe als separate Elemente. Slide.Paragraphs gibt die Zeile zurück, die ein Betrachter sieht, weshalb der Inspektionsbefehl Absätze liest.
Wie debuggen Sie das Deck, das IronPPT bereits schreibt?
Das Deck des Elternabends verwendete bereits vor der Migration IronPPT.
@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.
Ausgabe
Die folgenden Zeichnungen zeigen eine Terminfestlegung auf der Folie des Decks vor der Korrektur und eine des Decks danach.

Folie 3 des Elternabend-Decks vor der Korrektur, gezeichnet aus dem XML der gespeicherten Datei. Die 4:3-Folie enthält zwei Textformen an derselben Position. Die Zeichnung zeigt die gespeicherte Geometrie, nicht das Rendern in PowerPoint.

Folie 2 des Elternabend-Decks nach der Korrektur, gezeichnet aus dem XML der gespeicherten Datei. Die 16:9-Folie enthält ein Textfeld mit 1905000 mal 1270000 EMU. Die Zeichnung zeigt die gespeicherte Geometrie, nicht das Rendern in PowerPoint.
Wie schreiben Sie Regressionstests für die 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 und Slide.Height gaben leere Werte für ein neues Deck und für ein geöffnetes 16:9-Deck zurück, deshalb liest der Größentest ppt/presentation.xml.
Was haben die Aufforderungen in einem realen Lauf erzeugt?
Jedes Build und jede Inspektion unten wurde auf einem frischen Release-Build jedes Commits wiederholt, das den Code änderte, und ein separates Skript las jedes gespeicherte Deck.
- Vor dem Umzug entsprach das Open XML SDK-Deck allen 8 Zeilen des genehmigten Schemas.
- Nach dem Umzug zu IronPPT entsprach das Term-Berichts-Deck ebenfalls allen 8 Zeilen.
- Das migrierte Deck behielt 16:9-Folien von 12192000 mal 6858000 EMU bei, indem es die Vorlage der Schule öffnete.
- Cursor füllte die Titelfolie der Vorlage aus, sodass das 7B-Deck 8 Folien und keine leere Folie enthielt.
- Jede Schülerfolie beinhaltete ihren Text in einem einzigen 1905000 mal 1270000 EMU-Textfeld ohne eigene Position.
- Das Open XML SDK-Deck enthielt 6 Notizfolien, und das IronPPT-Deck enthielt keine.
- Die sechs Betreuerkommentare gingen an 7B-term-report.comments.txt, eine Zeile pro Schüler in Namenslistenreihenfolge.
- Cursor beantwortete die fünf Dokumentationsfragen von zitierten Seiten und änderte keine Dateien.
- Cursor fand keine Seite, die angibt, wo PresentationDocument.AddText seinen Text platziert.
- Für die Foliengröße zitierte Cursor Slide.Width und Slide.Height. Diese Antwort war falsch.
- Die Ausgabeprüfung lehnte eine Namensliste mit einem leeren Schülerfeld ab, druckte „Folie 2 hat keinen Text“ und beendete mit Code 3.
- Vor der Behebung entsprach das Abenddeck 0 von 7 Zeilen und verwendete 4:3-Folien.
- Nach der Korrektur entsprach das Abenddeck 7 von 7 Zeilen auf 16:9-Folien.
- Die von Cursor gemeldeten Übereinstimmungen stimmten mit den unabhängigen Überprüfungen auf beiden Decks überein.
- Die xUnit-Suite bestand 9 von 9 Tests, die die sieben angeforderten Fälle abdeckten.
- Jeder Release-Build hatte 0 Fehler, und das Testprojekt fügte eine xUnit-Analysatorwarnung hinzu.
- Einige Schritte liefen anders als die Seite. Alle sieben Prompts wurden in einer kopflosen Sitzung über das Cursor-CLI durchgeführt. Das CLI übersprang Fragen von Cursor zu Referentennotizen in Prompt 03 und zu Fehlerausgaben in Prompt 05. Prompts 05 bis 07 liefen im Planmodus, nachdem die Sitzung fortgesetzt wurde, sodass eine Folge-Nachricht „Baue den Plan.“ jeden Plan ausführte. Für den Unterschied in Prompt 04 verglich Cursor die Umrisse mit der erwarteten Datei anstatt die Codeänderung zu zeigen.
Der GitHub Copilot Leitfaden beschränkt einen Teil seiner IronPPT-Konventionen auf die Quelle und Testprojekte mit einer pfadabhängigen Anleitungsdatei, wie es die Globs hier tun. Der Claude Code Leitfaden genehmigt auch einen Plan, bevor sein Deckgenerator geschrieben wird. Der Laufrekord listet die Cursor-Version, das Modell und die Dauer dieses Laufs und die Testmaschine.
Fehlerbehebung
- Wie man Folien hinzufügt, wenn ein generiertes Deck mit einer leeren Folie beginnt
- TextBox-Klasse, wenn sich die Zeilen einer Folie überschneiden
- Wie man Folien verwaltet, wenn eine Folie entfernt oder versteckt werden muss
- Verwendung von Lizenzschlüsseln, wenn generierter Code bei der Speicherung eine Lizenzierungsausnahme wirft
Fragen?
Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.