Comment utiliser IronZIP avec Google Antigravity

Curtis Chau
Curtis Chau
Mis à jour : 26 octobre 2026

Une page qui fournit aux clients leurs documents de dossier sous forme de fichier ZIP protégé par mot de passe peut se compiler proprement tout en envoyant une archive avec des fichiers manquants, une page d'erreur pour un cas ordinaire ou un document d'un autre cas.

La commande /browser de Google Antigravity démarre un sous-agent du navigateur Chrome qui peut piloter la page en cours, de sorte qu'une seule invite peut taper un mot de passe, appuyer sur Télécharger pour chaque test et garder une capture d'écran de chaque résultat. IronZIP construit l'archive sur le serveur avec un cryptage AES-256 et l'extrait à nouveau, de sorte que la page peut prouver que chaque document est revenu octet par octet. Ce guide construit cette page de téléchargement dans une application ASP.NET Core MVC, en partant de l'exemple de protection par mot de passe d'IronZIP, et la vérifie par rapport à cinq cas dont les documents et les hachages SHA-256 sont connus à l'avance.

Démarrage rapide
NuGetInstaller avec NuGet

PM > Install-Package IronZip

Installez IronZIP en exécutant la commande ci-dessus dans la console du gestionnaire de packages NuGet, ou recherchez le package dans le gestionnaire de packages NuGet.

Ouvrez le dossier CaseDocs dans Antigravity et décrivez la page de téléchargement.

/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

Lisez ces trois réponses avant que le code ne change. Chacune couvre une manière dont l'archive peut échouer sans erreur de compilation. Dans agy -p sans interface, personne n'approuve le plan, alors lisez l'artefact du plan à côté du code qu'il décrit.

Nommez la variable dans l'invite et ne collez jamais la valeur. Tout ce qui est tapé dans la conversation peut atteindre un fichier source, un commit ou une transcription de terminal. IronZIP accepte également une entrée IronZip.LicenseKey dans appsettings.json, et un commit inclut ce fichier avec tout le reste. Chaque emplacement pris en charge se trouve dans le guide de clé de licence.



Que devez-vous revoir avant d'accepter les modifications ?

Vérifiez d'où vient chaque nom d'entrée, le dossier dans lequel chaque archive est enregistrée, la ligne qui la supprime, et le code qui relit l'archive. Ensuite, confirmez chaque membre d'IronZIP dans le diff par rapport à la référence API.

Antigravity enregistre les captures d'écran en tant qu'artefacts d'image qui acceptent les commentaires. Lorsqu'une montre une page d'erreur ou un nombre de documents erroné, commentez cette capture d'écran plutôt que d'écrire une nouvelle invite à son sujet.

Comment testez-vous chaque téléchargement dans un vrai navigateur ?

Demandez un tableau de résultats que seuls les téléchargements réels peuvent remplir.

/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

Une correction des noms d'entrées modifie chaque archive, même pour les cas déjà réussis, c'est pourquoi l'invite relance les six lignes.

Veuillez noter: Ouvrez d'abord la capture d'écran pour le cas d'un document. Une page qui passe les autres cas peut encore afficher une page d'erreur à cet endroit.

Qu'est-ce qui cause des téléchargements incomplets ou défectueux ?

Lors de notre calibration, le code de l'exemple de protection par mot de passe a été déplacé dans une action de téléchargement. Il est passé à AES-256 et a compté les entrées de l'archive enregistrée en l'ouvrant avec le constructeur. Chrome sans interface a alors appuyé sur Télécharger pour chaque cas avec IronZIP 2026.10.2. Chaque échec ci-dessous s'est compilé sans avertissement.

Ce qui est arrivéCauseCe qu'il faut demander
Le cas à six documents a été téléchargé, mais son extraction a donné 3 fichiersIronZIP nomme chaque entrée d'après le fichier seul, donc deux fichiers lettre.pdf, deux fichiers scan.jpg et deux fichiers résumé.pdf partageaient des nomsLes noms d'entrée étaient construits à partir du chemin relatif, avec des copies enregistrées sous ces noms
Le cas à un seul document a renvoyé une page d'erreurLa lecture effectuée par le constructeur a renvoyé "Mot de passe invalide !" avec le bon mot de passeUne lecture qui extrait l'archive
Le cas vide a renvoyé une page d'erreurLa sauvegarde d'une archive sans entrées a lancé "L'archive existante est cassée !"Un contrôle de sélection avant qu'IronZIP ne s'exécute
Une valeur de case à cocher éditée en ../C-1001/relevé.csv a mis le fichier d'un autre cas dans le téléchargementL'action faisait confiance aux chemins postésChaque chemin posté s'est résolu et est resté à l'intérieur du dossier du cas
Quatre fichiers ZIP sont restés dans le dossier temporaireIronZIP n'enregistre que vers un chemin, et rien ne supprimait le fichierUn dossier par requête, supprimé à la fin de la requête

