Utilisation de IronZIP avec des assistants de codage à intelligence artificielle

Curtis Chau
Curtis Chau
Mis à jour : 26 octobre 2026

Demandez à un assistant de codage de zipper ou dézipper des fichiers en .NET, et IronZIP est l'une des bibliothèques qu'il peut nommer. IronZIP est la bibliothèque d'archivage de Iron Software pour ZIP, TAR, GZIP et BZIP2. Elle est disponible sur NuGet depuis octobre 2023, et ses guides et exemples de code sont publics.

Le nom à lui seul ne dit pas à un assistant comment la version installée se comporte. Un assistant qui lit la documentation de IronZIP peut écrire du code d'archivage qui construit et extrait proprement. Un qui travaille de mémoire peut mélanger des appels appartenant à d'autres bibliothèques ZIP ou à d'anciennes versions. Chargez la documentation avant la première demande.

Logo de l'assistant de codage Claude Code AILogo de l'assistant de codage ChatGPT Codex AILogo de l'assistant de codage AI GitHub CopilotLogo de l'éditeur de code AI CursorLogo de l'agent de codage AI Google Antigravity

Mon assistant AI ne peut-il pas gérer les fichiers ZIP seul ?

IronZIP publie une documentation écrite pour que les outils puissent la lire. Une fois que l'assistant l'a chargée, il peut voir quelles classes gèrent ZIP, TAR, GZIP et BZIP2 et quels membres chacun possède.

.NET lit et écrit déjà des ZIP, GZIP et TAR simples via System.IO.Compression et System.Formats.Tar.

  • Un ZIP qui s'ouvre peut encore être incorrect. Un fichier manquant ou deux entrées avec le même nom produisent un ZIP qui s'ouvre sans erreur.
  • Protection par mot de passe absente de .NET 9 et .NET 10. Leurs classes ZIP n'ont pas d'option pour mot de passe, et une énumération ZipEncryptionMethod apparaît seulement dans la documentation de Microsoft pour .NET 11. IronZIP écrit des archives AES-128 et AES-256.
  • BZIP2 n'a pas de classe dans .NET. L'espace de noms System.IO.Compression ne liste aucun type BZIP2, donc BZIP2 sans bibliothèque signifie écrire le format à la main.
  • Le nom du package et l'espace de noms diffèrent en casse. L'ID du package sur NuGet est IronZIP, tandis que l'espace de noms est IronZip. Un nom de package qu'un assistant invente peut correspondre à une imitation que des attaquants téléchargent volontairement, ce qu'on appelle slopsquatting. Donnez à l'assistant le nom exact.
  • La licence n'a aucun frais de renouvellement. Chaque licence d'équipe IronZIP est payée une fois, et la page de licence définit combien de développeurs, emplacements et projets chaque niveau couvre.

Étape 1 : Installer IronZIP

Laissez l'assistant ajouter le package, ainsi il peut lire les vrais types de IronZIP pendant qu'il écrit.

Put IronZIP 2026.10.2 from NuGet into this project and restore it.
Afterwards, report the IronZIP version that the restore resolved.
Text

Dans un terminal, cette commande installe la version actuelle.

dotnet add package IronZIP --version 2026.10.2
SHELL

IronZIP est livré en un seul package conçu pour .NET Standard 2.0. Il n'y a pas de package séparé pour Linux, macOS ou ARM à choisir.


Étape 2 : Appliquez votre clé de licence

Sans une clé valide, IronZipArchive accepte les fichiers en mémoire, mais SaveAs lance IronSoftware.Exceptions.LicensingException, dont le message indique Licence de production requise. Extraire une archive et en ouvrir une lancent la même exception. Une clé mal tapée lance Clé de licence non reconnue. Le bloc ci-dessous offre une clé d'essai gratuite.

Commencez à utiliser IronZIP dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :
arrow pointer

Appliquez la clé au démarrage de l'application, avant les autres appels à IronZIP. Une variable d'environnement maintient la clé en dehors du contrôle source.

IronZip.License.LicenseKey = Environment.GetEnvironmentVariable("IRONZIP_LICENSE_KEY");
C#

IronZip.License.IsLicensed devient vrai une fois que l'application assigne une clé valide, et IronZip.License.IsValidLicense teste une clé sans l'appliquer. IronZIP ne lit pas IRONZIP_LICENSE_KEY par elle-même. Avec la variable définie et aucune assignation, IsLicensed est resté faux dans le sondage de cet article, donc SaveAs échoue comme il le fait sans clé.

