IronWord'u Google Antigravity ile Nasıl Kullanılır

Curtis Chau
Curtis Chau
Güncellendi: 19 Ekim 2026

Saha mühendisleri Word dosyaları olarak inceleme raporlarını sunar ve ekli fotoğraflar kanıttır. Hatalar olmadan oluşturulan bir inceleme sayfası, fotoğrafları düşürdüğünde, tablolar içindeki görüntüleri kaldırdığında, yanlış başlıklar atadığında veya yanlış fotoğraf boyutlarını rapor ettiğinde yine de başarısız olur. Bir derleme günlüğü bu hatalardan hiçbirini kaydetmez.

Google Antigravity sayfayı bir değerlendiricinin yaptığı gibi test edebilir. sandboxed tarayıcı alt ajanı, /browser komutu ile başlatılarak sayfayı açar, dosya kontrolünde her raporu seçer ve sonucun ekran görüntüsünü alır. Sunucuda, IronWord yüklenen DOCX dosyalarını açar ve Microsoft Office kurulumu olmadan fotoğraflarını ExtractImages üzerinden döndürür. Aşağıdaki inceleme sayfası her iki araçla birlikte inşa edilmiştir ve bilinen fotoğraf sayıları, başlıkları ve piksel boyutlarına sahip altı rapora karşı test edilmiştir.

Kılavuz, AI ajanlarının Word belgelerini okuyan .NET kodu yazarları için yazılmıştır. Raporların kendisini bir AI modeli ile oluşturmak kapsam dışıdır.

Hızlı Başlangıç
NuGetNuGet ile Yükle

PM > Install-Package IronWord

Yukarıdaki komutu NuGet Paket Yöneticisi Konsolunda çalıştırarak veya NuGet Paket Yöneticisinde arama yaparak IronWord'u yükleyin.

Antigravity, Blazor projesini açtığında /plan isteminde inceleme sayfasını tanımlayın.

/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

Başarılı bir derleme, planın kapsaması gereken üç sorunun hiçbirine yanıt vermez. Microsoft'un render modları kılavuzu bir sayfanın etkileşimli olduğu zamanı açıklar ve Blazor dosya yükleme kılavuzu yükleme işlemlerini ve boyut sınırlamalarını kapsar.

Ajana değişkenin adını sağlayın, ancak değerini paylaşmayın. IronWord ayrıca appsettings.json dosyasındaki bir IronWord.LicenseKey girdisini okur, ki bu dosya yanlışlıkla bir commit ile dahil edilebilir. Lisans anahtarı kılavuzu, IronWord'un anahtar için kontrol ettiği tüm yerleri listeler.



Google Antigravity nedir ve bir sohbet asistanından nasıl farklıdır?

Google'ın genel bakışı Antigravity uygulamasını masaüstü uygulaması olarak tanımlar; bu uygulama ajan takımlarını başlatır, düzenler ve gözden geçirir. Bir ajan komutları çalıştırır, dosyaları okur ve yazar ve sandboxed bir Chrome tarayıcısını kontrol eder. Bir sohbet yardımcısı metinle yanıt verirken, bir ajan, örneğin bir Uygulama Planı gibi Eserler döndürür.

slopsquatting saldırısında, AI ajanlarının daha önce yayımlanmamış kütüphaneler için ürettiği bir ad altında bir paket kişi kaydeder, ve bu ismi talep eden ajan saldırganın kodunu kurar. Paketleri içeren her görevde IronWord paketinin adını verin. Merkez AI kodlama yardımcıları kılavuzu, ajanlar için IronWord'un dokümantasyon dosyalarını listeler ve tek istemli bir kabul testi içerir.

Planda, kod değişikliklerinde ve Kılavuzda neyi kontrol etmelisiniz?

Hızlı Başlangıç istemi tarafından istenen üç cevabın ötesinde, Uygulama Planı fotoğrafların olmadığı bir rapor için üretilen mesajı belirtmelidir. Kod değişiklikleri arasında, piksel boyutunu hesaplayan satırı bulun ve her IronWord üyesini API referansı ile kontrol edin.

Her rapor, sonuç tablosunun yanında Gezinti'de kendi ekran görüntüsünü gerektirir. Antigravity, ekran görüntülerini görüntü eserleri olarak kaydeder ve bir okuyucu herhangi biri hakkında yorum yapabilir. Yanlış fotoğrafın altında bir başlık gösteren bir ekran görüntüsündeki yorum, ajana hangi görüntünün düzeltileceğini söyler.

IronWord inceleme sayfasını gerçek bir tarayıcıda nasıl test edersiniz?

/browser'a hücrelerini sadece her dosyayı yükleyerek doldurduğu bir sonuç tablosu verin.

/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

Altı rapor, bir fotoğraf sayfasının ele alması gereken düzenleri kapsar. Biri bir PNG, bir JPEG ve bir GIF içerir, ve biri fotoğrafları tablo hücrelerinde saklar. Bir diğeri sayfa başlığında bir logo içerir, biri aynı görüntüyü iki kez yerleştirir, biri hiç fotoğraf içermez ve biri dört 12 MP fotoğraf ile 7.7 MB rapor.