Le contrôle du nombre d'entrées est passé pour le cas à six documents, car l'archive contenait six entrées.

Comment configurez-vous un projet dans lequel Antigravity peut travailler?

L'agent a besoin d'une application qui se construit et répond déjà sur localhost. dotnet new mvc --framework net9.0 vous en donne une, et l'exécution une fois montre le port dans Properties/launchSettings.json. Le port diffère d'un projet à l'autre, et les invites /browser doivent le nommer. La liste blanche du navigateur ne contient d'abord que localhost, donc gardez l'adresse sous la forme http://localhost:<port>.

Validez les dossiers de cas sous CaseFiles, les règles dans docs/case-download-rules.md, TestData/expected.csv avec le résultat pour chaque cas et mot de passe, et TestData/manifest.csv avec le nom d'entrée, la taille et le SHA-256 de chaque document. Les cinq cas test comportaient cinq documents simples, six documents avec trois noms répétés dans les sous-dossiers, un seul relevé, trois documents avec des noms accentués et japonais, et aucun document. Ensuite, demandez à l'agent d'auditer le paquet et la clé.

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

Répétez ce numéro de version chaque fois qu'une invite ultérieure ajoute un projet ou un package, afin que chaque projet se construise contre la même version d'IronZIP. Un agent qui écrit un nom de package de mémoire peut installer un paquet malveillant publié sous un nom imaginé, une attaque appelée slopsquatting. Le paquet est IronZIP et le namespace est IronZip.

Avec la variable définie et License.LicenseKey jamais assigné, la page de calibration a échoué à l'appel enregistrer pour les quatre cas d'archive. Chacune a généré une LicensingException lisant "Licence de production requise". IronZIP ne lit pas IRONZIP_LICENSE_KEY seul, donc l'application doit assigner IronZip.License.LicenseKey elle-même. Pour les fichiers de documentation d'agent d'IronZIP et un test d'acceptation à une seule invite, voir le guide des assistants de codage AI.

Comment le service doit-il transmettre les documents à IronZIP ?

Les commandes Add, AddArchiveEntry et FromFiles ont toutes laissé tomber le dossier lors d'une vérification, même à partir d'un chemin relatif tel que 2025/lettre.pdf, et l'extraction a conservé la dernière des deux entrées portant le même nom. Ajouter un chemin de dossier a généré UnauthorizedAccessException. Le service copie donc chaque document dans un dossier temporaire sous le nom que les règles lui attribuent et ajoute les copies.

L'échec du constructeur couvre toutes les manières d'ouvrir une archive AES-256 à une seule entrée, car les surcharges de flux, de tableau d'octets et FromArchive ont généré la même System.Exception. Avec deux entrées AES-256 ou plus, le constructeur les a listées même avec un mot de passe incorrect, tandis qu'une archive traditionnelle a lancé ZipException au constructeur. L'extraction a renvoyé l'archive à une seule entrée intacte et a lancé ArgumentException avec "Mot de passe invalide !!" pour chaque mot de passe incorrect, vide ou manquant.

Le niveau de compression ZIP n'a fait aucune différence dans IronZIP 2026.10.2. Les niveaux 0, 1, 6 et 9 ont produit la même archive de 970 545 octets à partir de 1 042 684 octets de documents de vérification, et chaque construction a pris de 119 à 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

Comparez le service de l'agent avec celui-ci. Il se construit contre IronZIP 2026.10.2, et il a renvoyé les quatre archives intactes et n'a laissé aucun dossier temporaire.

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#

Comment prouvez-vous que chaque archive contient les bons fichiers ?

/goal fonctionne jusqu'à ce que son objectif soit atteint et ne s'arrête pas pour demander une confirmation en cours de route.

/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

Le lecteur propre de .NET ne peut pas faire cette vérification. System.IO.Compression a listé les noms d'entrée des archives de calibration AES-256 mais a lancé InvalidDataException, "méthode de compression non prise en charge", pour le contenu de toutes les 15 entrées, de sorte qu'un test basé sur lui peut compter les entrées sans jamais lire un octet.

Comment appliquez-vous les règles de téléchargement aux tâches ultérieures ?

Selon la documentation des règles d'Antigravity, les règles proviennent de AGENTS.md, GEMINI.md et les fichiers .agents/rules/*.md dans chaque dossier du fichier modifié jusqu'à la racine de l'espace de travail. Les fichiers dans .agents/rules doivent s'ouvrir avec un frontmatter YAML nommant un trigger valide, et un déclencheur manquant ou non reconnu fait qu'Antigravity supprime la règle sans message. Avec model_decision, seul le chemin et la description de la règle entrent dans l'invite, et l'agent charge le texte complet lorsque sa tâche correspond à la description.

/learn transforme les corrections de la session en une règle ou une compétence. La page des commandes slash indique qu'elle peut écrire AGENTS.md, GEMINI.md ou un fichier dans .agents/rules, donc nommez le chemin de la règle dans l'invite.