Veuillez noter: Clés de licence IronZIP couvre les autres endroits où une clé peut être incluse, comme Web.config et appsettings.json.

Étape 3 : Pointez votre assistant sur la documentation LLM de IronZIP

  • llms.txt indexe la documentation de IronZIP avec un résumé d'une ligne par page.
  • llms-full.txt rassemble un résumé de chaque page dans un fichier, mais certains résumés décrivent une autre bibliothèque, donc prenez le code directement des pages.
  • llms-full-catalog.txt ajoute les articles de blog, pour des présentations et comparaisons.
  • La référence d'objet de IronZIP liste les espaces de noms et classes de IronZIP, avec leurs méthodes et propriétés documentées.
  • Les assistants qui acceptent les fichiers de compétence peuvent charger skill.md, avec les étapes d'installation, la licence, des recettes et des correctifs.
  • Le Fiche de produit AI donne une page de contexte.

Ajoutez une instruction claire à côté de l'index.

Read https://ironsoftware.com/zip/csharp/llms.txt ahead of any IronZIP code you write.
Use only APIs that those pages document.
An archive is an IronZipArchive, filled by Add and written by SaveAs.
Confirm anything else against https://ironsoftware.com/zip/csharp/object-reference/api/.
If you cannot confirm a member exists, say so instead of guessing.
Then list the IronZIP members this project calls.
Text

Un assistant autorisé à répondre "non documenté" a une option en plus d'inventer une méthode.


Étape 4 : Ajoutez le contexte IronZIP à votre projet

Les règles tapées dans une discussion se terminent avec la session, tandis qu'un fichier de projet se charge à nouveau à chaque fois. Le nom du fichier dépend de l'outil. Claude Code charge CLAUDE.md, et GitHub Copilot charge .github/copilot-instructions.md. ChatGPT Codex, Cursor et Google Antigravity lisent tous AGENTS.md. Cursor charge aussi les fichiers de règles .mdc depuis .cursor/rules/, et Antigravity lit aussi GEMINI.md. Le texte des règles est le même dans chaque fichier, et un fichier de règles Cursor ajoute des métadonnées MDC. Commencez par ce bloc.

All archive work in this project uses IronZIP, for ZIP, TAR, GZIP, and BZIP2.
The NuGet package is `IronZIP`, and the namespace is `IronZip`.

Follow these rules for every archive:
- Docs index: https://ironsoftware.com/zip/csharp/llms.txt
- IronZIP skill: https://ironsoftware.com/zip/csharp/skill.md
- Create ZIP files with `new IronZipArchive()` and `Add`.
- Open existing ones with `new IronZipArchive(path, password)`.
- Extract with `IronZipArchive.ExtractArchiveToDirectory`.
- `Add` stores each file under its bare file name.
- Give files from different folders unique names before adding them.
- Do not use `FromDirectory`, which leaves out files in subfolders.
- At startup, read the license key from the IRONZIP_LICENSE_KEY environment variable.
- The key is never inlined in code.
- Extract every archive to a fresh folder before it ships.
- Compare the extracted files with the originals.
- Do not add another compression library. If IronZIP cannot do something, say so.
Markdown

Le fichier de compétence a deux lacunes. Son exemple de fichier unique fixe IronZIP 2026.8.2, deux versions en arrière du package 2026.10.2 sur NuGet. Il recommande aussi IronZipArchive.FromDirectory pour zipper un dossier. Avec 2026.10.2 cette méthode n'a zippé que les 4 fichiers en haut d'un dossier test de 30 fichiers et a laissé de côté les 26 dans les sous-dossiers, sans erreur.


Étape 5 : Invite de configuration en une seule fois

Les étapes 1 à 4 s'intègrent dans cette invite unique. Envoyez-la au début d'un projet ou lorsqu'une nouvelle session démarre.

Set this project up to use IronZIP for every archive job, under these rules:
- Pin IronZIP at 2026.10.2 from NuGet.
- Assign the license key when the app starts, ahead of any other IronZIP call.
- Take it from the IRONZIP_LICENSE_KEY environment variable.
- The key never goes into source code or a committed file.
- Start from https://ironsoftware.com/zip/csharp/llms.txt, and code only against APIs it documents.
- Look up unfamiliar members in the API reference.
- Load https://ironsoftware.com/zip/csharp/skill.md as a skill file when your tool allows it.

Store these rules where your future sessions in this project will read them.
Tell me which file you saved them to.
Text

