Jak używać IronPPT z Google Antigravity

Curtis Chau
Curtis Chau
Zaktualizowano: 19 października 2026

Biuro zarządzania projektami publikuje prezentację statusu dla każdego projektu w każdy poniedziałek. W StatusDesk, aplikacji webowej biura, menedżer projektu klikać Pobierz prezentację statusu w wierszu projektu i otrzymywać plik PowerPoint, który serwer zbudował chwilę wcześniej. Prezentacja może zostać pobrana bez błędu, ale otwarta z pustym pierwszym slajdem, skrzynki tekstowe nakładają się na siebie lub zawiera slajdy innego projektu. Żaden z tych błędów nie pojawił się w logu budowania.

Google Antigravity może sprawdzić stronę w sposób, w jaki korzysta z niej menedżer projektu. Jej polecenie /browser uruchamiać oddzielny przeglądarkowy podagent, który klikać każdy przycisk Pobierz i wykonywać zrzut ekranu. IronPPT tworzy prezentację na serwerze z tekstu, kształtów i obrazów, elementów omówionych w samouczku elementu slajdu IronPPT. Ten przewodnik tworzy stronę za pomocą obu narzędzi i sprawdza ją w sześciu projektach znanych z góry.

Przeznaczony jest dla deweloperów używających agentów AI do pisania kodu .NET, który generuje pliki PowerPoint na serwerze webowym. Nie dotyczy projektowania slajdów ani szablonów korporacyjnych.

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.

Po otwarciu projektu StatusDesk w Antigravity, opisz stronę statusu.

/plan Give StatusDesk, the PMO's .NET 9 MVC site, a /Status page.
Each project row gets a Download status deck button.
The nav bar gets a Status link.
Install IronPPT 2026.10.1. Its namespace is IronPPT.
App_Data/projects.json holds the projects and the report week.

Each deck has these slides, in order:

1. Title: project name, "Status report, week of" plus the week, owner.
2. Status: status word, status-colored rectangle, summary, logo.
3. Milestones: name, due date and state, at most five per slide.
4. Risks: every risk, only if there are any.

Follow these rules too:

- Status colors: Green 00B050, Amber FFC000, Red C00000.
- Logo: App_Data/logos/<Id>.png, skipped if missing or unreadable.
- Text boxes don't overlap, and nothing runs off the slide IronPPT creates.
- Download name: status-<Id>.pptx, with the PowerPoint content type.
- If a deck fails, the page shows one plain sentence, never exception text.

Startup code reads IRONPPT_LICENSE_KEY itself and sets IronPPT.License.LicenseKey once.
Never print, log or store the key, or list environment variables.

Answer these in the Implementation Plan:

- What does a new PresentationDocument hold, and how big is its slide?
- Where does AddText put a text box, and what unit do Position, Width and Height use?
- How do the deck's bytes get into the HTTP response?

Show me the plan, then build until dotnet build shows zero errors.
Text

Zbudowanie wersji testowej nie dowodzi żadnej z trzech odpowiedzi, więc przeczytaj je w planie przed zatwierdzeniem.

IronPPT nie odczytuje samodzielnie IRONPPT_LICENSE_KEY. W naszej sondzie, License.IsLicensed pozostało fałszywe, gdy ta zmienna była ustawiona samodzielnie, natomiast zmienna środowiskowa nazwana IronPPT.LicenseKey licencjonowała proces bez żadnego kodu. Przydzielenie License.LicenseKey podczas uruchomienia utrzymuje nazwę zmiennej pod kontrolą aplikacji. Przewodnik po kluczach licencyjnych opisuje inne sposoby zastosowania klucza.



Czym jest Google Antigravity i czym różni się od asystenta czatu?

Według przeglądu firmy Google, aplikacja Antigravity to samodzielna aplikacja na komputery do uruchamiania, orkiestracji i inspekcji zespołów agentów AI. Jej agenci zwracają Artefakty, np. Plan Implementacji, Przewodnik i zrzuty ekranu, gdzie asystent chatowy zwraca tekst.

Agent, który wybiera nazwę pakietu bez jej sprawdzenia, może zainstalować złośliwe oprogramowanie, ponieważ atakujący publikują pakiety pod nazwami, które modele językowe wymyślają. Ten atak nazywa się slopsquatting. Nazwij pakiet IronPPT i jego wersję w każdym zadaniu, które dodaje pakiet. Przewodnik po asystentach kodujących AI listuje pliki dokumentacji IronPPT dla agentów, a jego test akceptacyjny mieści się w jednym wyzwaniu.

