Jak korzystać z IronWord z Google Antigravity

Curtis Chau
Curtis Chau
Zaktualizowano: 19 października 2026

Inżynierowie terenowi dodają raporty z inspekcji jako pliki Word, a osadzone zdjęcia są dowodami. Strona przeglądu, która buduje się bez błędów, nadal nie działa poprawnie, gdy pomija zdjęcia, pomija obrazy w tabelach, przypisuje niewłaściwe podpisy lub raportuje nieprawidłowe rozmiary zdjęć. Dziennik konstrukcji nie rejestruje żadnych z tych błędów.

Google Antigravity może testować stronę w taki sam sposób, jak recenzent. Podagent przeglądarki w trybie sandbox, uruchamiany z poleceniem /browser, otwiera stronę, wybiera każdy raport w kontroli plików i robi zrzut ekranu wyniku. Na serwerze, IronWord otwiera przesłane pliki DOCX i zwraca ich zdjęcia poprzez ExtractImages, bez potrzeby instalacji Microsoft Office. Poniżej znajduje się strona przeglądu zbudowana z obu narzędzi, przetestowana na sześciu raportach z znaną ilością zdjęć, podpisów i rozmiarów pikseli.

Przewodnik jest dla programistów, którzy mają agentów AI piszących kod .NET, który odczytuje dokumenty Word. Generowanie samych raportów za pomocą modelu AI jest poza zakresem.

Szybki start
NuGetInstalacja z NuGet

PM > Install-Package IronWord

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

Opisz stronę przeglądu w /plan, gdy Antigravity ma otwarty projekt Blazor.

/plan Add a report review page at /photos to this Blazor Web App on .NET 9.
The app uses the Interactive Server render mode.

Here's what the page needs:

- A reviewer picks a site inspection report (.docx) with InputFile.
- The server opens it with IronWord and calls ExtractImages.
- Add the IronWord package from NuGet, pinned to 2026.10.4. Its namespace is IronWord.
- Each photo appears as a thumbnail with its width and height in pixels and its image format.
- The page also shows how many photos the report holds.
- Link the page from NavMenu.

Read IRONWORD_LICENSE_KEY from the environment once at startup into IronWord.License.LicenseKey.
The app reads that variable itself.
Only check that it's set and how long it is.
Never print, log or store its value.
Don't list environment variables either.

Answer these in the Implementation Plan:

- which render mode the page gets
- how the upload stream reaches IronWord
- the size limit passed to OpenReadStream

You're done when dotnet build reports no errors.
Text

Pomyślna konstrukcja nie odpowiada na żadne z trzech pytań, na które plan musi odpowiedzieć. Przewodnik tryby renderowania Microsoftu wyjaśnia, kiedy strona jest interaktywna, a przewodnik przesyłania plików Blazor obejmuje obsługę przesyłania i limity rozmiarów.

Podawać agentowi nazwę zmiennej, ale nie przekazywać jej wartości. IronWord również odczytuje wpis IronWord.LicenseKey w appsettings.json, pliku, który można przypadkowo dołączyć do commit. Przewodnik klucz licencyjny wymienia wszystkie lokalizacje, które IronWord sprawdza w poszukiwaniu klucza.



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

Przegląd Google opisuje aplikację Antigravity jako aplikację desktopową, która uruchamia, organizuje i kontroluje zespoły agentów. Agent wykonuje polecenia, odczytuje i zapisuje pliki oraz kontroluje przeglądarkę Chrome w trybie sandbox. Asystent czatu odpowiada tekstem, podczas gdy agent zwraca Artefakty, na przykład Plan Wdrażania.

W ataku slopsquatting ktoś rejestruje pakiet pod nazwą, którą agenci AI wymyślili dla nigdy nieopublikowanych bibliotek, a agent, który żąda tej nazwy, instaluje kod atakującego. Nazwa IronWord w każdym zadaniu, dotyczącym pakietów. Przewodnik asystenci kodowania AI na hubie wymienia pliki dokumentacji IronWord dla agentów i zawiera test akceptacji z jednym promptem.

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

Poza trzema odpowiedziami żądanymi przez prompt Quickstart, Plan Wdrażania powinien zawierać wiadomość wygenerowaną dla raportu bez zdjęć. Wśród zmian w kodzie, znajdź linię, która oblicza rozmiar pikseli i sprawdź każdego członka IronWord w dokumentacji API.

