Comment utiliser IronWord avec Google Antigravity
Les ingénieurs de terrain soumettent des rapports d'inspection sous forme de fichiers Word, et les photos intégrées constituent les preuves. Une page de révision qui se construit sans erreurs échoue toujours lorsqu'elle ignore les photos, omet les images dans les tableaux, attribue des légendes incorrectes ou rapporte des tailles de photo inexactes. Un journal de construction n'enregistre aucune de ces échecs.
Google Antigravity peut tester la page comme le ferait un examinateur. Un sous-agent navigateur sandboxé, démarré avec la commande /browser, ouvre la page, sélectionne chaque rapport dans le contrôle de fichier et prend une capture d'écran du résultat. Sur le serveur, IronWord ouvre les fichiers DOCX téléchargés et renvoie leurs photos via ExtractImages, sans installation de Microsoft Office. La page de révision ci-dessous est construite avec les deux outils et testée contre six rapports avec des comptes, légendes et tailles de pixels connus.
Le guide s'adresse aux développeurs qui ont des agents IA écrivant du code .NET qui lit des documents Word. La génération des rapports eux-mêmes avec un modèle IA est hors de portée.
Démarrage rapideDécrivez la page de révision dans une invite /plan une fois qu'Antigravity a le projet Blazor ouvert.
/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.
Une construction réussie ne répond à aucune des trois questions que le plan doit couvrir. Le guide des modes de rendu de Microsoft explique quand une page est interactive, et le guide de téléchargement de fichiers Blazor couvre la gestion des téléchargements et les limites de taille.
Fournissez à l'agent le nom de la variable, mais ne partagez pas sa valeur. IronWord lit également une entrée IronWord.LicenseKey dans appsettings.json, un fichier que peut inclure par erreur un commit. Le guide de la clé de licence liste tous les emplacements qu'IronWord vérifie pour la clé.
Flux de travail minimal (5 étapes)
- Téléchargez la bibliothèque C# Word depuis NuGet
- Commencez avec une application Web Blazor servant déjà des pages sur localhost
- Rendez la page de révision interactive et augmentez la limite de téléchargement au-dessus de votre plus grand rapport
- Faites que /browser télécharge chaque rapport de test et capture les photos qu'il montre
- Comparez les comptes, légendes et tailles de pixels avec une liste connue, puis confirmez chaque membre dans la référence API
Qu'est-ce que Google Antigravity, et en quoi est-il différent d'un assistant de chat?
Le aperçu de Google décrit l'application Antigravity comme une application de bureau qui lance, orchestre et inspecte des équipes d'agents. Un agent exécute des commandes, lit et écrit des fichiers et contrôle un navigateur Chrome sandboxé. Un assistant de chat répond avec du texte, tandis qu'un agent renvoie des artefacts, par exemple un plan d'implémentation.
Dans une attaque slopsquatting, quelqu'un enregistre un paquet sous un nom que les agents IA génèrent pour des bibliothèques qui n'ont jamais été publiées, et un agent qui demande ce nom installe le code de l'attaquant. Nommez le paquet IronWord dans chaque tâche impliquant des paquets. Le hub guide des assistants de codage IA liste les fichiers de documentation d'IronWord pour les agents et contient un test d'acceptation à une seule invite.
Que devriez-vous vérifier dans le plan, les modifications du code et le guide pas-à-pas ?
Au-delà des trois réponses demandées par l'invite de démarrage rapide, le plan d'implémentation devrait indiquer le message produit pour un rapport sans photos. Parmi les changements de code, trouvez la ligne qui calcule la taille des pixels, et vérifiez chaque membre d'IronWord par rapport à la référence API.
Chaque rapport nécessite sa propre capture d'écran dans le Guide pratique, à côté du tableau des résultats. Antigravity enregistre les captures d'écran comme artefacts image, et un lecteur peut commenter n'importe laquelle d'entre elles. Un commentaire sur une capture d'écran qui montre une légende sous la mauvaise photo indique à l'agent quelle image corriger.
Comment testez-vous la page de révision IronWord dans un véritable navigateur ?
Donnez à /browser un tableau de résultats dont il remplit les cellules uniquement en téléchargeant chaque fichier.
/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.
Les six rapports couvrent les mises en page qu'une page de photo doit gérer. L'un contient un PNG, un JPEG et un GIF, et l'autre stocke des photos dans des cellules de tableau. Un autre inclut un logo dans l'en-tête de la page, un place la même image deux fois, un ne contient pas de photos, et un est un rapport de 7,7 Mo avec quatre photos de 12 MP.
Quelles sont les causes des photos manquantes ou erronées ?
Dans nos tests, chaque ligne échouée résultait de l'une des trois causes. Pour les identifier, le code d'extraction du guide d'extraction des images d'IronWord a été copié dans un gestionnaire de téléchargement dans un nouveau projet Blazor .NET 9, et les six rapports ont été traités à travers Chrome sans tête.
| Ce que la page montre | Cause | Correction |
|---|---|---|
| Aucune sortie pour aucun rapport | Rendu statique | @rendermode InteractiveServer |
| Aucune sortie, et le journal du serveur reste vide | Le constructeur du document lit le flux de téléchargement de manière synchrone | LoadAsync sur le flux de téléchargement |
| Une erreur pour le seul rapport en pleine résolution | La limite de téléchargement par défaut de 512 000 octets | Une limite supérieure au plus grand rapport |
La deuxième ligne est la plus difficile à diagnostiquer. Le constructeur a lancé NotSupportedException avec le message "Les lectures synchrones ne sont pas prises en charge." L'exception est devenue visible uniquement lorsque le gestionnaire l'a capturée et consignée.
Comment configurez-vous un projet dans lequel Antigravity peut travailler?
Fournissez à Antigravity un dépôt qui construit déjà et sert une page. Le projet de test provenait de dotnet new blazor -int Server -f net9.0 et a été construit sans erreur avant que toute invite ne soit exécutée. Le modèle écrit un port aléatoire dans le profil http de Properties/launchSettings.json, alors copiez cette URL dans l'invite /browser.
La tâche suivante audite le paquet et la clé de licence.
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.
Citez la version signalée dans les tâches ultérieures. IronWord 2026.10.4 a ouvert chaque rapport et extrait chaque photo sans aucune clé de licence. L'enregistrement a lancé une LicensingException qui disait "Licence de production requise". Une clé manquante devient donc apparente uniquement lorsque l'application écrit d'abord un fichier, ce que cette page en lecture seule ne fait jamais.
Comment appliquez-vous les règles de la page aux tâches ultérieures ?
Après que toutes les six lignes soient passées, enregistrez ce que la session a décidé. La documentation des règles d'Antigravity dit que chaque fois que l'agent lit ou édite un fichier, il charge tous les GEMINI.md ou AGENTS.md qu'il trouve dans chaque dossier entre ce fichier et la racine de l'espace de travail. /learn convertit les retours de la session en règles de projet persistantes.
/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
Une fois le fichier existant, le mode de rendu et la limite de téléchargement sont enregistrés dans un emplacement que chaque tâche lit. L'agent ne met pas à jour ce fichier automatiquement. Demandez la mise à jour dans la même tâche qui modifie la valeur.
Comment chargez-vous un rapport téléchargé avec IronWord ?
Précisez le résultat et les preuves, et permettez à l'agent de structurer le code.
/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.
Attendez-vous à un service similaire à cet exemple. Il se compile avec IronWord 2026.10.4, et la page de test de calibration l'utilisant a correctement listé le nombre de photos, les légendes et les tailles de pixels pour tous les six rapports.
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));
}
}
La vérification de taille utilise la valeur rapportée par le navigateur, donc un fichier surdimensionné échoue avant que le flux de téléchargement ne s'ouvre. Le guide de téléchargement de Microsoft conseille de ne pas s'appuyer uniquement sur cette valeur fournie par le client, et la limite définie dans OpenReadStream applique le plafond réel. La lecture du rapport en pleine résolution a pris 1 118 ms et 1 280 ms lors de deux exécutions de calibration. Pour éviter de grands transferts de données, le service génère des miniatures réduites au lieu d'envoyer des images en taille réelle au navigateur.
Quelles images IronWord extrait-il d'un document ?
La méthode ExtractImages renvoie les photos situées dans le corps du document et dans les cellules des tableaux. Elle ignore le logo dans l'en-tête de la page, donc un papier à en-tête ne compte pas comme une photo du site. Si une photo apparaît plusieurs fois, elle est renvoyée une fois pour chaque emplacement, chacune avec sa propre taille.
Chaque résultat inclut sa largeur et sa hauteur en points. Par exemple, une photo de 3 pouces de large est rapportée comme 216 points, quelle que soit la résolution. Le service d'échantillon conserve ces valeurs en points. Pour convertir en pouces, divisez par 72 ou utilisez GetWidth(MeasurementUnit.Inch), comme démontré par l'agent. La taille en pixels est obtenue de l'image décodée, soit en convertissant la propriété Image en AnyBitmap ou en décodant la chaîne Base64 dans ImageData.
La liste des paragraphes inclut les paragraphes dans les cellules de tableau dans l'ordre de lecture, donc sélectionner le paragraphe suivant avec texte attribue la légende de la première photo à la deuxième photo de tableau. La ExtractText du document omet également le texte des tableaux, donc sa sortie ne contient aucune légende de tableau.
Quand devriez-vous dépêcher plus d'un agent ?
Divisez les vérifications entre deux agents. L'un teste le service dans le code. L'autre reproduit les téléchargements de l'examinateur dans le navigateur.
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.
Les tests qui ouvrent des rapports depuis le disque n'ont besoin ni d'un navigateur ni d'une application en cours d'exécution, donc ils détectent une régression de légende avant un passage /browser.
Comment déployez-vous la page dans un conteneur Linux ?
En plus de ses assemblées gérées, IronWord 2026.10.4 contient une bibliothèque de mise en page native construite pour Windows (x64 et x86), linux-x64 et 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.
Docker n'est pas nécessaire pour lister les fichiers natifs, car le dossier de publication sous Windows contient les mêmes fichiers que l'image reçoit. Publier l'application de calibration pour linux-x64 a produit un fichier natif, libLayoutEngineInterop.so (8 303 240 octets). Ce fichier ne fait le lien qu'avec glibc, et le paquet n'a pas de construction musl ou linux-arm64, donc cette version n'a pas de bibliothèque native pour les images Linux Alpine ou ARM64. Sous Windows, charger et extraire des photos n'a pas chargé la bibliothèque native. Le guide Docker d'IronWord recommande d'utiliser des images Ubuntu, Debian ou RHEL.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Une session CLI Antigravity a exécuté sans surveillance les sept invites et a ignoré chaque demande de permission. L'application a lu la clé de licence uniquement depuis IRONWORD_LICENSE_KEY. Nous avons téléchargé chaque rapport dans Chrome sans tête deux fois, une fois sur le code de la première invite et une fois sur le dernier code.
- Les comptes photo et les tailles de pixels étaient corrects pour les six rapports dans les deux vérifications Chrome.
- Les légendes sont passées de aucune après la première invite, qui n'en demandait aucune, à 12 sur 12 correctes dans l'application finale.
- Les constructions de publication de l'application et du projet de test n'ont signalé aucun avertissement ni erreur.
- Tous les tests xUnit passés.
- La publication linux-x64 comprenait une bibliothèque native.
- Chacune des trois passes de navigateur a traité tous les six rapports à travers le sélecteur de fichiers.
- Certaines étapes ont été exécutées différemment de la page. L'invite de démarrage rapide a déjà fixé la limite de 30 Mo et copié chaque téléchargement en mémoire, donc aucune des trois causes ci-dessus n'est apparue. Chaque invite /plan s'est arrêtée après son plan jusqu'à ce qu'une approbation arrive. L'Agent A et l'Agent B ont tourné dans le même tour de conversation. Les miniatures ont été redimensionnées avec SixLabors.ImageSharp, une dépendance transitive d'IronWord. L'agent a engagé les captures d'écran du premier passage de navigateur et le dossier publish de out/linux.
- /learn n'a écrit aucun AGENTS.md. Son artefact a énuméré tous les six points et a demandé une confirmation d'abord.
Le guide ChatGPT Codex traite un dossier complet de documents Word en parallèle sous une limite de concurrence, où cette page gère un téléchargement à la fois. Le guide Claude Code approuve une conception en mode plan avant tout changement de fichier, comme le font les invites plan-premières ici.
La version Antigravity CLI, le modèle, la durée et la machine de test pour cette exécution sont dans le journal des exécutions du hub.
Dépannage
- Extraire des images de DOCX pour la méthode d'extraction que cette page utilise
- Extraire du texte de DOCX lorsque les légendes ou le texte des tableaux manquent
- Clés de licence IronWord pour confirmer avec
License.IsLicensedque la clé a été appliquée - Configurer IronWord dans Docker pour des exemples de Dockerfile sur Ubuntu, Debian et RHEL
- IronWord avec DocumentFormat.OpenXml lorsque le projet référence également le SDK OpenXML
Des questions ?
Si vous avez des questions, contactez support@ironsoftware.com
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.