Co należy sprawdzić w planie, zmianach kodu i Przewodniku?

W planie, porównaj każdą odpowiedź z zawartością prezentacji mierzoną poniżej. W zmianach kodu, znajdź, gdzie każda skrzynka tekstowa otrzymuje swoją pozycję, i potwierdź każdego członka IronPPT w dokumentacji API.

Przewodnik powinien zawierać zrzut ekranu każdego pobrania. W aplikacji na komputer, Antigravity przechowuje każdy zrzut ekranu jako artefakt obrazu, który akceptuje komentarze, więc komentarz w niewłaściwym wierszu identyfikuje projekt bez nowego wyzwania.

Jak przetestować przycisk pobierania w prawdziwej przeglądarce?

Podawać /browser tabelę, którą można wypełnić tylko pobierając każdą prezentację i otwierając plik.

/browser Launch StatusDesk with dotnet run as a background process.
Then open http://localhost:5326/Status.

Do this for every project, top to bottom:

1. Click Download status deck.
2. Save the file as artifacts/decks/status-<Id>.pptx.
3. Take a screenshot of the page.

Next, write a console tool in tools/DeckCheck that opens a deck with IronPPT.
It prints the slide count and each slide's text, shape count and image count.
Leave tools/DeckCheck out of the web project's compile items.

Run DeckCheck on each deck in artifacts/decks and compare it with TestData/expected-decks.csv.
Put the results in a Walkthrough table and in artifacts/deckcheck.md.
The table has these columns:

- project
- slides expected and slides found
- first text on slide 1
- images found
- pass or fail

If a row fails, trace the cause in the deck code before you edit.
Then fix it, restart the site and download every deck again.
At the end, kill the dotnet process by its PID and show me the table.
Text

Szacione projekty obejmują przypadki, które musi obsłużyć prezentacja statusu. Atlas i Borealis mają logo i otwarte ryzyka, Cobalt nie ma pliku logo, a Delta nie ma ryzyk, więc jej prezentacja kończy się po kamieniach milowych. Logo dla Ember zawiera stronę błędu HTML z nieudanego eksportu zamiast obrazu, a Fjord ma siedem kamieni milowych, co wymaga drugiego slajdu z kamieniami milowymi.

StatusDesk /Strona statusowa wymieniająca sześć projektów, każdy z przyciskiem Pobierz prezentację statusu

Strona /Status po pobraniu P-102, jak ostatnie przejście przeglądarki ją uchwyciło bez jej arkuszy stylów.

Wynik

Poniżej prezentacja Borealis to plik, który ostatnie przejście przeglądarki pobrało, niezmieniony.

Pobierz status-P-102.pptx

Prezentacja Borealis Mobile App, cztery slajdy z logo na drugim.

Co zawiera nowa prezentacja IronPPT przed dodaniem czegokolwiek?

Każdy nowy PresentationDocument zaczyna się od jednego slajdu. Ten slajd używa układu Slajdu Tytułowego i utrzymuje dwa puste pola, Tytuł 1 i Podtytuł 2, a AddSlide dodaje się za nim. Przewodnik dodawania slajdu zauważa istniejący slajd.

Slajd ma wymiary 4:3, 720 na 540 punktów. Position, Width i Height przyjmują wartości w punktach, więc szerokość 100 zapisuje 1 270 000 EMU. Komentarze w samouczku elementu slajdu, które nazywają jednostkę pikselami, są błędne dla IronPPT 2026.10.1.

Slide.AddText tworzy skrzynkę tekstową bez pozycji, jak zmierzył artykuł hub IronPPT. Ustawiając Position, Width i Height na ostatni element Slide.TextBoxes umieszcza się skrzynkę, którą wywołanie dodało. Font.FontFamily nie zapisuje czcionki w pliku, a Font.LatinFont to robi.

Budowanie kalibracji, które wywoływało AddSlide dla każdego slajdu i AddText bez pozycji, otwierało wszystkie sześć prezentacji z pustym slajdem, a 6 do 15 skrzynek tekstowych w każdej prezentacji dzieliło jedną pozycję. Druga wersja, która ponownie wykorzystała istniejący slajd i umieściła każdą skrzynkę tekstową, przeszła wszystkie sześć projektów.

Jak skonfigurować projekt, w którym Antigravity może działać?

