Comment utiliser IronZIP avec ChatGPT Codex

Curtis Chau
Curtis Chau
Mis à jour : 26 octobre 2026

Les partenaires envoient leurs fichiers nocturnes dans le format que leurs propres systèmes produisent. Une goutte contient des fichiers ZIP avec et sans mots de passe, des lots TAR et TGZ d'hôtes Linux, un lot de stock BZIP2, un fichier nommé .tar qui est en réalité un ZIP, et un téléchargement qui s'est arrêté à mi-chemin. L'admission doit décompresser chaque fichier, prouver que chaque fichier est arrivé tel que le partenaire l'a envoyé, et indiquer quels téléchargements ont échoué et pourquoi.

ChatGPT Codex, l'agent de codage d'OpenAI, fonctionne dans le terminal, dans les éditeurs, à l'intérieur de l'application de bureau ChatGPT et en tant que service cloud, et chacun de ces éléments accepte une connexion ChatGPT. IronZIP est la bibliothèque .NET d'Iron Software pour lire et écrire des archives ZIP, TAR, GZIP et BZIP2.

Ce guide donne à Codex une goutte de 25 téléchargements, un manifeste avec l'état que chacun devrait obtenir, et une liste SHA-256 de chaque partenaire. La plupart des invites demandent à Codex un CSV contenant une ligne pour chaque fichier, et chaque comportement d'IronZIP décrit ci-dessous a été mesuré sur la version 2026.10.2.

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.

Lancez Codex depuis le projet de console .NET qui contient la goutte, et commencez par demander une liste.

$ironzip Add IronZIP 2026.10.2 from NuGet to this console project.
Next, Program.cs opens every file in Drop/sample/ with IronZipArchive, read-only.

out/quickstart.csv gets one row per file, holding these values:

- entry count
- encrypted entry count
- the exception type when IronZIP refuses the file

Read that CSV back and print its totals.
Assign the key from IRONZIP_LICENSE_KEY and never print it.
Extract nothing yet.
Build and run it with three repair attempts at most, then report what happened.
Text


Qu'est-ce que ChatGPT Codex et comment s'intègre-t-il dans le travail d'archive .NET?

Les pages CLI de Codex couvrent l'installation avec npm install -g @openai/codex ou un installateur autonome, et les pages IDE couvrent les éditeurs.

Les directives de sécurité d'OpenAI vous demandent de traiter les suggestions de Codex comme toute autre demande de tirage, avec une vérification ciblée et une révision du diff. Un membre inventé échoue à la construction, et une archive mal gérée apparaît comme un statut que le manifeste contredit.

Comment rédiger une invite IronZIP et configurer Codex pour cela?

Une invite d'admission nomme l'entrée, la règle de format, les dossiers de sortie, la preuve de la somme de contrôle, la source du mot de passe et les dossiers en lecture seule. Toute partie non incluse devient un choix que l'agent fait pour vous.

Codex analyse .agents/skills dans le répertoire de travail et dans chaque dossier parent jusqu'à la racine du dépôt. Le skill.md d'IronZIP, enregistré sous .agents/skills/IronZIP/SKILL.md, fait que $ironzip se résout. Ses exemples sont fixés à 2026.8.2, et il ne mentionne ni l'échec de dossier TAR ni l'échec de mot de passe à une seule entrée mesuré ci-dessous.

Codex lit AGENTS.md au début de chaque exécution, au plus un fichier par dossier sur le chemin de la racine du projet au dossier de travail. Les fichiers plus près du dossier de travail remplacent les précédents. L'index llms.txt d'IronZIP est la deuxième source API.

Give the repository root an AGENTS.md holding a Partner drop intake section.
The section holds these rules:

- IronZIP is the only archive library allowed.
- Its package is IronZIP, and its namespaces are IronZip and IronZip.Enum.
- The API sources are the ironzip skill in .agents/skills/ironzip/ and the llms.txt index.
- The index URL reads https://ironsoftware.com/zip/csharp/llms.txt.
- Nothing under Drop/ or config/ may change.
- Passwords from config/passwords.csv never appear in code, output or logs.
- IRONZIP_LICENSE_KEY is checked for presence and length only.
- A reply gives a count only when a results file backs it.
- That file was read or written in the same turn.
Text

Comment demander à Codex d'ajouter IronZIP et de vérifier le package?

Show me these:

- the IronZIP PackageReference in DropIntake.csproj
- the version restore resolved
- every IronSoftware package that dotnet list package --include-transitive reports

