IronZIP ve Google Antigravity Nasıl Kullanılır

Curtis Chau
Curtis Chau
Güncellendi: 26 Ekim 2026

Müvekkillere dava belgelerini şifre korumalı bir ZIP olarak sunan bir sayfa, belgeleri eksik olan bir arşivle veya olağan bir dava için hata sayfasıyla ya da farklı bir davadan bir belgeyle gönderim yaparak hatasız derlenebilir.

Google Antigravity'nin /browser komutu, çalıştırılan sayfayı yönlendirebilen bir Chrome tarayıcı alt ajanı başlatır, böylece bir istem, bir parolayı yazabilir, her test davası için İndir'e basabilir ve her sonucun ekran görüntüsünü tutabilir. IronZIP, arşivi sunucuda AES-256 şifreleme ile oluşturur ve yeniden çıkartır, böylece sayfa her belgenin bit bit geri döndüğünü kanıtlayabilir. Bu kılavuz, IronZIP'in parola koruma örneğinden başlayarak bir ASP.NET Core MVC uygulamasında bu indirme sayfasını oluşturur ve belgeleri ile SHA-256 karmaları önceden bilinen beş davaya karşı kontrol eder.

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

PM > Install-Package IronZip

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

Antigravity'de CaseDocs klasörünü açın ve indirme sayfasını açıklayın.

/plan CaseDocs is an ASP.NET Core MVC project that targets .NET 9.
Add the case document download that docs/case-download-rules.md describes.

The download works like this:

- A user opens /Cases/{id}, ticks documents and types a password.
- The user receives an AES-256 encrypted ZIP that the server builds with IronZIP.
- The NuGet package is IronZIP version 2026.10.2, and its namespace is IronZip.

Program.cs reads IRONZIP_LICENSE_KEY and assigns it once to IronZip.License.LicenseKey.
Confirm only that the variable exists and how many characters it holds.
Never print, log or write its value.

The Implementation Plan must state these answers:

- the entry name each document receives inside the archive
- the path the archive is saved to before the response, and when that file is deleted
- how the saved archive is compared with the ticked documents

Stop once dotnet build succeeds, and tell me the build result.
Text

Kod değişikliklerinden önce bu üç cevabı okuyun. Her biri, derleyici hatası olmaksızın arşivin hangi şekilde yanlışlıkla oluşabileceğini kapsar. Başsansız agy -p kimse planı onaylamaz, bu yüzden plan Eserini tanımladığı kodun yanında okuyun.

Değişkeni istemde adlandırın ve asla değeri yapıştırmayın. Sohbete yazılan her şey bir kaynak dosyasına, bir commite veya bir terminal transkriptine ulaşabilir. IronZIP ayrıca appsettings.json içinde bir IronZip.LicenseKey girişi kabul eder, ve bir commit her şeyle birlikte bu dosyayı içerir. Desteklenen her yer lisans anahtarları kılavuzunda bulunmaktadır.



Değişiklikleri kabul etmeden önce neyi gözden geçirmelisiniz?

Her giriş adının nereden geldiğini, her arşivin kaydedildiği klasörü, onu silen satırı ve arşiv okuma kodunu kontrol edin. Ardından, IronZIP üyelerinin farkını API referansındaki ile karşılaştırarak onaylayın.

Antigravity ekran görüntülerini yorum kabul eden görüntü Eserleri olarak kaydeder. Bir hata sayfası veya yanlış belge sayısı gösterdiğinde, o ekran görüntüsüne yorum yazın, yeni bir madde başlatmayın.

Gerçek bir tarayıcıda her indirme nasıl test edilir?

Sadece gerçek indirmelerin doldurabileceği bir sonuç tablosu isteyin.

/browser Start CaseDocs in the background with dotnet run --launch-profile http.
That profile listens on http://localhost:5065.

For each row of TestData/expected.csv, do this:

1. Open /Cases/<case> and leave every checkbox as the page sets it.
2. Type the row's password and press Download.
3. Capture a screenshot of what follows.
4. When the answer is a file, take its name and size from the download or the response headers.

In the Walkthrough and in your reply, give one line per row with these parts:

- the case
- the documents the page listed, against the documents column
- the expected outcome
- what actually happened, as the file name and size or the message shown
- a PASS or FAIL verdict

For any failing row, cite the server log entry or error page text responsible.
Do that before you edit any code.
After every fix, restart the app and go through all six rows again.
Stop the app when you are done.
Text

Giriş adlarına yapılan bir düzeltme, daha önce başarılı olmuş davalar da dahil olmak üzere her arşivi değiştirir, bu nedenle istem altı satırın tümünü yeniden çalıştırır.