Każdy raport potrzebuje własnego zrzutu ekranu w Przeprowadzce, obok tabeli wyników. Antigravity zapisuje zrzuty ekranu jako artefakty obrazów, a czytelnik może skomentować każdy z nich. Komentarz na zrzucie, który pokazuje podpis pod niewłaściwym zdjęciem, mówi agentowi, który obraz należy naprawić.

Jak testować stronę przeglądu IronWord w prawdziwej przeglądarce?

Dla /browser tabelę wyników, której komórki wypełniać tylko po przesłaniu każdego pliku.

/browser Start the site with dotnet run and open /photos.
Its http profile listens on http://localhost:5036.

Take each .docx file in TestData/reports through the page's file picker, one at a time:

1. Pick the file.
2. Wait for the photo list or an error message.
3. Take a screenshot.

TestData/reports/expected.csv lists each report's site photos in document order.
It gives their number, captions and pixel sizes, with | between entries.

Build a table in the Walkthrough with these columns:

- file
- bytes
- photos expected
- thumbnails shown
- pixel sizes expected
- pixel sizes shown
- pass or fail

For a failed row, quote the server log entry or browser console error behind it.
Do that before you change any code.
If neither recorded one, write that down.
After a fix, restart the app and put all six reports through the page again.
Stop the app when you finish.
Text

Sześć raportów obejmuje układy, które musi obsłużyć strona zdjęć. Jeden zawiera PNG, JPEG i GIF, a jeden przechowuje zdjęcia w komórkach tabel. Inny zawiera logo w nagłówku strony, jeden umieszcza ten sam obraz dwa razy, jeden nie zawiera zdjęć, a jeden to raport o rozmiarze 7,7 MB z czterema zdjęciami o rozdzielczości 12 MP.

Uwaga: Najpierw przejrzyj zrzut ekranu raportu pełnej rozdzielczości, ponieważ pokazuje, czy zwiększony limit zadziałał.

Co powoduje brakujące lub nieprawidłowe zdjęcia?

W naszych testach każda nieudana linia wynikała z jednej z trzech przyczyn. Aby je zidentyfikować, kod ekstrakcji z przewodnika ekstrakcji obrazów IronWord został skopiowany do obsługi przesyłania w nowym projekcie Blazor .NET 9, a sześć raportów zostało przetworzone za pomocą bezgłowej Chrome.

Co pokazuje stronaPrzyczynaNaprawa
Brak wyjścia dla żadnego raportuRendering statyczny@rendermode InteractiveServer
Brak wyjścia, a dziennik serwera pozostaje pustyKonstruktor dokumentu odczytuje strumień przesyłania synchronicznieLoadAsync na strumieniu przesyłania
Błąd tylko dla raportu pełnej rozdzielczościDomyślny limit przesyłania 512 000 bajtówLimit powyżej największego raportu

Drugi wiersz jest najtrudniejszy do zdiagnozowania. Konstruktor rzucił NotSupportedException z wiadomością "Odczyty synchroniczne nie są obsługiwane." Wyjątek stał się widoczny dopiero, gdy obsługa go złapała i zapisała.

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

Dostarczyć Antigravity repozytorium, które już buduje i obsługuje stronę. Projekt testowy pochodził z dotnet new blazor -int Server -f net9.0 i zbudował się z 0 błędami przed uruchomieniem jakiegokolwiek prompta. Szablon zapisuje losowy port w profilu http w Properties/launchSettings.json, więc skopiować ten URL do prompta /browser.

Kolejne zadanie audytuje pakiet i klucz licencyjny.

Which IronWord version does this project reference? Quote its PackageReference line.
Then point me to the line that applies the license key.

Check the project against these key rules:

- The key reaches the app only through IRONWORD_LICENSE_KEY at startup.
- Neither appsettings.json nor appsettings.Development.json has an IronWord.LicenseKey entry.
- Properties/launchSettings.json doesn't carry the key.
- A missing variable at startup gets one logged warning that names it and shows no value.

Edit Program.cs only if that warning doesn't exist yet.
Leave every other file as it is.
Tell me which rules pass and which fail.
Text