If that command can't read the package reference, find out why within three attempts.
Make the smallest change that lets it run, and say what you changed.
Keep the same package and version.
Write the packages that command lists to out/packages.csv.
Text

NuGet liste le package sous IronZIP, et le code importe l'espace de noms IronZip. Avec le .NET SDK 10.0.400, dotnet add package IronZip, la commande que la compétence d'IronZIP donne, a écrit la référence sous IronZIP tandis que la restauration a enregistré IronZip, et dotnet list package s'est ensuite arrêtée avec Impossible de lire une référence de package. Ajouter le package en tant que IronZIP a gardé les deux orthographes identiques. Sa seule dépendance, IronSoftware.Common 2026.4.2, a ajouté 23 packages supplémentaires à la restauration sur .NET 9.

IronZIP n'a pas de mode réduit sans clé. Dans une sonde, chaque appel qui ouvrait, listait ou extrayait une archive a lancé une LicensingException dont le message indiquait Production License Required. Avec IRONZIP_LICENSE_KEY défini, License.IsLicensed est resté faux jusqu'à ce que le code attribue la valeur à License.LicenseKey.

Add a public Startup class with a public ApplyIronZipKey method, called first in Program.cs.
It assigns IRONZIP_LICENSE_KEY to IronZip.License.LicenseKey.
It reports only whether License.IsLicensed is true.

Then add a --list-sample mode that makes one listing pass over Drop/sample/.
Run it twice as a child process:

1. Run it unchanged.
2. Run it with IRONZIP_LICENSE_KEY removed from that child's environment alone, never the session's.

Write out/license-check.csv with columns run, file, IronZIP call, exception type and message.
IronZIP's licensing exception is internal, so catch Exception and log GetType().FullName.
Tell me which calls threw.
Text

La page des clés de licence documente le paramètre IronZip.LicenseKey pour appsettings.json, App.config et Web.config.

Comment savoir ce qu'est réellement une archive avant de l'extraire?

IronZipArchive lit uniquement les fichiers ZIP. Étant donné un fichier TAR, GZIP, BZIP2 ou texte, il a lancé une ZipException indiquant qu'il ne pouvait pas trouver le répertoire central, et ouvrir un fichier de 0 octet a donné EOF dans l'en-tête. Les premiers octets identifient le format. OpenAI documente l'agent explorateur intégré pour l'exploration de base de code principalement en lecture.

Have the explorer agent go through Drop/inbox/ and note these values for every file:

- the byte count
- the opening eight bytes as hex
- the five bytes at offset 257, skipped for files shorter than 262 bytes
- the format those bytes indicate under Drop/README.md

Save what it reports as out/inventory-explorer.csv.
Then write a small script that computes the same fields into out/inventory.csv.
For GZIP and BZIP2 data, IronZIP decompresses a temporary copy saved under out/tmp/.
That copy gets a .gz or .bz2 name, and the script tests it for a TAR header.
The script labels each file ZIP, TAR, GZIP, TAR.GZ, BZIP2, TAR.BZ2, EMPTY or NONE.

Then list the rows where the two files differ.
Also list every file whose extension disagrees with its content.
Text

Cinq téléchargements devraient être signalés. L'un est un ZIP nommé .tar, un autre un TGZ nommé .zip, un troisième un fichier texte et un quatrième des octets aléatoires qui portent tous deux des extensions d'archive, et un cinquième est vide.

Comment lister ce qui est à l'intérieur de chaque archive?

Create Services/EntryLister.cs.
It lists every inbox archive the inventory calls ZIP or TAR, without extracting.
It reads them this way:

- For ZIP, open an IronZipArchive and call its Entries() method.
- When an open without a password fails, open again with the password from config/passwords.csv.
- For TAR, open an IronTarArchive and call GetArchiveEntryNames().

Give out/entries.csv the columns archive, entry, size, stored CRC, encrypted, or the exception type.
Also write out/entry-counts.csv.
It compares the file entries of each archive with the files column of Drop/manifest.csv.
Tell me which archives the comparison flags.
Text

GetArchiveEntryNames donne uniquement les noms d'un TAR, tandis que Entries renvoie un Entry avec le nom de chaque élément, sa taille, le CRC stocké et le drapeau IsCrypted. GZIP et BZIP2 n'ont pas d'appel de liste. Les entrées de dossier comptent comme des entrées, et l'archive kestrel-pod a listé 252 d'entre elles pour 250 fichiers.