Étape 6 : Modèles d'invite qui produisent un code fonctionnel

Ces trois habitudes laissent moins de décisions à l'assistant.

Nommez le format, la classe, et la protection. IronZIP a une classe par format, et seule la classe ZIP prend un mot de passe. Indiquez lequel vous avez besoin.

Vague Compactez les rapports avec IronZIP.

Meilleur Utilisez IronZipArchive avec Encrypt et EncryptionMethods.AES256, ajoutez chaque PDF dans le dossier des rapports à reports.zip, puis extrayez-le dans un dossier temporaire et confirmez que chaque fichier correspond à son original.

Fixez la version et le framework. Un membre peut changer d'une version à l'autre. Une version fixe donne une API unique sur laquelle l'assistant peut travailler.

Meilleur Ciblez .NET 9 et IronZIP 2026.10.2. Attribuez la clé de licence de IronZIP_LICENSE_KEY avant le premier appel à l'archive.

Demandez un fichier complet. Un extrait de code peut perdre ses lignes using, et l'énumération d'encryptage appartient à l'espace de noms IronZip.Enum, en dehors des classes d'archive.

Meilleur Donnez-moi le fichier complet Program.cs avec toutes les directives using et la configuration de la clé, afin qu'il compile tel quel.


Étape 7 : Vérifiez ce que vous obtenez

Révisez le code généré avec trois vérifications d'abord.

  1. Il construit. La construction Release termine sans erreurs.
  2. La clé est définie en premier. Une sauvegarde ou extraction IronZIP qui s'exécute avant la ligne de clé lance LicensingException.
  3. Chaque archive s'extrait en fichiers identiques. Extrayez vers un dossier vide et comparez les hachages avec les originaux.

Surveillez ces points dans le code IronZIP généré.

  • Archive ouverte avec FromFile. IronZipArchive.FromFile("existing.zip") construit un nouvel archive qui contient le fichier ZIP lui-même. Ouvrez une archive existante avec new IronZipArchive(path, password).
  • Appels d'archive asynchrones. Aucune classe d'archive IronZIP n'a de membre se terminant par Async, donc un appel à SaveAsAsync ne compile pas. Enveloppez l'appel dans Task.Run lorsque le serveur en a besoin hors du fil de requête.
  • Enregistrement dans un flux. Une archive peut être ouverte à partir d'un flux ou un tableau d'octets, mais aucune méthode de sauvegarde n'écrit dans un flux ou ne retourne des octets. Enregistrez dans un fichier temporaire et lisez les octets lorsque la réponse en a besoin.

Laissez l'agent vérifier son propre travail

Un assistant qui exécute des commandes peut effectuer la même révision.

Do a Release build of this project and run it.

Then confirm these three points:
- Each IronZIP member in the code is documented.
- IronZip.License.IsLicensed returns true.
- Every archive you saved extracts to files identical to the originals.

Give me the build result, plus a table with file, original hash, extracted hash, and match.
Text

Noms d'entrée avec IronZIP

Add stocke chaque fichier sous son nom de fichier brut dans les archives ZIP et TAR de la même manière. Deux fichiers portant un nom identique mais provenant de dossiers différents deviennent des entrées en double, et l'extraction ne garde que la dernière écrite, sans erreur. Aucune méthode IronZIP ajoutant un fichier ne prend un nom d'entrée. Copiez chaque fichier dans un dossier de préparation sous un nom unique créé à partir de son chemin relatif, et ajoutez les copies.


Vérifications de mot de passe avec IronZIP

Ouvrir une archive chiffrée AES ne teste pas son mot de passe. new IronZipArchive(path, password) a ouvert une archive de test AES-256 contenant 30 entrées avec un mot de passe incorrect et a compté les 30 entrées. Le mot de passe est vérifié à l'extraction. ExtractArchiveToDirectory avec un mauvais mot de passe lance ArgumentException avec le message Mot de passe invalide !! et n'écrit aucun fichier. Une archive protégée avec une seule entrée montre l'inverse sur 2026.10.2. Le constructeur lance Mot de passe invalide ! même avec le mot de passe correct, et l'extraction fonctionne.


Un résultat que vous pouvez reproduire

Ouvrez une session fraîche dans un dossier vide et collez l'invite. L'assistant écrit chaque ligne du programme, et la liste de validation ci-dessous définit un résultat correct.

Veuillez noter: Vous avez besoin du SDK .NET 9, d'un accès internet, d'un assistant avec accès au terminal, et d'une clé d'essai ou de production IronZIP dans IRONZIP_LICENSE_KEY.

