Jak korzystać z IronPPT z ChatGPT Codex

Curtis Chau
Curtis Chau
Zaktualizowano: 19 października 2026

Zespół ds. operacji sprzedaży wysyła tę samą prezentację co poniedziałek. Szablon dostarcza slajdy, a aktualne dane tygodniowe wypełniają je. Pojedynczy slajd dotyczący regionu staje się jednym slajdem na każdy region, nieaktualny slajd promocyjny jest usuwany, a aneks pozostaje w pliku, ale nie jest wyświetlany w pokazie slajdów. Gdy operacja na slajdzie kończy się niepowodzeniem bez komunikatu o błędzie, prezentacja nadal się zapisuje, a dziennik pracy nadal raportuje sukces. Następnie menedżerowie regionalni otrzymują podsumowanie promocji, która zakończyła się 30 czerwca, jednym slajdem przed aktualnymi wydarzeniami tygodnia.

ChatGPT Codex to agent programowania od OpenAI. Działa w repozytorium, gdzie edytuje pliki, uruchamia polecenia takie jak dotnet run i raportuje, co zmieniło. Ten sam agent działa w terminalu, rozszerzeniu IDE, aplikacji desktopowej ChatGPT i w chmurze. IronPPT, biblioteka .NET Iron Software dla PowerPointa, tworzy, otwiera, edytuje i zapisuje pliki .pptx bez Microsoft Office.

Codex otrzymuje szablon sprzedaży tygodniowej, plik z zasadami i dane regionalne z dwóch tygodni. Każdy raportowany licznik slajdów pochodzi z pliku CSV zapisanego w tym samym przebiegu, a każda operacja slajdu jest testowana na zapisanej prezentacji przed jej użyciem w partii kodu.

Szybki start
NuGetInstalacja z NuGet

PM > Install-Package IronPPT

Zainstaluj IronPPT, wykonując powyższe polecenie w konsoli Menedżera Pakietów NuGet lub wyszukaj pakiet w Menedżerze Pakietów NuGet.

Uruchomić Codex w projekcie konsoli .NET 9, który zawiera foldery Templates i Data.

$ironppt Install IronPPT 2026.10.1 in this console app and list the slides of the sales template.

Program.cs opens Templates/weekly-sales-template.pptx and saves nothing.
Each slide gets a row in out/quickstart.csv, with these columns:

- number, counting from 1
- heading, the first text on the slide
- texts, how many text items the slide holds
- shown, yes or no from the slide's Show property

Program.cs reads IRONPPT_LICENSE_KEY itself and copies it into License.LicenseKey.
Never print the key or write it to a file or log, and don't list environment variables.

If three builds or runs fail, stop and show me the last error.
Otherwise, read the slide count back from the CSV and tell me the number.
Text

Wzmianka $ironppt wczytuje umiejętności IronPPT przed zapisaniem kodu przez Codex.



Czym jest ChatGPT Codex i jak wpisuje się w pracę z prezentacjami .NET?

Polecenie /permissions określa, kiedy Codex edytuje pliki lub uruchamia polecenia bez wcześniejszego pytania. Dokumentacja CLI Codex obejmuje instalację i użycie w terminalu, a repozytorium open-source publikuje jego wydania.

Wiedza Codex o IronPPT pochodzi z danych szkoleniowych i dostarczonych plików. Brak nazwy członka w IronPPT powoduje błąd kompilacji.

IronPPT dostarcza zestaw .NET Standard 2.0, a jego pakiet NuGet wymienia Windows, Linux i macOS. Przebieg testowy budował projekt na Windows.

Jak napisać prośbę do IronPPT i jak skonfigurować Codex pod tym kątem?

Poniższe prośby nazywają szablon i dane (Templates/weekly-sales-template.pptx i Data/week-41.csv) oraz zasady (Data/README.md, które ustalają kolejność, pomijane i ukrywane slajdy oraz styl domowy).

Codex skanuje .agents/skills w każdym folderze od katalogu roboczego do głównego repozytorium. Każda umiejętność to folder zawierający SKILL.md, którego frontmatter definiuje nazwę i opis. Zapisanie skill.md IronPPT jako .agents/skills/IronPPT/SKILL.md pozwala na rozpoznanie wzmianki $ironppt. Umiejętność stwierdza, że była sprawdzona na IronPPT 2026.8.1, podczas gdy ten przewodnik instaluje 2026.10.1.