Cytuj zgłoszoną wersję w późniejszych zadaniach. IronWord 2026.10.4 otworzył każdy raport i wyekstrahował każdą fotografię bez żadnego klucza licencyjnego. Zapisanie rzuciło LicensingException z treścią "Wymagana licencja produkcyjna". Brakujący klucz staje się zatem widoczny dopiero, gdy aplikacja najpierw zapisze plik, czego ta strona tylko do odczytu nigdy nie robi.

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

Gdy wszystkie sześć wierszy przejdzie, zapisz, co zdecydowała sesja. Dokumentacja zasad Antigravity mówi, że za każdym razem, gdy agent odczytuje lub edytuje plik, ładuje każdy GEMINI.md lub AGENTS.md, jaki znajdzie w każdym folderze między tym plikiem a korzeniem przestrzeni roboczej. /learn zamienia opinię z sesji na trwałe zasady projektu.

/learn Create AGENTS.md at the root of the repository and record what this session settled.
Put the notes under the heading "Inspection report photos". They should cover:

- the render mode the /photos page needs
- the upload limit, with the reason for its value
- how the upload reaches IronWord without a synchronous read
- where a photo's pixel size comes from
- that IRONWORD_LICENSE_KEY stays out of every file
- that no page change is done until all six reports in TestData/reports pass the /browser table
Text

Gdy plik istnieje, tryb renderowania i limit przesyłania są rejestrowane w jednym miejscu, które odczytuje każde zadanie. Agent nie aktualizuje tego pliku automatycznie. Zażądaj aktualizacji w tym samym zadaniu, które zmienia wartość.

Jak załadować przesłany raport z IronWord?

Określić wynik i dowód, i pozwolić agentowi zbudować strukturę kodu.

/plan Write the Implementation Plan Artifact before you edit anything.

Move the IronWord code out of the page into Services/ReportPhotoService.cs.
Register it as a singleton.

The service works like this:

- It opens the upload with WordDocument.LoadAsync, straight from OpenReadStream with a 30 MB limit.
- It checks the file's Size first and turns away anything larger before it opens a stream.
- A refused file gets a clear message that the page shows.
- A second public method takes an already loaded WordDocument.
- Tests can call that method without a browser.

For each photo, the service returns:

- the pixel size
- the size the photo is placed at in the report, in inches
- the format
- a JPEG thumbnail no wider than 320 pixels
- the caption

A caption is the first paragraph with text after the photo's own paragraph.
For a photo inside a table cell, it's the text of the cell directly below.

Show each caption under its thumbnail.
Then repeat the /browser table with a captions column checked against expected.csv.
Text

Oczekuj usługi podobnej do tego przykładu. Kompiluje się z IronWord 2026.10.4, a strona testu kalibracyjnego korzystająca z niego poprawnie wyliczyła liczbę zdjęć, podpisy i rozmiary pikseli dla wszystkich sześciu raportów.

using IronSoftware.Drawing;
using IronWord;
using IronWord.Models;
using Microsoft.AspNetCore.Components.Forms;

public sealed record ReportPhoto(int PixelWidth, int PixelHeight, double WidthPoints, double HeightPoints, string Format, string Caption, string ThumbnailDataUrl);

public sealed class ReportPhotoService
{
    public const long MaxUploadBytes = 30 * 1024 * 1024;

    public async Task<List<ReportPhoto>> ReadAsync(IBrowserFile file)
    {
        if (file.Size > MaxUploadBytes)
            throw new IOException($"{file.Name} is {file.Size:N0} bytes, over the {MaxUploadBytes:N0} byte limit.");
        await using var upload = file.OpenReadStream(MaxUploadBytes);
        var doc = await WordDocument.LoadAsync(upload);
        return Read(doc);
    }