Ouvrir un ZIP chiffré sans mot de passe a lancé une ArgumentNullException, tout comme passer un mot de passe pour un ZIP qui n'en a pas. Sur les archives AES avec plus d'une entrée, le constructeur a accepté un mot de passe incorrect et Entries a listé chaque fichier, donc une liste ne peut pas distinguer un bon mot de passe d'un mauvais.

Comment extraire chaque archive et prouver que les fichiers sont arrivés intacts?

OpenAI décrit l'agent de travail intégré comme axé sur l'exécution, pour la mise en œuvre et les corrections. L'exemple d'extraction de ZIP protégé montre la surcharge de mot de passe de l'appel d'extraction statique.

Have the worker agent write Services/IntakeExtractor.cs.
It applies Drop/README.md to every inbox file in this order:

1. Choose the IronZIP class from the format in out/inventory.csv.
2. Extract into out/extracted/<file name>/.
3. Hash each extracted file against Drop/checksums/.
4. Set the README status and reason.

Add an --intake mode that writes out/intake-results.csv.
Its columns are file, format, IronZIP call, status and reason.
After those come files expected, files matching and exception type.
The mode prints the status counts read from that file.
Tell me those counts.
Text

Le contrôle de hachage est requis avec IronZIP, car l'extraction ne compare pas une entrée avec son CRC stocké. Dans ivy-orders, un octet inversé dans une entrée stockée est sorti sans exception, et la valeur Crc de cette entrée différait du CRC du fichier écrit sur le disque.

Une extraction GZIP d'un fichier ZIP, TAR ou texte a lancé et a encore écrit un fichier vide sous le nom de l'archive, et un mot de passe incorrect a laissé un dossier vide, donc le README demande un nettoyage. Extraire dans le même dossier une deuxième fois a écrasé les fichiers sans avertissement.

Pourquoi un TAR avec des sous-dossiers échoue-t-il à l'extraction?

IronTarArchive.ExtractArchiveToDirectory ne crée pas de dossiers. Sur chaque TAR avec des entrées dans des sous-dossiers, il a lancé DirectoryNotFoundException et n'a rien écrit, que le TAR contienne ou non des entrées de dossier. Créer chaque dossier à partir de GetArchiveEntryNames a d'abord fait réussir le même appel.

Pourquoi le même fichier GZIP s'extrait-il différemment sous un autre nom?

Rerun --intake.
Find each row of out/intake-results.csv whose status or reason disagrees with Drop/manifest.csv.
Add <Compile Remove="scratch/**" /> to DropIntake.csproj.
Make a scratch console project under scratch/format-probe/.
From it, call the same IronZIP method on a copy of each such file, and record what it wrote.

Save the findings to out/format-check.csv, then fix the extractor.
Stop after three fix rounds or when every row agrees.
Tell me which rows still disagree.
Text

IronGZipArchive décide par nom de fichier. Sous un nom se terminant par .tgz ou .tar.gz, ExtractArchiveToDirectory et ExtractTGZArchiveToDirectory ont tous deux décompressé le TAR à l'intérieur. Sous tout autre nom, les deux ont écrit un fichier décompressé nommé d'après l'archive moins sa dernière extension, donc le TGZ nommé .zip est sorti comme un seul fichier TAR. IronBZip2Archive a décompressé un TAR uniquement à partir d'un nom .tar.bz2, pas de .tbz2. L'exemple d'extraction GZIP appelle ExtractArchiveToDirectory dans son premier exemple de code et l'appel TGZ dans le second.

Que fait IronZIP avec un mot de passe qu'il ne peut pas utiliser?

Check the protected ZIP files in out/intake-results.csv against these rules:

- A file with no listed password is Protected with reason no-password.
- A file whose listed password fails is Protected with reason wrong-password.

Name the IronZIP call that first rejected the wrong password.
Base that on out/entries.csv together with out/intake-results.csv.
Then write out/password-scan.csv, listing every file under out/.
Each row says yes or no for whether that file holds any password from config/passwords.csv.
Read the passwords inside the program at run time, and never pass one on a command line.
Report the match count from that file.
Text

L'extraction a été le premier appel à rejeter le mauvais mot de passe, avec une ArgumentException dont le message indique Mot de passe invalide !!

Pourquoi le bon mot de passe est-il rejeté?

