Wie verwende ich IronZIP mit Google Antigravity

Curtis Chau
Curtis Chau
Aktualisiert: 26. Oktober 2026

Eine Seite, die den Kunden ihre Falldokumente als passwortgeschütztes ZIP übergibt, kann fehlerfrei kompiliert werden und dennoch ein Archiv mit fehlenden Dateien senden, eine Fehlerseite für einen gewöhnlichen Fall oder ein Dokument aus einem anderen Fall.

Der /browser-Befehl von Google Antigravity startet einen Chrome-Browser-Subagenten, der die laufende Seite steuern kann, sodass eine Eingabeaufforderung ein Passwort eingeben, für jeden Testfall auf 'Download' drücken und einen Screenshot jedes Ergebnisses speichern kann. IronZIP erstellt das Archiv auf dem Server mit AES-256-Verschlüsselung und extrahiert es erneut, sodass die Seite beweisen kann, dass jedes Dokument bytegenau zurückgekommen ist. Dieser Leitfaden baut diese Download-Seite in einer ASP.NET Core MVC-App auf, beginnend mit dem Beispiel für Passwortschutz von IronZIP und überprüft sie gegen fünf Fälle, deren Dokumente und SHA-256-Hashes im Voraus bekannt sind.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package IronZip

Installieren Sie IronZIP, indem Sie den obigen Befehl in der NuGet Packet Manager-Konsole ausführen, oder suchen Sie das Paket im NuGet Paket Manager.

Öffnen Sie den Ordner CaseDocs in Antigravity und beschreiben Sie die Download-Seite.

/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

Lesen Sie diese drei Antworten, bevor der Code geändert wird. Jede deckt einen Weg ab, wie das Archiv ohne Compiler-Fehler schiefgehen kann. In kopfloser agy -p genehmigt niemand den Plan, also lesen Sie das Plan-Artefakt neben dem Code, den es beschreibt.

Bennen Sie die Variable in der Eingabeaufforderung und fügen Sie niemals den Wert ein. Alles, was in das Gespräch getippt wird, kann eine Quelldatei, ein Commit oder ein Terminalprotokoll erreichen. IronZIP akzeptiert auch einen IronZip.LicenseKey-Eintrag in appsettings.json, und ein Commit umfasst diese Datei mit allem anderen. Jeder unterstützte Standort befindet sich im lizenzschlüssel-Leitfaden.



Was sollten Sie überprüfen, bevor Sie die Änderungen akzeptieren?

Überprüfen Sie, woher jeder Eintragsname stammt, den Ordner, in den jedes Archiv gespeichert ist, die Zeile, die es löscht, und den Code, der das Archiv zurückliest. Bestätigen Sie dann jeden IronZIP-Mitglied in der Diff gegenüber der API-Referenz.

Antigravity speichert Screenshots als Bild-Artefakte, die Kommentare akzeptieren. Wenn eine eine Fehlerseite oder die falsche Dokumentenzahl zeigt, kommentieren Sie diesen Screenshot, anstatt eine neue Eingabeaufforderung darüber zu schreiben.

Wie testen Sie jeden Download in einem echten Browser?

Fragen Sie nach einer Ergebnistabelle, die nur reale Downloads ausfüllen können.

/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

Ein Fix der Eintragsnamen ändert jedes Archiv, selbst für bereits bestandene Fälle, weshalb die Eingabeaufforderung alle sechs Zeilen erneut ausführt.

Bitte beachten Sie: Öffnen Sie zuerst den Screenshot für den Ein-Dokument-Fall. Eine Seite, die die anderen Fälle besteht, kann dort dennoch eine Fehlerseite zurückgeben.

Was verursacht unvollständige oder fehlgeschlagene Downloads?

In unserer Kalibrierung wurde der Code aus dem Beispiel für Passwortschutz in eine Download-Aktion verschoben. Es wurde zu AES-256 gewechselt und die Einträge des gespeicherten Archivs gezählt, indem es mit dem Konstruktor geöffnet wurde. Headless Chrome hat dann für jeden Fall mit IronZIP 2026.10.2 auf 'Download' gedrückt. Jeder unten stehende Fehler wurde ohne Warnung kompiliert.