    public static List<ReportPhoto> Read(WordDocument doc)
    {
        var photos = new List<ReportPhoto>();
        var body = doc.Paragraphs.Where(p => p.Parent is DocumentSection).ToList();
        for (int i = 0; i < body.Count; i++)
        {
            foreach (var img in body[i].ExtractImages())
            {
                var caption = body.Skip(i + 1).Select(p => p.ExtractText().Trim()).FirstOrDefault(t => t.Length > 0) ?? "";
                photos.Add(Make(img, caption));
            }
        }
        foreach (var table in doc.Tables)
            for (int r = 0; r < table.Rows.Count; r++)
                for (int c = 0; c < table.Rows[r].Cells.Count; c++)
                    foreach (var img in ((TableCell)table.Rows[r].Cells[c]).ExtractImages())
                    {
                        var caption = r + 1 < table.Rows.Count && c < table.Rows[r + 1].Cells.Count
                            ? ((TableCell)table.Rows[r + 1].Cells[c]).ExtractText().Trim() : "";
                        photos.Add(Make(img, caption));
                    }
        return photos;
    }

    static ReportPhoto Make(ImageContent img, string caption)
    {
        var bmp = (AnyBitmap)img.Image;
        int tw = Math.Min(320, bmp.Width);
        int th = Math.Max(1, bmp.Height * tw / bmp.Width);
        using var thumb = new AnyBitmap(bmp, tw, th);
        var jpg = thumb.ExportBytes(AnyBitmap.ImageFormat.Jpeg, 80);
        return new ReportPhoto(bmp.Width, bmp.Height, img.Width, img.Height, img.Type.ToString(), caption,
            "data:image/jpeg;base64," + Convert.ToBase64String(jpg));
    }
}
C#

Sprawdzenie rozmiaru używa wartości zgłoszonej przez przeglądarkę, więc zbyt duży plik nie przechodzi przed otwarciem strumienia przesyłania. Przewodnik przesyłania Microsoftu zaleca unikanie polegania wyłącznie na tej wartości dostarczonej przez klienta, a limit ustawiony w OpenReadStream egzekwuje rzeczywisty limit. Odczyt raportu pełnej rozdzielczości zajęło 1 118 ms i 1 280 ms w dwóch uruchomieniach kalibracyjnych. Aby uniknąć dużych transferów danych, usługa generuje skalowane miniatury zamiast wysyłać obrazy pełnej wielkości do przeglądarki.

Jakie obrazy wyciąga IronWord z dokumentu?

Metoda ExtractImages zwraca zdjęcia znajdujące się w ciele dokumentu i w komórkach tabel. Pomija logo w nagłówku strony, więc nagłówek nie liczy się jako zdjęcie na stronie. Jeśli zdjęcie pojawia się wielokrotnie, jest zwracane raz dla każdego umieszczenia, każde z własnym rozmiarem.

Każdy wynik zawiera swoją szerokość i wysokość w punktach. Na przykład, zdjęcie o szerokości 3 cale jest zgłoszone jako 216 punktów, niezależnie od rozdzielczości. Przykładowa usługa zachowuje te wartości punktowe. Aby przeliczyć na cale, podziel przez 72 lub użyj GetWidth(MeasurementUnit.Inch), jak pokazano przez agenta. Rozmiar pikseli uzyskuje się z zdekodowanego obrazu, albo poprzez rzutowanie właściwości Image na AnyBitmap, albo poprzez dekodowanie łańcucha Base64 w ImageData.

Lista akapitów zawiera akapity w komórkach tabel w kolejności czytania, więc wybranie następnego akapitu z tekstem przypisuje podpis pierwszego zdjęcia do drugiego zdjęcia w tabeli. ExtractText dokumentu również pomija tekst tabeli, więc jego wyjście nie zawiera podpisów tabeli.

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

Podzielić kontrole między dwa agentów. Jeden testuje usługę w kodzie. Drugi odtwarza przesyłania recenzenta w przeglądarce.

Agent A: add an xUnit project named InspectionPhotos.Tests.
Its tests take each report in TestData/reports through these steps:

1. Load the report from disk with WordDocument.
2. Pass it through the extraction code in ReportPhotoService.
3. Assert the photo count, pixel sizes and captions that expected.csv lists, in document order.

Add one more test proving a file above the upload limit is refused before IronWord opens it.
expected.csv quotes any field that holds a comma, so parse it as CSV.
The web project is at the repository root, so keep the test folder out of its compile items.
Run the tests with dotnet test InspectionPhotos.Tests.

Agent B: wait until Agent A's tests are green on the current code.
Then put the six reports through /photos with /browser.
Attach one screenshot per report to the Walkthrough.
Note there that the tests ran first.
Text