Uruchomić agenta w repozytorium, które kompiluje i serwuje stronę. Projekt tego przewodnika został stworzony z dotnet new mvc -f net9.0 i skompilowany raz przed pierwszym zapytaniem. Jego profil http w Properties/launchSettings.json serwuje port 5326.

Which IronPPT version is in StatusDesk.csproj? Quote that PackageReference line.
Next, find and quote the code that sets the key.
Answer from the code without running the app.

Check the key handling against these rules:

- The key comes in through IRONPPT_LICENSE_KEY at startup and nowhere else.
- No appsettings file has an IronPPT.LicenseKey entry.
- The key isn't set in Properties/launchSettings.json either.
- If the variable is missing, startup logs a single warning with its name and no value.
- IronPPT licensing errors get logged by type name only, because their message can contain the key.

If that warning is missing, add it to Program.cs and change nothing else.
For each other rule that fails, give me the file and line.
Text

Bez klucza licencyjnego IronPPT 2026.10.1 zbudował prezentację w pamięci i otworzył istniejący plik PPTX. Save rzuciło LicensingException z tytułem "Wymagana Licencja Produkcyjna", i nie pojawił się żaden plik wyjściowy. Na stronie kalibracja pierwsze nie licencjonowane pobieranie zakończyło się niepowodzeniem po 871 ms, a kolejne w 33 do 48 ms. Handler musi dopasować LicensingException według nazwy typu, ponieważ typ nie jest publiczny.

Z nieprawidłowym kluczem, wiadomość LicensingException powtarzała tekst klucza, który otrzymała. Kalibracyjne pobieranie, które wyświetliło wiadomość wyjątku, zwróciło ten tekst klucza w odpowiedzi. Rejestracja w logu, która zapisuje wiadomość, zawiera ten sam tekst, dlatego powyższa zasada rejestruje tylko nazwę typu.

Jak zastosować zasady prezentacji do późniejszych zadań?

Gdy każdy wiersz przejdzie, zapisz decyzje sesji jako zasady. Zgodnie z dokumentacją zasad Antigravity, CLI czyta AGENTS.md, GEMINI.md i .agents/rules z korzenia repozytorium i z podkatalogów. Polecenie /learn kondensuje korekcje z sesji w trwałe zasady.

/learn Save what this session decided in a new AGENTS.md at the repo root.
Put it under the heading "Status decks" and cover these points:

- what a new PresentationDocument holds before any slide is added
- the unit of Position, Width and Height, and the slide size
- how each text box gets a position of its own
- how the deck's bytes reach the HTTP response
- that the key comes only from IRONPPT_LICENSE_KEY and is never printed, logged or stored
- that no command lists the environment variables
- that a change is done once every row of TestData/expected-decks.csv passes in /browser

Show me the file when you're done.
Text

Co się dzieje, gdy kilka osób pobiera jednocześnie?

IronPPT nie jest bezpieczne do użycia z dwoma zapytaniami jednocześnie, nawet gdy każde zapytanie tworzy własny PresentationDocument i zapisuje do własnego pliku. Tworzenie prezentacji w pamięci na 16 wątkach nie powodowało błędów. Zapis lub ładowanie na równoległych wątkach zakończył się niepowodzeniem, z błędami, takimi jak InvalidOperationException i IOException, a niektóre pliki, które zapisano bez wyjątku, zawierały slajdy innej prezentacji. Z blokadą wokół Save i ładowaniem samodzielnie, a tworzeniem pozostającym odblokowanym, nadal nie udało się 1 do 10 z 32 prezentacji.

W aplikacji kalibracyjnej, 12 jednoczesnych pobrań, dwa dla każdego projektu, odbyło się trzy razy. Bez blokady 30 z 36 odpowiedzi zwróciło HTTP 500, a 4 z 6 dostarczonych prezentacji były błędne. Z jedną blokadą wokół każdego wywołania IronPPT, wszystkie 36 odpowiedzi zawierało poprawną prezentację, a najwolniejsza zajęła 1 066 ms.

/plan On Monday mornings a dozen project managers download their decks within seconds of each other.
Write an Implementation Plan Artifact first, and wait for my approval before any edit.

Once I approve, measure the effect on the site before you touch the code:

1. Run the site in a separate process.
2. Send 12 download requests at once, two per project.
3. Save each response and check its slide count and title against TestData/expected-decks.csv.
4. Search each file for text from another project.
5. Count the failed responses and the files that don't match.