Lütfen dikkat: Öncelikle tek belge davasının ekran görüntüsünü açın. Diğer davaları geçen bir sayfa, orada hala bir hata sayfası iade edebilir.

Eksik veya başarısız indirmelere neler sebep olur?

Kalibrasyonumuzda, parola koruma örneğinden gelen kod bir indirme aksiyonuna taşındı. AES-256'ya geçildi ve kaydedilen arşivi açarak girişleri saydı. Başsanızsız Chrome daha sonra IronZIP 2026.10.2 ile her dava için İndir'e bastı. Aşağıdaki her başarısızlık derleyici uyarısı olmaksızın derlendi.

Ne olduNedenNeyi isteyin
Altı belgeli dava indirildi, ama çıkartıldığında 3 dosya verdiIronZIP her bir girişin adını yalnızca dosyanın adıyla verir, bu yüzden iki adet letter.pdf, iki adet scan.jpg ve iki adet summary.pdf dosyası isimleri paylaştıGiriş adları, göreceli yoldan oluşturuldu, ve bu isimler altında kopyalar kaydedildi
Tek belge davası bir hata sayfası döndürdüYapı okuma geri döndüğünde doğru parola ile 'Geçersiz Parola!' hatasını verdiArşivi çıkartan bir okuma geri döndürmesi
Boş dava bir hata sayfası döndürdü'Mevcut arşiv bozuk!' hatası atıldıIronZIP çalışmadan önce bir seçim kontrolü
../C-1001/ledger.csv'ye düzenlenen bir onay kutusu değeri, indirme içine başka bir davanın dosyasını koyduEylem gönderilmiş yolları güvendiGönderilen her yol çözüldü ve dava klasörünün içinde tutuldu
Dört ZIP dosyası geçici klasörde kaldıIronZIP yalnızca bir yola kaydeder ve hiçbiri dosyayı silmediHer istek başına bir klasör, istek sona erdiğinde silinir

Giriş sayısı kontrolü altı belgeli dava için geçti, çünkü arşiv altı giriş tutuyordu.

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

Ajanın zaten localhost'ta derleyen ve yanıtlayan bir uygulamaya ihtiyacı var. dotnet new mvc --framework net9.0 size bir tane verir, ve bir kez çalıştırıldığında Properties/launchSettings.json'da bağlantı noktasını gösterir. Bağlantı noktası projeden projeye farklılık gösterir ve /browser istemleri onu adlandırmak zorundadır. Tarayıcı'nın beyaz listesi öncelikle yalnızca localhost'u tutar, bu yüzden adresi http://localhost:<port> şeklinde tutun.

CaseFiles altında dava klasörlerini, docs/case-download-rules.md içinde kuralları, her dava ve şifre için sonucu içeren TestData/expected.csv'yi ve TestData/manifest.csv içinde her belgenin girişi adı, boyutu ve SHA-256'sını commitleyin. Beş test davası beş düz belge, altı belgeli üç isim üç klasör içinde tekrarlandığı belgeler, tek beyan, aksanlı ve Japon isimli üç belge ve hiç belge içermeyen bir dosya içeriyordu. Ardından ajanın paketi ve anahtarı kontrol etmesini sağlayın.

Which IronZIP version does CaseDocs.csproj reference? Quote its PackageReference line.
Then show the line in Program.cs that assigns the license key.
Add either line if it is missing.

IRONZIP_LICENSE_KEY is the only allowed source of that key.
Search these files for an IronZip.LicenseKey entry or a key value, and remove any you find:

- appsettings.json
- appsettings.Development.json
- Properties/launchSettings.json

When the variable is missing at startup, the app logs a single warning.
That warning mentions IRONZIP_LICENSE_KEY and contains no value.
Add it only if it is absent, and leave every other file alone.
Tell me what you found and what you changed.
Text

Daha sonra bir istem bir proje veya paket eklediğinde, her proje aynı IronZIP sürümüne karşı derlensin diye o sürüm numarasını tekrarlayın. Bellekten bir paket adı yazan bir ajan, hayal edilen bir ad altında yayınlanan kötü niyetli bir paketi yükleyebilir, bu saldırıya slopsquatting denir. Paket IronZIP ve ad alanı IronZip.

Değişken ayarlandı ve License.LicenseKey asla atanmadıysa, kalibrasyon sayfası dört arşiv davası için kaydetme çağrısında başarısız oldu. Her biri, 'Üretim Lisansı Gereklidir' okuyan bir LicensingException attı. IronZIP, kendi başına IRONZIP_LICENSE_KEY'yi okumadı, bu yüzden uygulama IronZip.License.LicenseKey'yi kendisi atamalıdır. IronZIP'in ajan dokümantasyon dosyaları ve tek istem kabul testi için, AI kodlama yardımcıları kılavuzuna bakın.