Lütfen dikkat: Tam çözünürlüklü raporun ekran görüntüsünü önce inceleyin, çünkü bu artan sınırın etkili olup olmadığını gösterir.

Kayıp veya yanlış fotoğraflara ne sebep olur?

Testlerimizde, başarısız olan her satır üç nedenden birine dayandı. Bunları tanımlamak için IronWord'un görüntüleri çıkarma kılavuzundan çıkarma kodu yeni bir .NET 9 Blazor projesinde bir yükleme işleyicisine kopyalandı ve altı rapor başsız Chrome üzerinden işlendi.

Sayfanın gösterdiğiNedenDüzelt
Hiçbir rapor için çıktı yokStatik render@rendermode InteractiveServer
Hiçbir çıktı yok ve sunucu günlüğü boş kalıyorBelge yapıcı yükleme akışını eşzamanlı okurYükleme akışında LoadAsync
Sadece tam çözünürlüklü rapor için bir hata512.000 bayt varsayılan yükleme sınırıEn büyük rapor üzerinde bir sınır

İkinci satırı teşhis etmek en zordur. Yapıcı, 'Eşzamanlı okurlar desteklenmiyor.' mesajı ile NotSupportedException fırlattı. İstisna, yalnızca işleyici onu yakalayıp günlüğe kaydettiğinde görünür hale geldi.

Antigravity'nin çalışabileceği bir proje nasıl kurulur?

Antigravity'ye halihazırda bir sayfa oluşturan ve sunan bir depo verin. Test projesi dotnet new blazor -int Server -f net9.0'den geldi ve herhangi bir istem çalışmadan önce 0 hata ile oluşturdu. Şablon, Properties/launchSettings.json'un http profilinde rastgele bir port yazar, bu nedenle o URL'yi /browser isteğine kopyalayın.

Bir sonraki görev paketi ve lisans anahtarını denetler.

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

Sonraki görevlerde bildirilen sürümü alıntı yapın. IronWord 2026.10.4 her raporu açtı ve hiçbir lisans anahtarı olmadan her fotoğrafı çıkardı. Kaydetme 'Üretim Lisansı Gereklidir' okunan bir Lisanslama İstisnası fırlattı. Bu nedenle eksik bir anahtar, uygulama ilk kez bir dosya yazdığında belli olur, ki bu salt okunur sayfa asla yapmaz.

Sayfanın kurallarını sonraki görevlere nasıl uygularsınız?

Tüm altı satır geçtiğinde, oturumun verdiği kararı kaydedin. Antigravity'nin kurallar dokümantasyonu, ajan her dosyayı okuduğunda veya düzenlediğinde, o dosya ve çalışma alanı kökü arasındaki her klasörde bulduğu GEMINI.md veya AGENTS.md tümünü yüklediğini belirtir. /learn oturumdan gelen geri bildirimi kalıcı proje kurallarına dönüştürür.

/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

Dosya var olduğunda, render modu ve yükleme sınırı her görevin okuduğu tek bir konumda kaydedilir. Ajan bu dosyayı otomatik olarak güncellemez. Değeri değiştiren aynı görevde güncellemeyi isteyin.

IronWord ile yüklenen bir raporu nasıl yüklersiniz?

Sonucu ve kanıtları belirtin ve ajana kodu yapılandırmasına izin verin.

/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

Bu örnek benzeri bir hizmet bekleyin. IronWord 2026.10.4 ile derlenir, ve onu kullanan kalibrasyon test sayfası tüm altı raporun fotoğraf sayısını, başlıklarını ve piksel boyutlarını doğru bir şekilde listeler.

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#

Boyut kontrolü, tarayıcı tarafından bildirilen değeri kullanır, bu nedenle aşırı büyük bir dosya yükleme akışı açılmadan önce başarısız olur. Microsoft'un yükleme kılavuzu, yalnızca bu istemci tarafından sağlanan değere güvenmemeyi önerir ve OpenReadStream'de ayarlanan sınır, gerçek sınırı zorlar. Tam çözünürlüklü raporun okunması, iki kalibrasyon çalışmasında 1.118 ms ve 1.280 ms sürdü. Büyük veri transferlerinden kaçınmak için, hizmet tarayıcıya tam boyutlu görüntüler göndermek yerine ölçeklenmiş küçük resimler üretir.

IronWord bir belgeden hangi görüntüleri çıkarır?

ExtractImages yöntemi, belge gövdesinde ve tablo hücrelerinde bulunan fotoğrafları döndürür. Sayfa başlığındaki logoyu atlar, bu nedenle bir başlık sayfa fotoğrafı olarak sayılmaz. Bir fotoğraf birden fazla kez görünürse, her yerleşim için bir kez, her biri kendi boyutuyla döndürülür.