Codex accepte les images passées avec -i (forme longue --image) sur la ligne de commande, codex exec resume inclus, ou collées dans le compositeur.

The image attached to this turn with -i is a Delta Freight support ticket.
It concerns delta-rates-2026-10-09.zip.
Read it, and reproduce the error with the project's own code.
Decide which of these is true:

- The password in config/passwords.csv is wrong.
- IronZIP refuses it for another reason.

Write out/delta-check.csv with these columns:

- IronZIP call
- which file the password came from
- outcome
- exception type

Change code only where that evidence calls for it.
Tell me which of the two it is.
Text

Le mot de passe listé est correct. Chaque façon d'ouvrir cette archive avec elle, le constructeur à partir d'un chemin, d'octets ou d'un flux et FromArchive, a lancé System.Exception avec Mot de passe incorrect!, tandis que ExtractArchiveToDirectory avec le même mot de passe a écrit la carte tarifaire avec un hachage correspondant. L'archive contient une seule entrée.

Comment déboguer une sortie d'admission incorrecte de bout en bout?

The nightly log calls 16 archives ok.
Yet Feedback/warehouse-2026-10-11.md lists five of them that reached the warehouse wrong.
Send the explorer agent through Jobs/NightlyIntake.cs and Logs/nightly-2026-10-11/.
The explorer edits nothing.

Work out how each of those five got past the job's success check.
Name the lines responsible.
Suggest the narrowest change and a command that would confirm it.
Save the diagnosis as out/nightly-diagnosis.md, and tell me what it found.
Edit no code in this turn.
Text

Un bon diagnostic trouve deux causes. Les étapes du travail chaque téléchargement sous un nom haché qui ne conserve que la dernière extension, donc IronZIP ne voit jamais .tar.gz ou .tar.bz2. Il écrit chaque TAR décompressé comme un seul fichier et nomme chaque téléchargement à fichier unique d'après le hachage. Rien ne compare les fichiers extraits avec une somme de contrôle ou un CRC, donc l'entrée ivy endommagée passe comme ok.

Comment transformer un code ponctuel en composants réutilisables et testés?

Have the worker agent fold the intake modes into a public IntakeJob class, set up like this:

- It's resolved through Microsoft.Extensions.DependencyInjection, version 9.0.20, which it adds.
- A public IntakeOptions record holds its inbox, output root, passwords file and checksums folder.
- IntakeJob.cs stays under 200 lines, with XML doc comments.

Keep these behaviors:

- the byte-based format choice
- the folder creation before TAR extraction
- the name-based staging for GZIP and BZIP2
- the hash check
- the password rules
- the cleanup

Run it over Drop/inbox/, writing out/final/ and out/final.csv.
Confirm every row matches Drop/manifest.csv on status and reason.
Stop after three fix rounds, and tell me how many rows match.
Text

Un refactor qui supprime la création de dossier ou le contrôle de hachage se construit toujours, donc l'invite se termine par une reprise complète contre le manifeste.

Add an xUnit project at tests/DropIntake.Tests with these packages:

- xunit 2.9.3
- xunit.runner.visualstudio 3.1.5
- Microsoft.NET.Test.Sdk 18.0.1

Add <Compile Remove="tests/**" /> to DropIntake.csproj.
Put both projects in one DropIntake.sln at the repository root.
Call Startup.ApplyIronZipKey before the first IronZIP call.

Test IntakeJob on real inbox files, with a separate output folder per test, for these cases:

- fern-logs-2026-10-09.tar yields its four logs in their folders.
- juniper-routes-2026-10-09.zip is read as TAR.GZ.
- ivy-orders-2026-10-09.zip is Unreadable with reason damaged.
- elm-claims-2026-10-09.zip is Protected with reason wrong-password.
- delta-rates-2026-10-09.zip is Extracted.

Run dotnet test into out/tests/ with a trx logger.
Report the passed and failed counts, quoted from the .trx file.
Text

Confirmez sur les statuts et les hachages de fichiers extraits, jamais sur les octets d'archive.

$ironzip Open IronZip.xml in the ironzip folder of the NuGet package cache and answer two questions:

- Which method extracts an archive, class by class?
- Which archive classes can list their entries without extracting?

Confirm each answer by compiling a probe under scratch/, which DropIntake.csproj must not compile.
Name any member of that IronZip.xml that does not compile, or say that none failed.
Then show the line in IntakeJob that picks the extraction call for each format.
Text