Hizmet belgeleri IronZIP'e nasıl iletmelidir?

Add, AddArchiveEntry ve FromFiles bir sondada klasörü bıraktı, hatta 2025/letter.pdf gibi görece bir yoldan bile ve çıktıda, aynı isimli iki girişin sonuncusunu tuttu. Bir klasör yolu eklemek UnauthorizedAccessException attı. Bu nedenle hizmet, her belgeyi kuralların verdiği isimle bir geçici klasöre kopyalar ve kopyaları ekler.

Yapıcı başarısızlığı, bir girişlik AES-256 arşivi açmanın her yolunu kapsar, bu yüzden akış, bayt dizisi ve FromArchive aşırı yüklemeleri aynı System.Exception'ı attı. İki veya daha fazla AES-256 girişi ile yapıcı, yanlış bir parolayla bile onları listeledi, oysa Geleneksel bir arşiv yapıcıda ZipException attı. Çıkarma, tek girişlik arşivi düzgün şekillerde geri döndürdü ve her yanlış, boş veya eksik parola için "Geçersiz parola!!" ile ArgumentException attı.

IronZIP 2026.10.2'de ZIP sıkıştırma seviyesi hiçbir fark yaratmadı. 0, 1, 6 ve 9 seviyeleri 1.042.684 baytlık sondaj belgelerinden 970.545 baytlık aynı arşivi üretti ve her yapım 119 ila 121 ms sürdü.

/plan Draft the Implementation Plan for this change, and wait for review before you edit anything.
Move every IronZIP call out of the controller into Services/CaseArchiveBuilder.cs.
Register it in DI as a singleton.
Given the case folder, the ticked relative paths and the password, it returns the ZIP bytes.

The service works in this order:

1. It copies each document into a new folder under the system temp path.
2. Each copy gets the entry name from the rules.
3. It adds those copies and saves the archive beside that folder.
4. It extracts that archive with the same password into a second folder.
5. It compares the SHA-256 of every extracted file with its source.
6. On any difference, it throws with the document's entry name.

Both folders are removed in a finally block.
The controller keeps the password, selection and path checks.
Afterward, repeat the /browser pass over TestData/expected.csv and report each row.
Text

Ajanın hizmetini bununla karşılaştırın. IronZIP 2026.10.2'ye karşı derler ve tüm dört arşivi bırakır ve arkalarında geçici bir klasör bırakmaz.

using System.Security.Cryptography;
using IronZip;
using IronZip.Enum;

public sealed class CaseArchiveBuilder
{
    public byte[] Build(string caseFolder, IReadOnlyList<string> relativePaths, string password)
    {
        var work = Path.Combine(Path.GetTempPath(), "case-" + Guid.NewGuid().ToString("N"));
        var staged = Path.Combine(work, "staged");
        var check = Path.Combine(work, "check");
        Directory.CreateDirectory(staged);
        try
        {
            var sources = new Dictionary<string, string>();
            foreach (var relativePath in relativePaths)
            {
                var entryName = relativePath.Replace('/', '_');
                var source = Path.Combine(caseFolder, relativePath);
                File.Copy(source, Path.Combine(staged, entryName));
                sources.Add(entryName, source);
            }

            var zipPath = Path.Combine(work, "case.zip");
            using (var archive = new IronZipArchive())
            {
                archive.Encrypt(password, EncryptionMethods.AES256);
                foreach (var entryName in sources.Keys)
                    archive.Add(Path.Combine(staged, entryName));
                archive.SaveAs(zipPath);
            }

            IronZipArchive.ExtractArchiveToDirectory(zipPath, check, password);
            if (Directory.GetFiles(check).Length != sources.Count)
                throw new InvalidOperationException("The archive does not hold one entry per document.");
            foreach (var (entryName, source) in sources)
            {
                var extracted = Path.Combine(check, entryName);
                if (!File.Exists(extracted) ||
                    !SHA256.HashData(File.ReadAllBytes(extracted)).SequenceEqual(SHA256.HashData(File.ReadAllBytes(source))))
                    throw new InvalidOperationException($"{entryName} did not come back from the archive intact.");
            }
            return File.ReadAllBytes(zipPath);
        }
        finally
        {
            Directory.Delete(work, recursive: true);
        }
    }
}
C#

Her arşivin doğru dosyalar içerdiğini nasıl kanıtlarsınız?