Her sonuç, genişliği ve yüksekliğini puanlar bazında içerir. Örneğin, 3 inç genişliğinde bir fotoğraf, çözünürlükten bağımsız olarak 216 puan olarak rapor edilir. Örnek hizmet bu puan değerlerini tutar. Inç’e dönüştürmek için 72'ye bölün veya ajan tarafından gösterildiği gibi GetWidth(MeasurementUnit.Inch) kullanın. Piksel boyutu kodlanmış görüntüden elde edilir, ya Image özelliğinin AnyBitmap'a dönüştürülmesiyle ya da ImageData'daki Base64 dizgisinin çözülmesiyle.

Paragraf listesi, okuma sırasındaki tablo hücrelerindeki paragrafları içerir, böylece metin içeren bir sonraki paragrafı seçmek, ilk fotoğrafın başlığını ikinci tablo fotoğrafına atar. Belgenin ExtractText tablo metnini de içermez, bu nedenle çıktısı tablo başlıkları içermez.

Ne zaman birden fazla ajan gönderilmeli?

Kontrolleri iki acenta arasında bölün. Biri hizmeti kodda test eder. Diğeri gözden geçirenin tarayıcıdaki yüklemelerini tekrarlar.

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

Diskten rapor açan testler, ne bir tarayıcıya ne de çalışan bir uygulamaya ihtiyaç duyar, bu nedenle bir /browser geçmeden önce bir başlık gerilemesi tespit ederler.

Lütfen dikkat: Masaüstü uygulamasında, her agent ayrı bir görev olarak çalışabilir. İki Gezinti arasında, birleştirme yapmadan önce karşılaştırın.

Sayfayı bir Linux konteynırına nasıl dağıtırsınız?

Yönetilen montajlarının yanı sıra, IronWord 2026.10.4 Windows (x64 ve x86), linux-x64 ve macOS için yerel bir yerleşim kütüphanesi içerir.

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

Yerel dosyaları listelemek için Docker gerekmiyor, çünkü Windows'taki yayın klasörü, görüntünün aldığı aynı dosyaları tutar. linux-x64 için kalibrasyon uygulamasını yayınlamak bir yerel dosya üretti, libLayoutEngineInterop.so (8.303.240 bayt). Bu dosya yalnızca glibc'ye karşı bağlanır ve paketin musl veya linux-arm64 sürümü yoktur, bu nedenle bu sürümde Alpine veya ARM64 Linux görüntüleri için yerel kütüphane yoktur. Windows'ta, fotoğrafların yüklenmesi ve çıkarılması yerel kütüphaneyi yüklemedi. IronWord'un Docker kılavuzu Ubuntu, Debian veya RHEL görüntülerini kullanmayı önerir.

Gerçek bir çalıştırmada istemler ne üretti?

Bir Antigravity CLI oturumu tüm yedi isteği gözetimsiz çalıştırdı ve her izin istemini geçti. Uygulama, lisans anahtarını yalnızca IRONWORD_LICENSE_KEY'den okudu. Koddan ilk istemde ve nihai kodda her raporu başsız Chrome'da iki kez yükledik.

  • Fotoğraf sayıları ve piksel boyutları, her iki Chrome kontrolünde de tüm altı rapor için doğruydu.
  • Başlıklar, hiç istenmeyen ilk istemden sonra hiç yoktan nihai uygulamada 12'nin 12'si doğruya gitti.
  • Uygulamanın ve test projesinin sürüm oluşturularak 0 uyarı ve 0 hata bildirildi.
  • Yedi xUnit testinin tamamı geçti.
  • linux-x64 yayın bir yerel kütüphane içeriyordu.
  • Üç tarayıcı geçişinin her biri dosya seçici aracılığıyla altı raporun tamamını işledi.
  • Bazı adımlar sayfadan farklı çalıştı. Hızlı Başlangıç istemi zaten 30 MB'lık sınırı ayarladı ve her yüklemeyi belleğe kopyaladı, bu yüzden yukarıdaki üç nedenin hiçbiri görünmedi. Her /plan istemi, bir onay gelene kadar planı durdurdu. Ajan A ve Ajan B aynı konuşmanın tek bir turunda çalıştı. Thumbnail'lar, geçişli bir IronWord bağımlılığı olan SixLabors.ImageSharp ile yeniden boyutlandırıldı. Ajan, ilk tarayıcı geçişinin ekran görüntüleri ve out/linux yayın klasörünü taahhüt etti.
  • /learn, AGENTS.md yazmadı. Eseri, altı puanın tamamını listeledi ve önce onay istedi.

ChatGPT Codex kılavuzu, bu sayfanın aynı anda bir yüklemeyi ele aldığı yerde, .Word belgelerinin bir klasörünü tümüyle eşzamanlılık sınırı altında işlemden geçirir. Claude Code kılavuzu, burada olduğu gibi, herhengi bir dosya değişikliği öncesinde tasarımı plan modunda onaylar.

Bu yürütme için Antigravity CLI sürümü, modeli, süresi ve test makinesi merkezin çalışma kaydında bulunabilir.


Hata Ayıklama


Sorular?

Herhangi bir sorunuz varsa, support@ironsoftware.com adresinden bize ulaşın

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

Daha Fazla Oku

Başlamaya Hazır mısınız?

NuGet İndirmeleri 62,392Sürüm:2026.11yeni çıktı