/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

Ensuite, lisez les premières lignes du fichier et confirmez que le frontmatter orthographie la déclencheuse model_decision, en snake case.

Quand devriez-vous dépêcher plus d'un agent ?

Confiez les tests automatisés à un agent et les preuves du navigateur à un autre.

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

Les tests qui publient le formulaire par WebApplicationFactory n'ont besoin ni de navigateur ni de port ouvert, de sorte qu'ils détectent un nom d'entrée cassé en quelques secondes.

Veuillez noter: Dans l'application de bureau, l'Agent A et l'Agent B peuvent fonctionner comme agents d'arrière-plan séparés. Faites confiance aux enregistrements de l'Agent B uniquement si l'ensemble de l'Agent A a réussi d'abord sur le même commit.

Qu'est-ce que les messages ont produit lors d'une réelle exécution ?

Toutes les sept invites ont été exécutées dans une seule conversation Antigravity CLI, dans l'ordre, sans personne au clavier, sur une nouvelle application .NET 9 MVC qui contenait les cinq cas, les règles et les deux fichiers CSV. Les chiffres ci-dessous proviennent de nos propres constructions de Release, des téléchargements de Chrome sans interface et de l'extraction IronZIP, et non des réponses de l'agent.

  • Après l'invite 01 et dans l'application finale, le code correspondait à toutes les six lignes expected.csv dans le passage indépendant du navigateur et a répondu au chemin modifié avec un 400.
  • Aux deux points, l'extraction IronZIP de chaque téléchargement a renvoyé les noms et valeurs SHA-256 du manifeste pour 5 sur 5, 6 sur 6, 1 sur 1 et 3 sur 3 documents.
  • Aux deux points, l'extraction avec un mauvais mot de passe a lancé Mot de passe invalide !!.
  • Les archives finales sont venues à 979 949, 779 422, 3 637 et 154 332 octets, les mêmes tailles que le service ci-dessus produit.
  • Le passage final du téléchargement n'a laissé aucun fichier CaseDocs dans le dossier temporaire.
  • Les constructions de Release de l'application, de l'outil d'audit et du projet de test n'ont signalé 0 avertissements et 0 erreurs.
  • La suite xUnit a réussi 7 sur 7 en 2 secondes.
  • Avant d'écrire la relecture, l'invite 01 a testé IronZIP dans un projet de console de brouillon et a frappé l'échec à une entrée.
  • Le contrôleur de l'invite 01 a ouvert l'archive avec le constructeur uniquement lorsque plus d'un document était coché.
  • Pour un seul document, ce contrôleur a listé l'entrée avec System.IO.Compression.
  • L'invite 04 a remplacé ce contrôle par l'extraction et une comparaison SHA-256.
  • L'audit /goal est passé dès son premier exécution sans rien à corriger.
  • /learn a écrit une règle de 68 lignes avec le déclenchement model_decision.
  • Dans l'invite 03, l'agent a testé l'avertissement de clé manquante avec un powershell -Command imbriqué dont les doubles guillemets ont développé IRONZIP_LICENSE_KEY.
  • Le message d'erreur résultant a transporté la valeur de clé au modèle et dans les fichiers de transcription d'Antigravity sous .gemini/antigravity-cli, tandis qu'aucun fichier de dépôt ne la détenait.
  • Certaines étapes ont été exécutées différemment de la page. Le sous-agent /browser n'a pas pu se connecter à Chrome sur la machine de test ("Impossible de trouver DevToolsActivePort"), donc l'agent a piloté Chrome sans interface avec son propre script Playwright pour chaque passage de navigateur, les captures d'écran et les deux enregistrements. Sa réponse a toujours crédité le sous-agent du navigateur. Les invites 01, 04 et 06 ont chacune dit qu'elles attendaient une révision puis ont édité dans le même tour. Le CLI a conservé un seul plan et un seul Walkthrough pour toute la conversation, et les invites ultérieures ont écrasé les deux, alors seules les réponses ont conservé les tableaux précédents. La règle /learn a indiqué une cause tirée du décompilage d'IronZIP et a nommé System.IO.Compression comme un moyen d'extraire ces archives. Un agent a fait les deux moitiés de l'invite à deux agents dans un seul tour de la même conversation. L'outil d'audit cible .NET 10. Chaque invite de permission a été ignorée.

Le guide ChatGPT Codex divise un travail d'entrée d'archive entre les agents explorateur et travailleur, et son exécution a engendré quatre threads d'agent. Le guide Claude Code prévoit une mise à jour en place des archives de cas chiffrées en mode plan, comme le font les invites /plan ici. L'enregistrement d'exécution du hub donne la version Antigravity, le modèle, la durée des invites et la machine de test.


Dépannage


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.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 25,383Version :2026.11tout juste publié