/goal hedefi karşılanana kadar çalışır ve yol boyunca onay istemez.

/goal Every archive the download page produces matches TestData/manifest.csv.

Create a console project at tools/ArchiveAudit that meets these conditions:

- It references IronZIP 2026.10.2.
- The web project's compile items exclude it.
- Its startup copies IRONZIP_LICENSE_KEY into IronZip.License.LicenseKey.

Start CaseDocs with dotnet run --launch-profile http before the first post.
Stop it once the audit passes.

For each expected.csv row with the outcome zip, the audit does this:

1. Post that case page's form with every document ticked and the row's password.
2. Store the response as audit-output/<case>.zip.
3. Extract it with IronZipArchive.ExtractArchiveToDirectory and the password.
4. Confirm that the entry names and SHA-256 values equal that case's manifest rows.

Confirm too that extraction with a wrong password throws.
Keep fixing the app and rerunning the audit until all four archives pass.
Then put the results table in the Walkthrough and in your reply.
Text

.NET'in kendi okuyucusu bu kontrolü yapamaz. System.IO.Compression kalibrasyon AES-256 arşivlerin giriş adlarını listeledi, ancak tüm 15 girişin içeriği için "desteklenmeyen sıkıştırma yöntemi" InvalidDataException attı, bu nedenle ona dayanarak inşa edilen bir test, bir bayt okumadan girişleri sayabilir.

İndirme kurallarını daha sonraki görevlerde nasıl uygularsınız?

Antigravity'nin kurallar dokümanına göre, kurallar AGENTS.md, GEMINI.md ve düzenlenmiş dosyadan itibaren çalışma kuruş köküne kadar her klasördeki .agents/rules/ *.md dosyalarından gelir. .agents/rules içindeki dosyalar, geçerli bir trigger ismi veren bir ön bilgi içerecek şekilde açılmalıdır ve eksik veya tanınmayan bir tetikleyici Antigravity'nin kuralı bir mesaj göndermeden düşürmesini sağlar. model_decision ile yalnızca kuralın yolu ve tanımı isteğe girer, ve ajan, görevi açıklamaya uyuyorsa tam metni yükler.

/learn oturumdan gelen düzeltmeleri bir kural veya bir beceri haline getirir. Eğik çizgi komutları sayfası, AGENTS.md, GEMINI.md veya .agents/rules içindeki bir dosya yazabileceğini söylüyor, bu yüzden kuralla adı istemde girin.

/learn Turn what this session established about case downloads into a rule.
Write it at .agents/rules/case-archives.md.
Start the file with YAML frontmatter that sets trigger: model_decision.
Add a description saying the rule applies to work on case downloads or IronZIP archives.

The rule covers these points:

- how entry names are formed, and why
- how the saved archive is verified
- which temporary folders each request creates, and when they are deleted
- the messages for a short password and an empty selection
- that no change to the download is finished until two checks succeed

Those two checks are the expected.csv browser pass and the tools/ArchiveAudit run.
Record only what this session verified, and list anything unproven as open.
Text

Sonrasında, dosyanın ilk satırlarını okuyun ve ön bilgilerinin model_decision tetikleyicisini yılan durumu ile yazdığını doğrulayın.

Ne zaman birden fazla ajan gönderilmeli?

Otomatik testleri bir ajana ve tarayıcı kanıtlarını bir diğerine verin.

Split this work between Agent A and Agent B.

Agent A creates CaseDocs.Tests, an xUnit project that references IronZIP 2026.10.2.
Keep it outside the web project's build.
The tests work like this:

- They start the app with WebApplicationFactory<Program>.
- They post the download form for every expected.csv row and assert the outcome.
- For zip rows, they extract the response with IronZIP into a temporary folder.
- They compare the names and SHA-256 values with manifest.csv.
- One test shows that a path outside the case folder gets a 400 response.
- They assert on extracted files, never on archive bytes.

Agent B starts once Agent A's suite passes:

1. Start the app with dotnet run --launch-profile http (http://localhost:5065).
2. Use /browser to download C-1002 and C-1003 from their case pages, and record each session.
3. Read each file's name and size from what the browser receives or from the response headers.
4. Stop the app.
5. Add the two recordings and one screenshot per finished page to the Walkthrough.

If there is no Walkthrough, save them under audit-output/ instead.
List them with those names and sizes in your reply.
If Agent A's suite does not pass, report the failing tests instead.
Text

WebApplicationFactory yoluyla formu gönderen testler, tarayıcıya ve açık porta ihtiyacı yoktur, bu yüzden birkaç saniye içinde bozuk bir giriş adını yakalarlar.

Lütfen dikkat: Masaüstü uygulamada, Ajans A ve Ajans B ayrı arka plan ajanları olarak çalışabilir. Ajans B'nin kayıtlarını yalnızca, Ajans A'nın takımı, aynı commiteta önce geçtiyse güvenin.

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

Tüm yedi istem, klavyede kimse olmadan, sırayla tek bir Antigravity CLI sohbetinde, .NET 9 MVC uygulamada beş dava, kurallar ve iki CSV dosyaları içeren bir uygulamada çalıştırıldı. Aşağıdaki rakamlar, kendi Release yapılarımızdan, başsansız Chrome indirmelerinden ve IronZIP çıkarmalarından geliyor, ajanın yanıtlarından değil.

  • İstem 01'den sonra ve nihai uygulamada, kod bağımsız tarayıcı geçişinde beklenen altı .csv satırının tümünü eşleştirdi ve düzenlenmiş yolu bir 400 ile yanıtladı.
  • Her iki noktada, IronZIP, indirmelerden her birinin MANIFEST'in adlarını ve SHA-256 değerlerini 5'te 5, 6'da 6, 1'de 1 ve 3'te 3 belgeler için iade etti.
  • Her iki noktada, yanlış bir parola ile çıkarma "Geçersiz parola!!" attı.
  • Nihai arşivler yukarıdaki hizmetin ürettiği aynı boyutlarda 979.949, 779.422, 3.637 ve 154.332 bayttı.
  • Nihai indirme geçişi, geçici klasörde hiçbir CaseDocs dosyası bırakmadı.
  • Uygulama, denetim aracı ve test projesinin Release yapıları 0 uyarı ve 0 hata bildirildi.
  • xUnit takımı 7'de 7 geçti 2 saniyede.
  • Okuma geri yazmazdan önce, istem 01, IronZIP'i test etti ve bir girişlik başarısızlığa ulaştı.
  • İstem 01'in denetleyicisi, birden fazla belge işaretlendiğinde yalnızca yapıcı ile arşivi açtı.
  • Tek bir belge için, bu denetleyici, girişi System.IO.Compression listeledi.
  • İstem 04, bu kontrolü çıkarma ve bir SHA-256 karşılaştırması ile değiştirdi.
  • /goal denetimi, ilk çalıştırmasında düzeltilecek bir şey olmadan geçti.
  • /learn, model_decision tetikleyicisi ile 68 satırlık bir kural yazdı.
  • İstem 03'te ajans, çift tırnakları IRONZIP_LICENSE_KEY genişleterek eksik anahtar uyarısını bir iç içe powershell -Komut ile test etti.
  • Ortaya çıkan hata mesajı anahtar değerini modelde ve Antigravity'nin .gemini/antigravity-cli'si altındaki transkript dosyalarına taşıdı, oysa hiçbir depo dosyası onu içermiyordu.
  • Bazı adımlar sayfadan farklı çalıştı. /browser alt ajansı, test makinesinde Chrome'a ​​bağlanmadı ('DevToolsActivePort bulunamadı'), bu yüzden ajan her tarayıcı geçişi için kendine ait bir Playwright senaryosu ile başsansız Chrome'u sürdü, ekran görüntüleri ve her iki kaydı da. Cevabı hala tarayıcı alt ajanına kredi verdi. İstemler 01, 04 ve 06 her biri gözden geçirilmek için beklediklerini söylediler ve sonra aynı dönüşde düzenlendiler. CLI, tüm konuşma için bir plan ve bir Yürüyüşü korudu ve daha sonraki istemler her ikisini de üzerine yazıldığı için, yalnızca yanıtlar önceki tabloları sakladı. /learn kuralı, IronZIP'yi yeniden derleme nedeni olarak aldı ve bunları çıkarmanın bir yolu olarak System.IO.Compression adını verdi. Bir ajan aynı konuşmanın tek bir dönüşünde iki ajanlı gereksinimlerin her iki yarısını da gerçekleştirdi. Denetim aracı, .NET 10'u hedefler. Her izin istemi atlandı.

ChatGPT Codex kılavuzu, bir arşiv alma işini keşif ve işçi ajanlar arasında böler ve çalıştırması dört ajan iş parçacığı oluşturdu. Claude Code kılavuzu, plan modunda şifrelenmiş dava arşivlerinin yerinde bir güncellemesini planlar, burada olduğu gibi /plan istemleri bunu yapar. Hub'un çalıştırma kaydı, Antigravity sürümünü, modeli, istem sürelerini ve test makinesini veriyor.


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 25,383Sürüm:2026.11yeni çıktı