Jak korzystać z IronPPT z Cursor
Gdy agent AI przenosi generator talii raportów C# z Open XML SDK do IronPPT, tłumacząc bezpośrednio każde wywołanie slajdu, nowa talia różni się od starej. Open XML SDK zaczyna od pustego pakietu. Nowy IronPPT PresentationDocument już zawiera jeden slajd, więc bezpośredni port, który dodaje slajd tytułowy oraz jeden slajd na ucznia, zapisuje talię, której pierwszy slajd jest pusty. W naszych testach ten sam port również generował slajdy 4:3, gdzie stary generator tworzył 16:9.
Cursor to edytor kodu AI zbudowany na bazie kodu VS, z agentem, który edytuje pliki i wykonuje polecenia. Migracja poniżej wykorzystuje dwie jego funkcje: łącza do dokumentacji, które agent czyta, oraz reguły projektu zapisane w .cursor/rules. Przenosi generator talii raportów szkoły do IronPPT. Generator buduje jedną talię raportów na semestr na klasę z pliku z listą, z slajdem tytułowym, jednym slajdem na ucznia i zamykającym slajdem. Migrowana talia musi zachować każdą linię tekstu zatwierdzonego przez szkołę.
Dla wywołań związkowych, zobacz przewodnik dodawania slajdów i przewodnik dodawania tekstu.
Szybki startGdy repozytorium ReportDecks jest otwarte, należy wkleić ten prompt do nowego czatu Agenta.
@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.
Nie należy wklejać klucza licencyjnego do czatu, gdzie agent może go skopiować do pliku źródłowego, zatwierdzenia lub dziennika budowy. IronPPT 2026.10.1 nie czyta IRONPPT_LICENSE_KEY samodzielnie. Wyszukuje ustawienie o nazwie IronPPT.LicenseKey w środowisku lub konfiguracji aplikacji, dlatego prompt ustawia License.LicenseKey w kodzie. Bez klucza budowanie slajdów w pamięci i czytanie talii działało, a Save wyrzucało LicensingException przed zapisem pliku. Przewodnik dotyczący kluczy licencyjnych opisuje, gdzie należy ich przechowywać zamiast tego.
Minimalny proces (5 kroków)
- Pobierz bibliotekę PowerPoint dla C# z NuGet
- Dodaj regułę projektu w .cursor/rules, która zawiera link do dokumentacji IronPPT
- Zarejestruj w regule, że nowa talia już zawiera jeden slajd i używa 4:3
- Odniesienia do kodu talii i zatwierdzonego konspektu w każdej prośbie
- Porównaj każdą zapisaną talię z tym konspektem, a następnie potwierdź każdą nazwę członka w dokumentacji API
Jakiego modelu Cursor powinieneś używać do pracy z IronPPT?
Composer to własny agentyczny model Cursor. Wybór modelu oferuje także modele SpaceXAI Grok, które Cursor współtworzył, oraz modele od OpenAI, Anthropic, Google i innych laboratoriów. Poniższe uruchomienie testowe używało Composer 2.5.
Jak przekazać Cursor dokumentację IronPPT?
Uwzględnij link do dokumentacji IronPPT w prośbie lub przechowuj go w regule, którą współdzieli cały zespół. llms.txt IronPPT wylistowuje każdy przewodnik i dokumentację API, a llms-full.txt kondensuje 16 stron dokumentacji do jednego pliku. Od października 2026 menu @ Cursor dołącza pliki, foldery, terminale, czaty, różnice Git i przeglądarkę, więc prośba przekazuje agentowi dokumentację IronPPT jako link.
Przewodnik dodawania slajdów zauważa, że nowa prezentacja zawiera już pusty slajd. skill.md IronPPT nazywa ten sam obiekt nową, pustą prezentacją, i żadna strona, do której llms.txt prowadzi, nie podaje rozmiaru slajdu nowej talii.
@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.
Jak pisać reguły projektu, które kodują konwencje IronPPT?
Reguła projektu to plik .mdc zapisany w .cursor/rules i wersjonowany z repozytorium. Cursor ignoruje zwykły plik .md w tym folderze, ponieważ plik bez nagłówka nie daje mu sposobu na podjęcie decyzji, kiedy załadować regułę.
Poniższa reguła wymienia swoje wzorce plików w globs, oddzielone przecinkami, jak określono na stronie reguł Cursor, i ustawia alwaysApply na false. Cursor następnie ją ładuje dla żądań dotyczących kodu talii lub testów. Zapisz jako .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.
Zasady mają zastosowanie do żądań Agenta. Strona reguł Cursor stwierdza, że reguły nie wpływają na Tab i że reguły użytkownika nie są stosowane do edycji inline, więc zweryfikuj te sugestie ręcznie w stosunku do reguły.
Jak mapujesz wywołania Open XML SDK do IronPPT?
Open XML SDK zapisuje pakiet część po części, więc stary generator tworzy również szablon slajdu, układ, motyw i szablon notatek. IronPPT tworzy te części samodzielnie.
| Open XML SDK | IronPPT |
|---|---|
PresentationDocument.Create z częścią prezentacji, szablonem, układem i motywem | new PresentationDocument(), lub konstruktorem z ścieżką do szablonu |
A SlidePart dodany do części prezentacji i wylistowany w SlideIdList | AddSlide(new Slide()), który dodaje slajd |
Tytuł i treść wypełnione przez A.Paragraph i A.Run | Slide.AddChild z TextBox, jedne Paragraph na linię |
| Tekst w istniejącym zarezerwowanym obszarze | Texts[i].Text na slajdzie załadowanego szablonu |
SlideSize ustawiony na 12192000 przez 6858000 | Brak odpowiednika, więc rozmiar pochodzi z szablonu |
A NotesSlidePart na slajd | Brak odpowiednika |
Save do pliku lub jakiegokolwiek Stream | Save(string), tylko ścieżka do pliku |
IronPPT.dll zawiera własną kopię typów Open XML SDK, wszystkie wewnętrzne, więc projekt zbudowany z obydwoma pakietami odniesionymi podczas migracji.
Dlaczego nowa talia IronPPT zaczyna się od dodatkowego slajdu?
Wbudowany slajd nowego PresentationDocument używa układu tytułu, którego zarezerwowane miejsca tytułu i podtytułu są puste. AddSlide dodaje się po nim i zwraca przekazany slajd, więc każdy slajd bezpośredniego portu pojawia się jedno miejsce później niż w zatwierdzonym konspekcie.
Usunięcie tego slajdu zbyt wcześnie powoduje błąd. Wywołanie Remove na nim, gdy jest jedynym slajdem, wywołało InvalidOperationException, stwierdzając, że prezentacja musi zawierać co najmniej jeden slajd. Gdy istnieje już drugi slajd, to samo wywołanie zakończyło się sukcesem.
Rozmiar slajdu to druga różnica. Nowa talia miała wymiary 9144000 na 6858000 EMU, slajd 4:3. Dokumentacja API opisuje Slide.Width i Slide.Height z przykładem, który ustawia szerokość na 960 punktów, ale żadna właściwość nie zmienia rozmiaru slajdu talii. Ustawienie ich na 960 na 540 punktów zapisało 12192000 na 6858000 EMU do rozmiarów kształtów slajdu i pozostawiło rozmiar slajdu w ppt/presentation.xml na 9144000 na 6858000 EMU. Talia załadowana z pliku 16:9 zachowała 12192000 na 6858000 EMU przez zapis, razem z zarezerwowanymi miejscami i notatkami. Repozytorium przechowuje więc slajd tytułowy szkoły w TestData/templates/hollybrook-16x9.pptx.
Jak planujesz i realizujesz migrację do IronPPT?
Nacisnąć Shift+Tab w polu wejściowym czatu, aż zostanie wybrany tryb planowania, a następnie przesłać poniższą prośbę. Cursor zapisuje plan jako edytowalny plik Markdown.
@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.
Poprawić wszystkie błędy w planie. Następnie zbudować plan w trybie planowania lub wrócić do agenta i przesłać tę prośbę.
@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.
Wzmianka @ironppt-decks dołącza regułę po nazwie.
Która funkcja Cursor pasuje do każdej zmiany?
Wybierz funkcję na podstawie zakresu zmiany. Tab kończy edycję, którą deweloper rozpoczął. Dla wyboru, której można opisać jednym zdaniem, użyj edycji inline (Ctrl+K). Agent obsługuje zmiany w wielu plikach i prace wymagające kompilacji, a tryb planowania dodaje plan do przeglądu przed wprowadzeniem zmian przez agenta.
Przesłać tę prośbę w agencie. Nazywa metodę, którą zmienia, więc nie wymaga wyboru w edytorze.
@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.
Jak IronPPT umieszcza tekst, który dodaje slajd?
Pięć Slide.AddText na jednym slajdzie wygenerowało pięć kształtów o wymiarach 1905000 na 1270000 EMU na tym samym zarezerwowanym obszarze treści. centrum agentów AI wyjaśnia, dlaczego takie kształty dzielą jedną pozycję. A TextBox, który trzyma jeden Paragraph na linię, daje jeden kształt z liniami w kolejności. Kontrola konspektu nie wykrywa pudełka pozostawionego w domyślnym rozmiarze, ponieważ czyta tylko tekst.
PresentationDocument.AddText zachowuje się inaczej niż metoda slajdowa. Dodało swój tekst jako nowy przebieg na końcu ostatniego akapitu ostatniego slajdu, bez spacji lub przerwy w linii. Odczytanie przez Slide.Texts, dwa przebiegi pojawiają się jako osobne elementy. Slide.Paragraphs zwraca linie widoczne dla widza, dlatego polecenie inspekcji czyta akapity.
Jak debugować talie, które IronPPT już pisze?
Talia na wieczorek dla rodziców już używała IronPPT przed migracją.
@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.
Wynik
Rysunki poniżej pokazują jeden slajd z harmonogramem z talii przed poprawką i jeden z talii po niej.