Sur 2026.10.2, la référence de l'objet liste cinq appels statiques, ExtractArchiveToDirectory sur chaque classe d'archive plus ExtractTGZArchiveToDirectory.

Comment réutiliser ces invites sur une autre goutte d'archive?

Les mêmes invites fonctionnent pour une autre goutte entrante après que ses chemins, règles de statut et listes de sommes de contrôle aient changé. Le guide des assistants de codage AI exécute un test d'acceptation qui commence à partir d'un dossier vide.

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

Les 14 invites se sont exécutées, dans l'ordre, dans une seule session CLI Codex non assistée via codex exec. Chaque chiffre ci-dessous provient de nos propres contrôles ensuite, parmi eux une construction Release sans erreurs et sans avertissements et un rehachage Python indépendant d'IronZIP.

  • Le premier extracteur a signalé 16 Extraits, 3 Protégés et 6 Illisibles, et 23 de ses 25 lignes correspondaient au manifeste.
  • Après l'invite de ticket, 24 des 25 lignes correspondaient.
  • Le travail final a signalé 18 Extraits, 2 Protégés et 5 Illisibles, et les 25 lignes correspondaient toutes sur le statut et la raison.
  • Le rehachage a fait correspondre les 314 fichiers des 18 téléchargements Extraits avec les listes de partenaires.
  • Rien n'était laissé sur le disque pour les sept autres téléchargements.
  • Une reprise du travail final sur une copie du code a pris 3,9 secondes et a écrit des octets identiques.
  • Les 5 tests ont réussi avec la clé, et les 5 ont échoué lors d'une reprise sans elle.
  • Le Quickstart a listé 2 des 8 fichiers d'exemple, avec 18 entrées et aucune chiffrée, et a enregistré une ArgumentNullException et cinq ZipExceptions pour le reste.
  • L'inventaire a signalé exactement les cinq téléchargements nommés ci-dessus.
  • La copie de l'agent explorateur différait de celle du script sur 10 des 25 lignes, neuf dans le libellé du format et une avec sept des huit premiers octets.
  • La liste a écrit 310 lignes d'entrée pour les 16 téléchargements ZIP et TAR, et 13 correspondaient aux comptes de fichiers du manifeste.
  • Le ZIP protégé sans mot de passe, le ZIP à une seule entrée et le téléchargement tronqué n'ont pas pu être listés.
  • Avec la clé retirée du processus enfant, 8 des 8 appels ont lancé l'exception de licence.
  • Le scan de mot de passe a lu 344 fichiers de sortie et n'en a fait correspondre aucun.
  • Le diagnostic nocturne a nommé les deux causes et n'a modifié aucun code.
  • Une répétition du travail nocturne a enregistré les mêmes 16 ok et 9 échoués, et cinq des 16 ont échoué aux sommes de contrôle partenaires.
  • Certaines étapes ont été exécutées différemment de la page. Codex a écrit la référence de package à la main en tant qu'IronZIP, donc la liste de packages dotnet a fonctionné immédiatement. Le premier extracteur avait déjà créé les dossiers TAR et mis en scène les TAR GZIP sous un nom .tgz, donc les lignes qui n'étaient pas d'accord étaient delta-rates et grove-stock. L'invite de format n'a corrigé aucune des deux en trois tours, car sa sonde a passé un CSV à IronTarArchive qu'IronBZip2Archive avait déjà décompressé. L'invite de ticket a corrigé delta-rates et le refactor a corrigé grove-stock. L'invite de refactor a demandé de conserver la mise en scène basée sur le nom pour BZIP2, ce qu'un nom .tar.bz2 rend inutile. Le fichier des résultats finaux nomme un appel IronTarArchive pour cette ligne que le code ne fait plus. IntakeJob.cs est arrivé à 32 lignes car le flux de travail est passé dans un deuxième fichier partiel de 382 lignes. Les quatre agents ont fonctionné comme des threads engendrés sans type d'agent, donc aucun rôle d'explorateur intégré ou de travailleur n'a été enregistré.

Le guide Google Antigravity a trouvé le même échec de mot de passe à une entrée dans un service de téléchargement et a vérifié les archives par extraction et SHA-256 à la place. Dans le guide GitHub Copilot, le rédacteur de TAR d'IronZIP a stocké chaque journal sous son nom de fichier nu, donc les journaux du même nom sont entrés en collision. La version, le modèle et le timing de Codex se trouvent dans le journal d'exécution partagé.


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é