Utilisation de IronZIP avec des assistants de codage à intelligence artificielle
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.
Comment utiliser IronZIP avec un assistant de codage à intelligence artificielle
- Téléchargez la bibliothèque ZIP C# depuis NuGet
- Attribuez
IronZip.License.LicenseKeyà partir deIronZip_LICENSE_KEYau démarrage - Partagez l'index llms.txt de IronZIP avec l'assistant avant que tout code ne soit écrit
- Gardez les règles de IronZIP dans le fichier d'instructions du projet de l'assistant
- Ouvrez une nouvelle session et collez l'invite de configuration en une seule fois
- Construisez, extrayez chaque archive que vous créez, et comparez les fichiers avec les originaux
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 estIronZip. 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.
Dans un terminal, cette commande installe la version actuelle.
dotnet add package IronZIP --version 2026.10.2
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.
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");
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é.
É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.
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.
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.
É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
IronZipArchiveavecEncryptetEncryptionMethods.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.
- Il construit. La construction Release termine sans erreurs.
- La clé est définie en premier. Une sauvegarde ou extraction IronZIP qui s'exécute avant la ligne de clé lance LicensingException.
- 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 avecnew IronZipArchive(path, password). - Appels d'archive asynchrones. Aucune classe d'archive IronZIP n'a de membre se terminant par Async, donc un appel à
SaveAsAsyncne compile pas. Enveloppez l'appel dansTask.Runlorsque 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.
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.
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.
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
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.
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é
IronZIP2026.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.
| Guide | Assistant et version | Modèle | Durée (minutes) |
|---|---|---|---|
| Ce guide | Claude Code 2.1.277, une session, invites de permission désactivées | Claude Opus 5 | 10.1 |
| Claude Code | Claude Code 2.1.277, invite 3 en mode plan | Claude Sonnet 5, avec Claude Opus 5 via opusplan pour le plan dans l'invite 3 | 32.8 |
| ChatGPT Codex | Codex CLI 0.160.0, une session reprise | GPT-6 Luna | 39.4 |
| GitHub Copilot | GitHub Copilot CLI 1.0.95, invite 3 en mode plan | GPT-6 Luna, routé par Auto | 9.3 |
| Cursor | Cursor 3.23.23 application de bureau, invite 3 en mode plan | Grok 4.7 | 57.4 |
| Google Antigravity | Antigravity CLI 1.3.2, mis à jour à 1.3.3 après l'invite 1, invites 1 et 4 via /plan, invites de permission ignorées | Gemini 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.
- Utilisez IronZIP avec Claude Code pour mettre à jour une archive de cas protégé en place
- Utilisez IronZIP avec ChatGPT Codex pour décompiler une chute de partenaire de formats d'archive mixtes et vérifier chaque SHA-256 de fichier
- Utilisez IronZIP avec GitHub Copilot pour les lots de journaux quotidiens .tar.gz et une restauration qui refuse les entrées non sécurisées
- Utilisez IronZIP avec Cursor pour déplacer les lots de téléchargement de System.IO.Compression vers des fichiers ZIP AES-256
- Utilisez IronZIP avec Google Antigravity pour servir des documents de cas à partir d'une page Web sous forme de ZIP protégé
Dépannage
- Clés de licence IronZIP pour lorsque le code généré lance une LicensingException
- Limites de taille de fichier et d'archive IronZIP pour les archives dépassant les limites classiques de 4 Go et 65 535 entrées ZIP
- Extraire un ZIP protégé pour quand une archive protégée par mot de passe ne s'ouvre pas
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.