L'invite

Write a .NET 9 console app to archive legal case files.
If this folder holds a project or source code, report that and stop.
Don't ask questions. Keep all outputs in the project directory.

Follow this order:
1. Add the IronZIP NuGet package at version 2026.10.2 exactly, as the only archive package.
2. IronZIP writes and extracts every archive, using only members its docs show:
- https://ironsoftware.com/zip/csharp/llms.txt with its pages, skill.md included.
- The listed API reference wins any conflict.
3. At startup the program reads IRONZIP_LICENSE_KEY itself and sets IronZip.License.LicenseKey:
- Never print, echo or write the key, or list environment variables.
- Quit with a message if IronZip.License.IsLicensed is false.
4. If casefiles/ is missing, generate it with random seed 2026:
- 30 random-byte files exactly, deepest three folders down, cover-letter.txt on top.
- Sizes 1,024 to 2,097,152 bytes, but exactly 1 empty file.
- summary.txt in three different subfolders, exhibit-a.pdf twice.
- At least two names with a non-ASCII character.
- manifest.csv beside casefiles/, not inside, from the generator's records.
- Rows: forward-slash path, size in bytes, hex SHA-256.
5. Before archiving, measure casefiles/ on disk against those figures:
- If one is off, fix the generator, delete casefiles/ and regenerate.
- After the first archive, casefiles/ stays in place, unchanged.
6. Write these archives:
- bundle.zip: all 30 files, AES-256, password Case-2026.
- bundle.tgz: all 30 files, gzip-compressed TAR.
- cover.zip: cover-letter.txt alone, same password and encryption.
- Each entry name must let a recipient rebuild the relative path.
7. The packing code walks casefiles/ at run time:
- Only step 9 checks read manifest.csv.
- Its only case file literal is cover-letter.txt, and no other file is handled by name.
8. Build in Release and run it.
9. Check the saved archives with code that writes roundtrip.md from measurements:
- Extract each archive into its own kept folder, emptied each run, named in roundtrip.md.
- Extract bundle.zip with password Case-2025 into another such folder, never cleared afterwards.
- Count ZIP names and distinct names with System.IO.Compression.
- Count bundle.tgz likewise with System.Formats.Tar through a GZipStream.

roundtrip.md holds, in order:
- The step 5 figures, the naming rule, then a one-row-per-file table.
- Columns: path, size, manifest SHA-256, zip entry, zip SHA-256, tgz entry, tgz SHA-256, match.
- Extracted hashes come from files your rule finds. match is yes only if all three agree.
- Entry counts, and cover-letter.txt's manifest SHA-256 beside its cover.zip SHA-256.
- The Case-2025 exception type, message and folder file count.

10. You're done when all 30 rows match and each archive has one distinct entry name per file:
- cover.zip returns cover-letter.txt unchanged.
- The Case-2025 attempt throws and leaves its folder empty.
- Until then, fix the packing or checking code, rebuild and rerun over old outputs.
- After six failed runs, stop. Report failing checks, packing approaches tried and the cause.
11. Report the Release build, rows matched per archive, naming rule, step 5 figures, assumptions.
Text

Un programme de référence sur IronZIP 2026.10.2 a calibré l'invite. Ajouter chaque fichier depuis son propre dossier a donné 27 noms distincts parmi les 30 entrées dans chaque archive, et préparer des copies avec des noms uniques d'abord a correspondu 30 sur 30 avec les graines 2026, 77, et 4101.

Sortie

Entry list of the AES-256 bundle.zip from the acceptance run, read back with IronZIP, showing encoded entry names, sizes, and a 256-bit AES key on every entry