Was passiert istUrsacheWonach Sie fragen sollten
Der sechs-Dokument-Fall wurde heruntergeladen, aber beim Extrahieren ergaben sich 3 DateienIronZIP benennt jeden Eintrag nur nach der Datei, sodass zwei letter.pdf, zwei scan.jpg und zwei summary.pdf-Dateien Namen teiltenEintragsnamen wurden aus dem relativen Pfad erstellt, mit Kopien, die unter diesen Namen gespeichert wurden
Der Ein-Dokument-Fall gab eine Fehlerseite zurückDer Rücklese-Konstruktor warf 'Ungültiges Passwort!' mit dem richtigen PasswortEin Rücklese, das das Archiv extrahiert
Der leere Fall gab eine Fehlerseite zurückDas Speichern eines Archives ohne Einträge warf 'Das bestehende Archiv ist beschädigt!'Ein Auswahlcheck bevor IronZIP läuft
Ein geänderter Kontrollkästchenwert zu ../C-1001/ledger.csv stellte die Datei eines anderen Falls in den DownloadDie Aktion vertraute geposteten PfadenJeder gepostete Pfad wurde aufgelöst und innerhalb des Fall-Ordners gehalten
Vier ZIP-Dateien verblieben im temporären OrdnerIronZIP speichert nur auf einem Pfad, und nichts löschte die DateiEin Ordner pro Anfrage, der gelöscht wird, wenn die Anfrage endet

Der Eintragsanzahl-Check bestand für den sechs-Dokument-Fall, weil das Archiv sechs Einträge enthielt.

Wie richtet man ein Projekt ein, in dem Antigravity arbeiten kann?

Der Agent benötigt eine App, die bereits auf localhost baut und antwortet. dotnet new mvc --framework net9.0 gibt Ihnen eine, und wenn Sie sie einmal ausführen, wird der Port in Properties/launchSettings.json angezeigt. Der Port unterscheidet sich von Projekt zu Projekt, und die /browser-Aufforderungen müssen ihn benennen. Die Whitelist des Browsers hält zunächst nur localhost, also halten Sie die Adresse im http://localhost:<port>-Format.

Committen Sie die Fall-Ordner unter CaseFiles, die Regeln in docs/case-download-rules.md, TestData/expected.csv mit dem Ergebnis für jeden Fall und Passwort und TestData/manifest.csv mit dem Eintragsnamen, der Größe und dem SHA-256 jedes Dokuments. Die fünf Testfälle enthielten fünf einfache Dokumente, sechs Dokumente mit drei Namen, die sich über Unterordner wiederholten, ein einziges Statement, drei Dokumente mit Akzenten und japanischen Namen und gar keine Dokumente. Lassen Sie dann den Agent das Paket und den Schlüssel prüfen.

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

Wiederholen Sie diese Versionsnummer, wann immer eine spätere Eingabeaufforderung ein Projekt oder ein Paket hinzufügt, sodass jedes Projekt gegen die gleiche IronZIP-Version gebaut wird. Ein Agent, der einen Paketnamen aus dem Gedächtnis schreibt, kann ein bösartiges Paket installieren, das unter einem halluzinierten Namen veröffentlicht wurde, ein Angriff, der als Slopsquatting bezeichnet wird. Das Paket ist IronZIP und der Namensraum ist IronZip.

Mit der gesetzten Variable und License.LicenseKey nie zugewiesen, scheiterte die Kalibrierungsseite beim Speichern-Aufruf für alle vier Archivfälle. Jeder warf eine LicensingException mit dem Hinweis 'Produktionslizenz erforderlich'. IronZIP las IRONZIP_LICENSE_KEY nicht selbst, also muss die App IronZip.License.LicenseKey selbst zuweisen. Für die Dokumentationsdateien des IronZIP-Agents und einen Ein-Aufruf-Akzeptanztest, siehe den AI-Coding-Assistent-Leitfaden.

Wie sollte der Dienst Dokumente an IronZIP übergeben?

Add, AddArchiveEntry und FromFiles ließen den Ordner bei einer Probe fallen, selbst von einem relativen Pfad wie 2025/letter.pdf, und das Extrahieren behielt den letzten von zwei gleichnamigen Einträgen. Das Hinzufügen eines Ordnerpfads warf UnauthorizedAccessException. Der Service kopiert daher jedes Dokument in einen temporären Ordner unter dem Namen, den die Regeln ihm geben, und fügt die Kopien hinzu.