Testy otwierające raporty z dysku nie potrzebują ani przeglądarki, ani działającej aplikacji, więc wykrywają regresję podpisów przed przejściem /browser.

Uwaga: W aplikacji desktopowej każdy agent może działać jako osobne zadanie. Porównaj oba Przeprowadzania przed scaleniem.

Jak wdrożyć stronę do kontenera Linux?

Oprócz zarządzanych assembly, IronWord 2026.10.4 zawiera bibliotekę układu natywnego zbudowaną dla Windows (x64 i x86), linux-x64 i macOS.

This page will run in a linux-x64 container based on mcr.microsoft.com/dotnet/aspnet:9.0.
Leave the C# untouched.
Docker is missing on this machine, so don't run docker build.

Work through these steps:

1. Write a Dockerfile whose build stage publishes a linux-x64 build.
2. Have the image take IRONWORD_LICENSE_KEY from the container environment when it starts.
3. Run dotnet publish -c Release -r linux-x64 --self-contained false -o out/linux.

Then list every native library (.so) in out/linux with the NuGet package that supplied it.
If there's none, say so.
Text

Docker nie jest potrzebny do wymienienia plików natywnych, ponieważ folder publikacji w Windows zawiera te same pliki, które otrzymuje obraz. Publikowanie aplikacji kalibracyjnej dla linux-x64 wygenerowało jeden plik natywny, libLayoutEngineInterop.so (8 303 240 bajtów). Ten plik łączy się tylko z glibc, a pakiet nie ma kompilacji musl ani linux-arm64, więc to wydanie nie zawiera biblioteki natywnej dla obrazów Linux Alpine ani ARM64. Na Windows, ładowanie i wyciąganie zdjęć nie załadowało biblioteki natywnej. Przewodnik Docker IronWord zaleca używanie obrazów Ubuntu, Debian lub RHEL.

Co wyprodukowały zapytania w rzeczywistym uruchomieniu?

Jedna sesja CLI Antigravity uruchomiła wszystkie siedem promptów bez nadzoru i pominęła każdy prompt uprawnienia. Aplikacja odczytała klucz licencyjny tylko z IRONWORD_LICENSE_KEY. Przesłać każdy raport w bezgłowej Chrome dwukrotnie, raz na kodzie z pierwszego prompta i raz na końcowym kodzie.

  • Ilość zdjęć i rozmiary pikseli były poprawne dla wszystkich sześciu raportów w obu kontroli Chrome.
  • Podpisy przechodziły od żadnego po pierwszym promt, który nie wymagał żadnego, do 12 z 12 poprawnych w końcowej aplikacji.
  • Kompilacje wydania aplikacji i projektu testowego zgłaszały 0 ostrzeżeń i 0 błędów.
  • Wszystkie siedem testów xUnit przeszło.
  • Publikacja linux-x64 zawierała jedną bibliotekę natywną.
  • Każdy z trzech przeglądów przetworzył wszystkie sześć raportów przez selekcję plików.
  • Niektóre kroki uruchomiono inaczej niż na stronie. Prompt Quickstart ustawił już limit 30 MB i skopiował każde przesłanie do pamięci, więc żaden z trzech przyczyn powyżej nie wystąpił. Każdy prompt /plan zatrzymał się po swoim planie, aż nadeszła zgoda. Agent A i Agent B działali w jednej turze tej samej rozmowy. Miniatury zostały zmniejszone przy użyciu SixLabors.ImageSharp, przejrzystego zależności IronWord. Agent zacommitował zrzuty ekranu z pierwszego przeglądowego przejścia oraz folder publikacji out/linux.
  • /learn nie napisał AGENTS.md. Jej Artefakt wymienił wszystkie sześć punktów i najpierw poprosił o potwierdzenie.

Przewodnik ChatGPT Codex przetwarza cały folder dokumentów Word równolegle pod limitem współbieżności, gdzie ta strona radzi sobie z jednym przesłaniem na raz. Przewodnik Claude Code zatwierdza projekt w trybie planowania przed jakimikolwiek zmianami w plikach, jak prompt najpierw tutaj.

Wersja CLI Antigravity, model, czas trwania i maszyna testowa dla tego uruchomienia są w rekordzie uruchomienia huba.


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 62,392Wersja:2026.11właśnie wydane