Codex czyta AGENTS.md przed rozpoczęciem jakiejkolwiek pracy. Przechodzi od głównego katalogu repozytorium do folderu roboczego, bierze maksymalnie jeden plik na katalog i pozwala, aby głębszy plik nadpisał płytszy. Polecenie /init generuje pierwszy szkic.

Write an AGENTS.md in the repository root, under a heading called Weekly sales deck.
Put these rules in it, one per line:

- IronPPT 2026.10.1 is the only PowerPoint library here. Package and namespace are both IronPPT.
- Don't add DocumentFormat.OpenXml or any other Office package.
- Data/README.md defines the deck, and it wins over anything else.
- Templates/ and Data/ are read-only.
- Look up IronPPT members in the ironppt skill under .agents/skills/ironppt/.
- A probe on a saved deck outranks both the skill and the installed IronPPT.xml.
- A deck counts as built only once it's saved, reopened from disk and checked.
- Every count you report comes from a CSV written in that turn. The reply names that CSV.
- The key stays in IRONPPT_LICENSE_KEY.

Show me the finished file.
Text

Jak poprosić Codex o dodanie IronPPT i sprawdzenie licencji?

Show me the IronPPT PackageReference in WeeklySalesDeck.csproj and the version NuGet resolved.
Then quote the full output of dotnet list package with --include-transitive.
Don't change any package references.
Text

IronPPT 2026.10.1 zależy od IronSoftware.Common 2026.4.2 i IronSoftware.System.Drawing 2026.8.2, a lista pakietów przebiegu testowego pokazała 30 pośrednich pakietów, wśród nich SixLabors.ImageSharp 3.1.12 i Grpc.Net.Client 2.62.0. Przejrzyj dziennik zmian IronPPT przed ustawieniem wydania na sztywno.

Bez klucza, IronPPT otwiera prezentację, odczytuje jej tekst, dodaje slajdy i tekst oraz ukrywa slajdy. Tylko Save kończy się niepowodzeniem, z wyjątkiem licencyjnym, którego wiadomość brzmi Konieczna licencja produkcyjna, i żaden plik nie jest zapisany. IronPPT sam odczytuje klucz ze zmiennej środowiskowej IronPPT.LicenseKey lub IRONPPT_LICENSEKEY, ale ignoruje IRONPPT_LICENSE_KEY. Kod, który przechowuje klucz pod tą nazwą, przypisuje License.LicenseKey przed pierwszym zapisem. Typ wyjątku licencyjnego nie jest publiczny w IronPPT 2026.10.1, więc uchwyt przechwytuje Exception i sprawdza nazwę typu.

Move the key line into Startup.ApplyIronPptKey and call that method first in Program.cs.
It sets License.LicenseKey from IRONPPT_LICENSE_KEY, then prints License.IsLicensed.

Next, test what IronPPT does without a key.
Start the program three times as child processes, each with a --licence-check option:

1. Clear IRONPPT_LICENSE_KEY for that child only.
2. Keep the variable set, and pass a --no-startup flag that skips the Startup call.
3. Keep the variable set and the Startup call in place.

Each child opens the template, replaces {{WEEK}} with 41 and saves out/licence-check-N.pptx.
Write each call to out/licence-check.csv, with run, call, result, exception type and message.
Add a column that says whether each pptx file exists afterwards.
If three repair attempts fail, stop there.
Tell me which of the three runs saved a file.
Text

Strona z kluczami licencyjnymi wymienia inne sposoby dostarczenia klucza.

Dlaczego kod slajdu w przewodniku pozostawia prezentację bez zmian?