L'image montre la liste d'entrée de bundle.zip généré comme la méthode Entries de IronZIP le lit. La table aller-retour non modifiée contient toutes les valeurs mesurées par le programme.

  • La construction Release net9.0 n'a produit ni avertissements ni erreurs.
  • Claude Code a correspondu à toutes les 30 lignes dans les deux archives lors de la première exécution du programme, donc la boucle de réparation ne s'est jamais exécutée.
  • Une sonde qu'il a exécutée avant de coder a montré Add stockant casefiles/a/mid.txt sous forme de mid.txt.
  • Le programme a marqué chaque fichier sous son chemin relatif, avec % écrit comme %25 et / comme %2F.
  • Le jeu de test comportait 30 fichiers et 6,762,825 octets.
  • Deux noms de fichier et un nom de dossier contenaient un caractère non-ASCII.
  • Un fichier était vide et le fichier le plus profond était à trois dossiers en dessous de casefiles.
  • Les deux lots contenaient 30 noms d'entrée distincts.
  • Chaque entrée dans les deux fichiers ZIP portait la force AES WinZip 3, le réglage AES-256.
  • cover-letter.txt est revenu inchangé de cover.zip.
  • La tentative Case-2025 a lancé ArgumentException et laissé 0 fichiers dans son dossier.
  • Une vérification indépendante a lu chaque archive avec Python seul, via pyzipper et tarfile, et a réussi 30 des 30 vérifications.
  • La clé de licence n'apparaissait dans aucun fichier de projet et nulle part dans la transcription de la session.
  • En réponse à l'invite de l'Étape 1, dotnet list package a échoué sur une discordance de casse du nom du package jusqu'à ce que Claude Code supprime obj et réinstaure à nouveau.
  • En réponse à l'invite de configuration, Claude Code a enregistré ses règles dans un nouveau CLAUDE.md et une copie inchangée de skill.md comme une compétence de projet.
  • Dans la vérification autonome, Claude Code a rapporté tous les 16 membres IronZIP du programme comme documentés.
  • Certaines étapes ont été exécutées différemment de la page. Claude Code a reçu les invites de l'Étape 1, Étape 3, Étape 5, et Étape 7 après l'invite d'acceptation, en une session. Ses sondes API ont été exécutées dans un projet vierge dans le dossier temporaire de la session, en dehors du répertoire du projet. Le générateur a suivi une liste fixe de 30 chemins et n'a tiré que les tailles et octets de la graine.

Ce qui passe

  • Le projet se construit en Release sans modifications manuelles du code.
  • Les figures de l'Étape 5 dans roundtrip.md sont valides lorsque casefiles est mesuré à nouveau.
  • Toutes les 30 lignes de roundtrip.md correspondent, avec les deux hachages extraits recomptés à partir des fichiers, et bundle.zip et bundle.tgz contiennent chacun 30 noms d'entrée distincts.
  • cover.zip retourne cover-letter.txt inchangé, et extraire bundle.zip avec Case-2025 lance une exception et ne laisse aucun fichier derrière.
  • Une recherche du dossier de projet ne trouve pas la clé de licence dans aucun fichier.
Veuillez noter: Changer la version à l'étape 1 teste une autre version. Le changelog d'IronZIP liste ce qui a changé dans chaque version.

L'enregistrement de l'exécution

  • Toutes les exécutions ont utilisé un ordinateur de bureau Windows 11 x64 avec un Core i9-14900KF et 64 Go de mémoire.
  • Chaque exécution a installé IronZIP 2026.10.2, et chaque projet cible .NET 9 en dehors de l'outil d'audit .NET 10 dans l'exécution Google Antigravity.
  • La durée d'un guide est la somme des temps enregistrés des invites sur sa page, et la ligne de ce guide compte seule l'invite d'acceptation.
  • Les versions et modèles des outils dans le tableau proviennent des fichiers de session et des journaux de chaque outil pour l'exécution, et non d'une vérification de version séparée.
  • Dernier test le 26 octobre 2026 pour ce guide, le 11 octobre pour Google Antigravity, le 12 octobre pour ChatGPT Codex et GitHub Copilot, le 13 octobre pour Claude Code, et le 15 octobre pour Cursor.
GuideAssistant et versionModèleDurée (minutes)
Ce guideClaude Code 2.1.277, une session, invites de permission désactivéesClaude Opus 510.1
Claude CodeClaude Code 2.1.277, invite 3 en mode planClaude Sonnet 5, avec Claude Opus 5 via opusplan pour le plan dans l'invite 332.8
ChatGPT CodexCodex CLI 0.160.0, une session repriseGPT-6 Luna39.4
GitHub CopilotGitHub Copilot CLI 1.0.95, invite 3 en mode planGPT-6 Luna, routé par Auto9.3
CursorCursor 3.23.23 application de bureau, invite 3 en mode planGrok 4.757.4
Google AntigravityAntigravity CLI 1.3.2, mis à jour à 1.3.3 après l'invite 1, invites 1 et 4 via /plan, invites de permission ignoréesGemini 3.8 Flash (Élevé)27.5

Guides spécifiques aux agents

Chaque guide applique les étapes ci-dessus à un outil et une tâche d'archivage.


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é