Slajd 3 z talii na wieczorek rodziców przed poprawką, rysowany z XML zapisanego pliku. Slajd 4:3 trzyma dwa kształty tekstu w tym samym miejscu. Rysunek pokazuje zapisane geometrie, a nie rendering PowerPoint.

Slajd 2 z talii na wieczorek rodziców po poprawce, rysowany z XML zapisanego pliku. Slajd 16:9 trzyma jedno pole tekstowe o wymiarach 1905000 na 1270000 EMU. Rysunek pokazuje zapisane geometrie, a nie rendering PowerPoint.
Jak pisać testy regresji dla talii?
@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 i Slide.Height zwróciły puste wartości na nowej talii i otwartej talii 16:9, więc test rozmiaru czyta ppt/presentation.xml.
Co wyprodukowały zapytania w rzeczywistym uruchomieniu?
Każda budowa i inspekcja poniżej była powtarzana na świeżej wersji Release każdego zatwierdzenia zmiany kodu, a oddzielny skrypt odczytywał każdą zapisaną talię.
- Przed przeniesieniem, talia Open XML SDK pasowała do wszystkich 8 linii zatwierdzonego konspektu.
- Po przeniesieniu do IronPPT talia raportów semestralnych również pasowała do wszystkich 8 linii.
- Migrowana talia zachowała slajdy 16:9 o wymiarach 12192000 na 6858000 EMU otwierając szablon szkoły.
- Cursor wypełnił slajd tytułowy szablonu, więc talia 7B miała 8 slajdów i brak pustego slajdu.
- Każdy slajd ucznia trzymał swój tekst w jednym polu tekstowym o wymiarach 1905000 na 1270000 EMU bez własnej pozycji.
- Talia Open XML SDK trzymała 6 slajdów notatek, a talia IronPPT nie miała żadnych.
- Sześć uwag korepetytorów poszło do 7B-term-report.comments.txt, po jednej linii na ucznia w kolejności listy.
- Cursor odpowiedział na pięć pytań dotyczących dokumentacji z przytoczonych stron i nie zmienił żadnych plików.
- Cursor nie znalazł strony, która stwierdza, gdzie PresentationDocument.AddText umieszcza tekst.
- Dla rozmiaru slajdu, Cursor cytował Slide.Width i Slide.Height. Ta odpowiedź była niepoprawna.
- Kontrola wyjścia odrzuciła listę z pustym wpisem ucznia, wydrukowała "slajd 2 nie ma tekstu" i zakończyła się z kodem 3.
- Przed poprawką, talia wieczorku pasowała do 0 z 7 linii i używała slajdów 4:3.
- Po poprawce, talia wieczorku pasowała do 7 z 7 linii na slajdach 16:9.
- Liczby dopasowań, które zgłosił Cursor, zgadzały się z niezależnymi kontrolami obu talii.
- Pakiet xUnit zaliczył 9 z 9 testów, które pokrywały siedem żądanych przypadków.
- Każda wersja Release miała 0 błędów, a projekt testowy dodał 1 ostrzeżenie analityka xUnit.
- Niektóre kroki uruchomiono inaczej niż na stronie. Wszystkie siedem promptów przeszło przez CLI Cursor w jednej sesji bez użycia głowy. CLI pominęło pytania z Cursor dotyczące notatek mówcy w promcie 03 oraz dotyczące błędów wyjścia w promcie 05. Prompty 05 do 07 działały w trybie planowania, gdy sesja została wznowiona, więc wiadomość śledząca "Zbuduj plan." zrealizowała każdy plan. Dla różnicy w promcie 04, Cursor porównał konspekty z oczekiwanym plikiem zamiast pokazywać zmianę kodu.
Przewodnik GitHub Copilot ogranicza część konwencji IronPPT do projektów źródłowych i testowych z plikiem instrukcji specyficznym dla ścieżki, jak robią to globy tutaj. Przewodnik Claude Code również zatwierdza plan przed napisaniem generatora talii. Zapis uruchomienia wymienia wersję Cursor, model i czas trwania tego uruchomienia oraz maszynę testową.
Rozwiązywanie problemów
- Jak dodać slajdy gdy generowana talia zaczyna się od pustego slajdu
- Klasa TextBox gdy linie slajdu się nakładają
- Jak zarządzać slajdami gdy slajd należy usunąć lub ukryć
- Korzystanie z kluczy licencyjnych gdy generowany kod wyrzuca wyjątek licencyjny podczas zapisu
Pytania?
Jeśli są jakiekolwiek pytania, należy skontaktować się z support@ironsoftware.com
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.