Der Konstruktorfehler deckt jeden Weg ab, ein Ein-Eintrag-AES-256-Archiv zu öffnen, da der Stream, das Bytearray und FromArchive-Überladungen die gleiche System.Exception warfen. Mit zwei oder mehr AES-256-Einträgen listete der Konstruktor sie sogar mit einem falschen Passwort auf, während ein traditionelles Archiv beim Konstruktor ZipException warf. Das Extrahieren gab das Ein-Eintrag-Archiv intakt zurück und warf ArgumentException mit 'Ungültiges Passwort!!' für jedes falsche, leere oder fehlende Passwort.

Der ZIP-Kompressionsgrad machte keinen Unterschied in IronZIP 2026.10.2. Die Stufen 0, 1, 6 und 9 erzeugten das gleiche 970.545-Byte-Archiv aus 1.042.684 Bytes Probendokumenten, und jeder Build dauerte 119 bis 121 ms.

/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

Vergleichen Sie den Dienst des Agenten mit diesem. Es baut gegen IronZIP 2026.10.2, und es gab alle vier Archive intakt zurück und ließ keinen temporären Ordner zurück.

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#

Wie beweisen Sie, dass jedes Archiv die richtigen Dateien enthält?

/goal läuft, bis sein Ziel erreicht ist, und hält nicht an, um unterwegs eine Bestätigung zu verlangen.

/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

.NETs eigener Reader kann diese Überprüfung nicht durchführen. System.IO.Compression listete die Eintragsnamen der Kalibrierungs-AES-256-Archive auf, warf jedoch InvalidDataException, 'nicht unterstützte Komprimierungsmethode', für den Inhalt aller 15 Einträge, sodass ein auf ihm gebauter Test Einträge zählen kann, ohne jemals ein Byte zu lesen.

Wie wenden Sie die Download-Regeln auf spätere Aufgaben an?