Then fix the root cause. Every download has to stay under two seconds.
After the fix, send the 12-request burst three more times.

Give me these results:

- the counts before the fix and for each later burst
- the first error from the log

End by stopping the site's dotnet process through its PID.
Text

Oczekiwana usługa przypomina ten przykład, który kompiluje się z IronPPT 2026.10.1. Tworzone z niego prezentacje zachowują puste pola Tytuł 1 i Podtytuł 2 na pierwszym slajdzie. Aby je usunąć, wywołać Remove na każdym elemencie title.TextBoxes.ToList() przed pierwszym wywołaniem AddText.

using IronPPT;
using IronPPT.Enums;
using IronPPT.Models;

namespace StatusDesk.Services;

public sealed class DeckBuilder(IWebHostEnvironment env)
{
    // IronPPT is not safe to run on two requests at once, so every IronPPT call goes through this lock.
    private static readonly object IronPptLock = new();

    private static readonly Dictionary<string, string> StatusColors = new()
    {
        ["Green"] = "#00B050",
        ["Amber"] = "#FFC000",
        ["Red"] = "#C00000",
    };

    public byte[] Build(Project project, string reportWeek)
    {
        lock (IronPptLock)
        {
            var deck = new PresentationDocument();

            Slide title = deck.Slides[0];
            AddText(title, project.Name, x: 40, y: 180, width: 640, height: 70, points: 40, bold: true);
            AddText(title, $"Status report, week of {reportWeek}", x: 40, y: 260, width: 640, height: 40, points: 24);
            AddText(title, $"Owner: {project.Owner}", x: 40, y: 310, width: 640, height: 40, points: 20);

            Slide status = deck.AddSlide(new Slide());
            AddText(status, "Status", x: 40, y: 30, width: 500, height: 60, points: 32, bold: true);
            status.AddShape(new Shape
            {
                Type = ShapeType.Rectangle,
                FillColor = new Color(StatusColors[project.Status]),
                Position = (40, 110),
                Width = 160,
                Height = 60,
            });
            AddText(status, project.Status, x: 220, y: 120, width: 300, height: 40, points: 28, bold: true);
            AddText(status, project.Summary, x: 40, y: 200, width: 640, height: 120, points: 20);

            string logo = Path.Combine(env.ContentRootPath, "App_Data", "logos", project.Id + ".png");
            if (File.Exists(logo))
            {
                try
                {
                    var image = status.AddImage(logo);
                    image.Position = (560, 30);
                    image.Width = 120;
                    image.Height = 60;
                }
                catch (IronPPT.Models.Exceptions.ImageLoadException)
                {
                }
            }

            // Milestone and risk slides follow the same AddText pattern.

            string path = Path.Combine(Path.GetTempPath(), $"status-{Guid.NewGuid():N}.pptx");
            try
            {
                deck.Save(path);
                return File.ReadAllBytes(path);
            }
            finally
            {
                File.Delete(path);
            }
        }
    }

    private static void AddText(Slide slide, string text, double x, double y, int width, int height, double points, bool bold = false)
    {
        slide.AddText(new Text(text)
        {
            TextStyle = new TextStyle { IsBold = bold, TextFont = new Font { LatinFont = "Calibri", FontSize = points } },
        });
        var box = (TextBox)slide.TextBoxes[^1];
        box.Position = (x, y);
        box.Width = width;
        box.Height = height;
    }
}
C#

Save akceptuje tylko ścieżkę pliku, dlatego przykład zapisuje tymczasowy plik i zwraca jego bajty.

Kiedy należy wysłać więcej niż jednego agenta?

Przesłać drugiego agenta, gdy część kontroli nie wymaga przeglądarki.

Split this work between two agents.

Agent A writes an xUnit project, StatusDesk.Tests, with these tests:

- For each row of TestData/expected-decks.csv, check the slide count and title text.
- Check the status rectangle's fill color in the saved file's slide XML.
- Build and save all six decks on parallel threads, then check each file holds only its project.

The tests follow AGENTS.md and these rules:

- They copy IRONPPT_LICENSE_KEY into IronPPT.License.LicenseKey before any save.
- They build decks through the site's own deck code and never start the site.
- The web project is the repo root, so its compile items skip StatusDesk.Tests.

Agent A runs them with dotnet test StatusDesk.Tests.

Agent B starts once that suite passes:

1. Use /browser to download every deck.
2. Send the 12-request burst again.
3. Put a screenshot of each download in the Walkthrough, and note there that the tests passed first.

Tell me what each agent found.
Text

Test, który odczytuje zapisaną prezentację z powrotem z IronPPT, otrzymuje tekst nienaruszony. Pozycje i rozmiary wróciły 12 700 razy większe niż ustawione wartości, a wypełnienia i kolory tekstu wróciły jako #00000000, więc sprawdzenie koloru musi odczytać XML slajdu.

Uwaga: W próbnym uruchomieniu Agent B napisał Przewodnik, a Agent A nie, więc przeczytaj końcową odpowiedź każdego agenta, zanim dokonasz połączenia.

Co wyprodukowały zapytania w rzeczywistym uruchomieniu?

Wszystkie sześć wyzwań odbyło się bez nadzoru w jednej rozmowie CLI Antigravity, z pomijaniem wyzwań do uzyskania zgody. Aplikacja otrzymała klucz licencyjny wyłącznie przez IRONPPT_LICENSE_KEY. Każda prezentacja została również pobrana i sprawdzona niezależnie, raz po pierwszym wyzwaniu i ponownie w finalnej aplikacji.

  • Przed jakąkolwiek edycją, plan znalazł dwa puste pola na pierwszym slajdzie nowego dokumentu, a budowanie je usunęło.
  • Po pierwszym wyzwaniu, wszystkie sześć prezentacji miało oczekiwaną liczebność slajdów i tytuł.
  • Żaden tekst nie nakładał się na inny ani nie wykraczał poza krawędź slajdu, w obu kontrolach.
  • W pierwszej wersji testowej, trzy serie 12 jednoczesnych pobrań zwróciły 3, 1 i 3 poprawne prezentacje.
  • W tych seriach 27 z 36 żądań otrzymało stronę błędu z HTTP 200, zamiast prezentacji.
  • Dwie dostarczone prezentacje były błędne, a jeden z Borealis Mobile App zawierał nazwę projektu Delta Office Move.
  • Naprawa przez agenta umieściła jedną blokadę wokół tworzenia i zapisywania każdej prezentacji.
  • Naprawa również zbudowała wszystkie sześć prezentacji na pierwsze żądanie strony statusowej i przechowywała ich bajty w pamięci, dopóki dane projektu lub logo się nie zmieniły.
  • Po naprawie, trzy niezależne serie zwróciły 36 poprawnych prezentacji z 36, a najwolniejsze pobranie zajęło 14 ms. Każda odpowiedź pochodziła z prezentacji przechowywanych w pamięci, więc te serie nie wymuszały blokady. Kalibracyjny test w sekcji współbieżności to pomiar, który pokazuje, że blokada działa.
  • Logo o wielkości 400 na 200 pikseli zostały narysowane w 152 na 110 punktów, co je zniekształciło.
  • Bez klucza, strona pokazała "Nie można było wygenerować prezentacji statusu dla tego projektu."
  • Nieprawidłowy klucz nie pojawił się ani w odpowiedzi, ani w logu.
  • /learn napisało AGENTS.md w korzeniu repozytorium ze wszystkimi siedmioma punktami.
  • Wszystkie 13 testów xUnit przeszło z kluczem i nie udało się bez niego.
  • Wywołanie dla dwóch agentów uruchomiło każdego agenta w jego własnej podrzędnej rozmowie, a Agent B rozpoczął po przejściu testów.
  • Niektóre kroki uruchomiono inaczej niż na stronie. Podagent /browser nie dotarł początkowo do Chrome, więc agent sam rozpoczął debugowanie na odległość Chrome. Ten krok również przepisał plik DevToolsActivePort w profilu Chrome użytkownika. Zrzuty ekranu przeglądarki pokazywały stronę bez arkuszy stylów, które ładowały się normalnie w niezależnym sprawdzeniu. Obydwa plan-first wyzwania zakończyły się po planie, aż uruchomienie wysłało zatwierdzenie. Sprawdzenie ustawień zgłosiło blok catch, który nic nie rejestrował, a późniejsze polecenie współbieżności go zastąpiło.

ChatGPT Codex przypisuje nazwane części zadania do agentów eksploratorów i pracowników, a GitHub Copilot przechowuje swoje stałe zasady w plikach instrukcji, jak ten przewodnik robi z AGENTS.md. Udokumentowane zapis zdarzeń na stronie hub listuje wersję Antigravity, model, czas trwania uruchomienia 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