Przewodnik zarządzania slajdami usuwa slajd poleceniem Slides.RemoveAt i przemieszcza jeden za pomocą Slides.Remove, po którym następuje Slides.Insert, a umiejętność IronPPT opisuje Slides jako zmienną listę. W IronPPT 2026.10.1, PresentationDocument.Slides zwraca nową listę za każdym razem, gdy jest czytana, i te wywołania zmieniają tylko tę kopię. Podczas kalibracji, Slides.RemoveAt(0) na załadowanej prezentacji sześciu slajdów pozostawiła liczbę na sześciu, a prezentacja zapisana po przesunięciu zachowała swój pierwotny porządek. Kod kompiluje się, nie zgłasza wyjątków i zapisuje slajd, który miał zostać usunięty.

Trzy operacje na istniejącym slajdzie dochodzą do prezentacji. Wywołanie Remove() na samym slajdzie usuwa go z zapisanego pliku, a Show = false zapisuje ukryty slajd, który pozostaje w pliku. Ustawienie Slide.Index przesuwa slajd, a oddzielna sonda ponownie otwiera zapisaną prezentację w nowym porządku.

Probe which slide operations survive a save, in a console app at scratch/slides-probe/.

Run it yourself on a copy of the template in scratch/, and apply the key the way Startup does.
Add a Compile Remove item that keeps scratch/** out of WeeklySalesDeck.csproj.
Give each case its own try block and its own saved file.

Reopen each saved file and measure these cases:

- Slides.RemoveAt(4), and whether the slide count drops
- Slides.Remove, then Slides.Insert(1, ...) on Highlights, and the order that results
- Remove() on the Q2 Promotion Recap slide itself
- Clone() on the region slide
- AddSlide(new Slide()) with AddText, and where the new slide ends up
- Show = false on the appendix

Then have the explorer agent read IronPPT.xml and the ironppt skill, writing nothing.
It reports what each source says about the Slides collection and about Clone.

Put every finding in out/slides-probe.csv, quoting the probe output, the XML or the skill.
Mark the rows where the skill and the probe disagree, and tell me which they are.
Text

Kontrola edytowanego obiektu listy przechodzi pomyślnie, ponieważ ta kopia uległa zmianie.

Jak złożyć cotygodniową prezentację z szablonu?

Przewodnik zarządzania slajdami nie obejmuje duplikowania slajdu. W IronPPT 2026.10.1, Clone() na slajdzie zgłasza MissingMethodException, a dodanie tego samego obiektu slajdu dwa razy nie pozostawia dodatkowego slajdu w zapisanym pliku. Usunięcie slajdu i ponowne jego dodanie na końcu pozostawiło pusty slajd na jego starej pozycji. Metoda, która działa, dodaje nowy Slide dla każdego wyjściowego slajdu, wypełnia go nowym tekstem w porządku, jakiego potrzebuje prezentacja, a następnie wywołuje Remove() na oryginałach szablonu.

Kopiowanie stylizacji z załadowanej prezentacji również kończy się niepowodzeniem. Podczas kalibracji nagłówek rozmiaru 36 pkt skopiowany właściwość po właściwości był zapisany jako 3 600 pkt, a jego kolor #1F4E79 stał się czarny. Dlatego prośba ustawia styl domowy README na każdym tekście.

Szablon przestrzega listy slajdów w README, z podsumowaniem promocji Q2 piątym i wyróżnionymi szóstym.

Pobierz weekly-sales-template.pptx

Szablon sprzedaży tygodniowej używany w przebiegu testowym, z jednym slajdem regionalnym, który zawiera tokeny regionalne.

Have the worker agent write Services/DeckAssembler.cs. It builds the deck Data/README.md describes.

DeckAssembler accepts these options:

- --week, which picks Data/week-NN.csv and Data/week-NN.tokens
- --template, defaulting to Templates/weekly-sales-template.pptx
- --plan, which writes out/deck-plan.csv and saves no deck
- --build, which saves out/week-NN.pptx

The probe showed which calls reach the saved file.
Build the deck with those calls, in these steps:

1. Open the template and find each slide by its heading.
2. For every output slide, add a new slide with AddSlide and write its texts with AddText.
3. Set the README's house style on every text you write.
4. Set Show = false on the new appendix slide.
5. Call Remove() on the eight template slides, then save.

The plan CSV has one row per output slide, with position, template heading, final heading and shown.
Run --plan --week 41, then give me the row count and the hidden slides from the CSV.
Text

Jak sprawdzić prezentację zapisaną przez Codex?

Run --build --week 41, then check the saved deck with code that's separate from the build.

The check reopens out/week-41.pptx and writes out/week-41-check.csv with these columns:

- position and heading
- shown
- the slide's full text, joined with " | "
- whether any {{ is left

Compare the check CSV with out/deck-plan.csv row by row.
Tell me which rows differ, and whether Q2 Promotion Recap appears anywhere in the deck.
Text

Wynik

DeckAssembler zapisał prezentację poniżej na tydzień 41 w przebiegu testowym, a jest ona publikowana bez zmian.

Pobierz week-41.pptx

Prezentacja tygodnia 41, taka jak zapisał ją IronPPT.

Co się dzieje, gdy zmienia się szablon?

Show me that DeckAssembler refuses Templates/weekly-sales-template-v2.pptx.
Marketing sent it with Highlights renamed to Wins This Week.

Run --build --week 41 --template Templates/weekly-sales-template-v2.pptx.
The existing out/week-41.pptx has to stay the same, byte for byte.
Record the attempt in out/template-check.csv with these columns:

- exit code and message
- the headings the build found
- the SHA-256 of out/week-41.pptx before and after

Tell me whether the two hashes match.
Text

Jak sprawdzić slajd ze zrzutu ekranu?

Codex akceptuje obrazy jako kontekst. Przekazać jeden z flagą -i (długa forma --image) przy uruchamianiu lub wznawianiu sesji, lub wkleić go do interaktywnego kompozytora.

Check the screenshot I attached with -i against the data and the deck.
A regional manager sent it and says the West revenue is wrong.
Don't change any code, and work through these steps:

1. Read the region and its three figures from the image.
2. Compare them with Data/week-41.csv and Data/week-40.csv.
3. Compare them with the West slide in out/week-41.pptx, using its text in out/week-41-check.csv.
4. Write the comparison to out/screenshot-check.csv.

Tell me which week the screenshot shows, and whether out/week-41.pptx is right.
Text

Jak debugować niepoprawne wyjście prezentacji od początku do końca?

Find out why the week 40 deck went out wrong. Data/week-40-complaint.md lists four problems.
Logs/week-40/deck.log says every step worked. Output/week-40.pptx is the deck that was sent.

Have the explorer agent read Jobs/LegacyWeeklyDeck.cs, the log and the deck before anything else.
A throwaway script under scratch/ may read the deck.
Don't edit any code outside scratch/.

Write out/week-40-diagnosis.md and cover these points in it:

- the line behind each of the four problems
- why the log reported success anyway
- the smallest fix for each, based on what the probe showed

Then give me one line per problem.
Text

Przejrzeć diagnozę przed zezwoleniem na jakąkolwiek edycję. Stara praca zapisywała każdy wiersz dziennika po zwróceniu wywołania i nigdy nie otwierała ponownie prezentacji.

Jak zmienić jedno-znaczne kody na komponenty do wielokrotnego wykorzystania i testowania?

Ask the worker agent for a DeckService class that meets these conditions:

- It resolves from a Microsoft.Extensions.DependencyInjection container.
- A DeckOptions record configures it, with week, template, plan-only and output folder.
- It keeps the README rules, the heading check and the house style from DeckAssembler.
- DeckService.cs stays below 150 lines, and its public members have XML doc comments.
- Nothing calls Jobs/LegacyWeeklyDeck.cs.

Then build week 41 with DeckService into out/final/week-41.pptx.
Check that deck the way you checked out/week-41.pptx, into out/final/week-41-check.csv.
Compare the two check files and list every difference.
Text

Refaktoryzacja może usunąć kontrolę nagłówka i nadal się kompiluje.

Add an xUnit project at tests/WeeklySalesDeck.Tests, in the same solution as the main project.
Exclude tests/** from what the main project compiles.
The tests get the key through Startup.ApplyIronPptKey.

Each test builds a deck in a temp folder and reopens it.
Between them, the tests check these conditions:

- week 41 gives 11 slides, with Highlights second and the appendix hidden
- the five region slides follow the CSV order
- East shows Revenue: $0 and still has its slide
- no {{ is left anywhere, and Q2 Promotion Recap is gone
- the v2 template is refused, and the message names the missing heading

Run dotnet test with --logger trx and --results-directory out/tests/.
Read the trx file and tell me how many tests passed and failed.
Text

W przypadku pytań dotyczących API, zainstalowany dokumentacja IronPPT.xml opisuje członków slajdu, takich jak AddSlide, Remove, Clone, Index i Show. Wyniki sondy pokazują, które z nich osiągają zapisaną prezentację.

$ironppt List the members in the installed IronPPT.xml that add, remove, move, copy or hide slides.
For each member you find, tell me these two things:

- what the XML says it does
- whether out/slides-probe.csv or the trx file in out/tests/ shows it working on a saved deck

Then write one compiling line per member in a probe project under scratch/api-probe/.
Build that probe with dotnet build, but don't run it.
Text

Jak ponownie wykorzystać te prośby na innej prezentacji?

Ze zmienionym szablonem, plikami danych i zasadami README, te same prośby mają zastosowanie do paczek zarządu, prezentacji stanu projektu lub recenzji klienta. W przypadku konfiguracji, która dotyczy każdego asystenta, odwołaj się do przewodnika po asystentach programowania AI IronPPT.

Co wyprodukowały zapytania w rzeczywistym uruchomieniu?

Powyższe prośby zostały przedłożone Codex w kolejności, w jednej sesji. Stare zadanie, jego dziennik i prezentacja zostały dodane przed zapytaniem do debugowania. Oddzielne skrypty ponownie otwierały każdą prezentację, którą zapisano, i odczytywały każdy slajd z pliku.

  • Przed przebiegiem szablon miał osiem slajdów, wszystkie pokazywane.
  • Po usunięciu zmiennej zapis wywołał wyjątek licencyjny, a plik wyjściowy nie istniał po tym.
  • Po ustawieniu zmiennej i pominięciu wywołania startowego zapis zakończył się w ten sam sposób.
  • W sondzie Slides.RemoveAt(4) pozostawiło wszystkie osiem slajdów w zapisanym pliku.
  • Clone() na slajdzie regionu wywołało MissingMethodException.
  • Codex rozpoczął trzy podagenty, a zapytanie debugowania ponownie wykorzystało agenta eksplorera z zapytania sondy.
  • Zapisana prezentacja tygodnia 41 zawierała 11 slajdów w kolejności README, z pięcioma slajdami regionalnymi w kolejności CSV.
  • Pokazywano dziesięć slajdów, a aneks zapisał się jako ukryty.
  • Podsumowanie promocji Q2 było nieobecne w prezentacji.
  • Wschód zachował slajd z przychodami w wysokości $0.
  • Odrzucony szablon v2 pozostawił hasz SHA-256 istniejącej prezentacji bez zmian.
  • Codex dopasował zrzut ekranu do danych regionu Zachód tygodnia 40.
  • Diagnoza przypisała każdemu z czterech problemów tygodnia 40 jego linie w starej pracy.
  • Diagnoza powiązała ukryty slajd Północ z ponownie użytym slajdem regionu, który zwrócił Slides.Last().
  • Prezentacja zbudowana za pomocą DeckService odpowiadała pierwszej kompilacji na każdym slajdzie.
  • Wszystkie pięć testów przeszło w przebiegu Codex i w naszym.
  • Niektóre kroki uruchomiono inaczej niż na stronie. Pakiety NuGet pochodziły z pamięci podręcznej przywróconej przed przebiegiem, ponieważ piaskownica nie miała sieci.

Przewodnik GitHub Copilot mierzy podobne niepowodzenie w przypadku zdjęć, gdzie połączenie Replace z przewodnika zarządzania obrazem pozostawia stare zdjęcie w załadowanej prezentacji. Przewodnik Google Antigravity buduje prezentacje dla jednoczesnych żądań webowych, które IronPPT obsługuje poprawnie tylko wtedy, gdy pojedyncza blokada chroni każde wywołanie IronPPT. Wspólna karta przebiegu podaje wersję Codex, model, czas i maszynę testową.


Rozwiązywanie problemów


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.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 7,110Wersja:2026.11właśnie wydane