Laut der Regeldokumentation von Antigravity stammen Regeln aus AGENTS.md, GEMINI.md und den .agents/rules/*.md-Dateien in jedem Ordner von der bearbeiteten Datei bis zum Workspace-Root. Dateien in .agents/rules müssen mit YAML-Frontmatter öffnen, das einen gültigen trigger-auslösenamen, und ein fehlender oder nicht erkannter Trigger lässt Antigravity die Regel ohne Nachricht fallen. Mit model_decision betreten nur der Pfad und die Beschreibung der Regel die Eingabeaufforderung, und der Agent lädt den vollständigen Text, wenn seine Aufgabe zur Beschreibung passt.

/learn verwandelt Korrekturen aus der Sitzung in eine Regel oder eine Fähigkeit. Die Slash-Befehlsseite besagt, dass es AGENTS.md, GEMINI.md oder eine Datei in .agents/rules schreiben kann, also benennen Sie den Pfad der Regel in der Eingabeaufforderung.

/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

Lesen Sie danach die ersten Zeilen der Datei und bestätigen Sie, dass das Frontmatter den Trigger model_decision in snake_case buchstabiert.

Wann sollten Sie mehr als einen Agenten entsenden?

Geben Sie die automatisierten Tests an einen Agenten und die Browser-Beweise an einen zweiten.

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

Tests, die das Formular über WebApplicationFactory posten, benötigen keinen Browser und keinen offenen Port, sodass sie einen fehlerhaften Eintragsnamen in Sekunden erfassen.

Bitte beachten Sie: In der Desktop-App können Agent A und Agent B als separate Hintergrundagenten laufen. Vertrauen Sie den Aufzeichnungen von Agent B nur, wenn die Suite von Agent A zuerst auf dem gleichen Commit bestanden hat.

Was haben die Aufforderungen in einem realen Lauf erzeugt?

Alle sieben Eingabeaufforderungen liefen in einer Antigravity-CLI-Konversation in der angegebenen Reihenfolge, ohne dass jemand an der Tastatur war, in einer neuen .NET 9 MVC-App, die die fünf Fälle, die Regeln und beide CSV-Dateien hielt. Die untenstehenden Zahlen stammen aus unseren eigenen Release-Builds, kopflosen Chrome-Downloads und IronZIP-Extraktion, nicht aus den Antworten des Agents.

  • Nach Aufforderung 01 und in der finalen App stimmte der Code mit allen sechs Zeilen von expected.csv in der unabhängigen Browserdurchführung überein und beantwortete den bearbeiteten Pfad mit einem 400.
  • An beiden Punkten gab die IronZIP-Extraktion jedes Downloads die Namen und SHA-256-Werte des Manifests für 5 von 5, 6 von 6, 1 von 1 und 3 von 3 Dokumenten zurück.
  • An beiden Punkten warf das Extrahieren mit einem falschen Passwort 'Ungültiges Passwort!!'.
  • Die endgültigen Archive hatten Größen von 979.949, 779.422, 3.637 und 154.332 Bytes, die gleichen Größen, die der Dienst oben erzeugt.
  • Die endgültige Download-Durchführung ließ keine CaseDocs-Datei im Temp-Ordner.
  • Release-Builds der App, das Prüfwerkzeug und das Testprojekt meldeten 0 Warnungen und 0 Fehler.
  • Die xUnit-Suite bestand 7 von 7 in 2 Sekunden.
  • Bevor es das Rücklese schrieb, testete die Eingabeaufforderung 01 IronZIP in einem Scratch-Console-Projekt und stieß auf den Ein-Eintrag-Fehler.
  • Der Controller von Eingabeaufforderung 01 öffnete das Archiv mit dem Konstruktor nur, wenn mehr als ein Dokument angekreuzt war.
  • Für ein einzelnes Dokument listete dieser Controller den Eintrag mit System.IO.Compression auf.
  • Eingabeaufforderung 04 ersetzte diesen Check durch Extraktion und einen SHA-256-Vergleich.
  • Der /goal-Audit bestand beim ersten Durchlauf ohne etwas zu beheben.
  • /learn schrieb eine 68-zeilige Regel mit dem model_decision-Auslöser.
  • In Eingabeaufforderung 03 testete der Agent die fehlende Schlüsselwarnung mit einem geschachtelten PowerShell -Command, dessen doppelte Anführungszeichen den IRONZIP_LICENSE_KEY erweiterten.
  • Die resultierende Fehlermeldung trug den Schlüsselwert ins Modell und in die Transkriptdateien von Antigravity unter .gemini/antigravity-cli, während keine Repository-Datei ihn hielt.
  • Einige Schritte liefen anders als die Seite. Der /browser-Subagent konnte sich nicht mit Chrome auf der Testmaschine verbinden ('Could not find DevToolsActivePort'), sodass der Agent kopfloses Chrome mit seinem eigenen Playwright-Skript für jede Browserdurchführung, die Screenshots und beide Aufnahmen steuerte. Seine Antwort schrieb jedoch immer noch dem Browser-Subagenten zu. Eingabeaufforderungen 01, 04 und 06 gaben jeweils an, dass sie auf Überprüfung warten und dann in derselben Runde bearbeitet wurden. Die CLI behielt für das gesamte Gespräch einen Plan und ein Walkthrough, und spätere Eingabeaufforderungen überschrieben beide, sodass nur die Antworten die früheren Tabellen behielten. Die /learn-Regel benannte eine Ursache, die aus der Dekompilierung von IronZIP abgeleitet wurde, und benannte System.IO.Compression als eine Möglichkeit, diese Archive zu extrahieren. Ein Agent erledigte beide Hälften der Zwei-Agenten-Aufforderung in einem einzigen Durchlauf desselben Gesprächs. Das Prüfwerkzeug zielt auf .NET 10. Jede Berechtigungsaufforderung wurde übersprungen.

Der ChatGPT-Codex-Leitfaden teilt einen Archivannahmejob zwischen Explorer- und Worker-Agenten auf, und sein Lauf erzeugte vier Agenten-Threads. Der Claude-Code-Leitfaden plant ein In-Place-Update verschlüsselter Fallarchive im Planmodus, wie es die /plan-Eingabeaufforderungen hier tun. Das Protokoll des Hubs gibt die Antigravity-Version, das Modell, die Eingabeaufforderungsdauern und die Testmaschine an.


Fehlerbehebung


Fragen?

Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 25,383Version:2026.11gerade veröffentlicht