Wie verwendet man IronZIP mit ChatGPT Codex
Partner senden ihre nächtlichen Dateien in jedem Format, das ihre eigenen Systeme produzieren. Ein Drop enthält ZIP-Dateien mit und ohne Passwörter, TAR- und TGZ-Bündel von Linux-Hosts, ein BZIP2-Lagerbündel, eine Datei namens .tar, die eigentlich ein ZIP ist, und ein Upload, der auf halbem Weg gestoppt wurde. Der Eingang muss jede einzelne entpacken, nachweisen, dass jede Datei so ankam, wie der Partner sie gesendet hat, und sagen, welche Uploads fehlschlugen und warum.
ChatGPT Codex, OpenAIs Coding-Agent, läuft im Terminal, in Editoren, innerhalb der ChatGPT-Desktop-App und als Cloud-Dienst, und jeder davon akzeptiert einen ChatGPT-Login. IronZIP ist Iron Softwares .NET-Bibliothek zum Lesen und Schreiben von ZIP-, TAR-, GZIP- und BZIP2-Archiven.
Diese Anleitung gibt Codex einen Drop von 25 Uploads, ein Manifest mit dem Status, den jeder bekommen sollte, und eine SHA-256-Liste von jedem Partner. Die meisten Eingabeaufforderungen verlangen von Codex eine CSV, die eine Zeile für jede Datei enthält, und jedes unten beschriebene Verhalten von IronZIP wurde in der Version 2026.10.2 gemessen.
SchnellstartStarten Sie Codex aus dem .NET-Konsolenprojekt, das den Drop enthält, und fragen Sie zuerst nach einer 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.
Minimaler Arbeitsablauf (5 Schritte)
- Fügen Sie das IronZIP NuGet-Paket zum Projekt hinzu
- Speichern Sie die IronZIP-Skill als .agents/skills/ironzip/SKILL.md, damit die
$ironzip-Erwähnung aufgelöst wird. - Wählen Sie die IronZIP-Klasse aus den Anfangs-Bytes jeder Datei, niemals aus der Erweiterung.
- Hashen Sie jede extrahierte Datei gegen die Prüfsummenliste des Absenders.
- Vergleichen Sie die Ergebnisse CSV mit Ihren erwarteten Status und überprüfen Sie jedes Mitglied, das Codex in der API-Referenz genannt hat.
Was ist ChatGPT Codex und wie passt es zur .NET-Archivarbeit?
Die Codex CLI-Seiten behandeln die Installation mit npm install -g @openai/codex oder einem eigenständigen Installer, und die IDE-Seiten behandeln Editoren.
OpenAIs Sicherheitsrichtlinien bitten Sie, Codex-Vorschläge wie jede andere Pull-Request zu behandeln, mit gezielter Verifizierung und einer Differenzüberprüfung. Ein erfundenes Mitglied lässt den Build scheitern, und ein falsch behandeltes Archiv erscheint als ein Status, den das Manifest widerspricht.
Wie schreibt man eine IronZIP-Eingabeaufforderung und richtet Codex dafür ein?
Eine Intake-Eingabeaufforderung benennt das Eingabeformat, die Formatregel, die Ausgabeordner, den Prüfsummenbeweis, die Passwortquelle und die schreibgeschützten Ordner. Jeder fehlende Teil wird zu einer Wahl, die der Agent für Sie trifft.
Codex scannt .agents/skills im Arbeitsverzeichnis und in jedem übergeordneten Ordner bis zum Repository-Stamm. IronZIPs skill.md, gespeichert als .agents/skills/IronZIP/SKILL.md, ermöglicht die Auflösung von $ironzip. Seine Beispiele fixieren 2026.8.2, und es erwähnt weder das TAR-Ordner-Versagen noch das Einzeldaten-Passwortversagen, das unten gemessen wird.
Codex liest AGENTS.md zu Beginn jedes Durchlaufs, höchstens eine Datei pro Ordner auf dem Pfad vom Projektstamm zum Arbeitsordner. Dateien, die näher am Arbeitsordner sind, überschreiben frühere. IronZIPs llms.txt-Index ist die zweite API-Quelle.
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.
Wie fragen Sie Codex nach dem Hinzufügen von IronZIP und Überprüfen des Pakets?
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.
NuGet listet das Paket als IronZIP, und Code importiert den IronZip-Namespace. Mit .NET SDK 10.0.400, dotnet add package IronZip, schrieb der Befehl, den IronZIPs Skill gibt, die Referenz als IronZIP, während restore IronZip aufzeichnete, und dotnet list package stoppte dann mit der Meldung, ein Paket-Referenz nicht lesen zu können. Das Hinzufügen des Pakets als IronZIP hielt die beiden Schreibweisen gleich. Seine einzige Abhängigkeit, IronSoftware.Common 2026.4.2, fügte 23 weitere Pakete zur Wiederherstellung auf .NET 9 hinzu.
IronZIP hat keinen reduzierten Modus ohne Schlüssel. In einer Untersuchung warf jeder Anruf, der ein Archiv öffnete, listete oder extrahierte, eine LicensingException, deren Nachricht „Production License Required“ lautete. Mit IRONZIP_LICENSE_KEY definiert, blieb License.IsLicensed falsch, bis der Code den Wert auf License.LicenseKey zuwies.
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.
Die Lizenzschlüssel-Seite dokumentiert die IronZip.LicenseKey-Einstellung für appsettings.json, App.config und Web.config.
Wie erkennt man, was ein Archiv wirklich ist, bevor man es extrahiert?
IronZipArchive liest nur ZIP-Dateien. Bei einer TAR-, GZIP-, BZIP2- oder Textdatei warf es eine ZipException und sagte, dass das zentrale Verzeichnis nicht gefunden werden konnte, und das Öffnen einer 0-Byte-Datei gab EOF im Header an. Die Anfangs-Bytes identifizieren das Format. OpenAI dokumentiert den eingebauten Explorer-Agenten für die erkundungsintensive Codebasis.
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.
Fünf Uploads sollten markiert werden. Einer ist ein ZIP, das .tar genannt wird, einer ein TGZ, das .zip genannt wird, einer eine Textdatei und zufällige Bytes, die beide Archiv-Erweiterungen tragen, und einer ist leer.
Wie listet man auf, was in jedem Archiv ist?
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.
GetArchiveEntryNames gibt nur die Namen eines TARs an, während Entries ein Entry zurückgibt, das den Namen, die Größe, die gespeicherte CRC und das IsCrypted-Flag jedes Elements enthält. GZIP und BZIP2 haben keinen List-Aufruf. Ordner-Einträge zählen als Einträge, und das Kestrel-Pod-Archiv listete 252 davon für 250 Dateien.
Das Öffnen eines verschlüsselten ZIPs ohne Passwort warf ArgumentNullException, und ebenso das Übergeben eines Passworts für ein ZIP, das keines hat. Bei AES-Archiven mit mehr als einem Eintrag akzeptierte der Konstruktor ein falsches Passwort und Entries listete jede Datei, sodass eine Liste nicht zwischen einem guten und einem schlechten Passwort unterscheiden kann.
Wie extrahiert man jedes Archiv und beweist, dass die Dateien intakt angekommen sind?
OpenAI beschreibt den eingebauten Worker-Agenten als ausführungsorientiert, für Implementierung und Fehlerbehebung. Das Beispiel für das Extrahieren eines geschützten ZIPs zeigt die Passwortüberladung des statischen Extraktionsaufrufs.
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.
Der Hash-Check ist mit IronZIP erforderlich, da die Extraktion einen Eintrag nicht mit seiner gespeicherten CRC vergleicht. In ivy-orders kam ein umgekipptes Byte in einem gespeicherten Eintrag ohne Ausnahme heraus, und der Crc-Wert dieses Eintrags unterschied sich von der CRC der auf die Festplatte geschriebenen Datei.
Eine GZIP-Extraktion eines ZIP-, TAR- oder Textdatei warf und schrieb dennoch eine leere Datei unter dem Namen des Archivs, und ein falsches Passwort ließ einen leeren Ordner zurück, sodass die README um Aufräumarbeiten bittet. Eine zweite Extraktion in dasselbe Verzeichnis überschrieb die Dateien ohne Warnung.
Warum schlägt ein TAR mit Unterordnern beim Extrahieren fehl?
IronTarArchive.ExtractArchiveToDirectory erstellt keine Ordner. Bei jedem TAR mit Einträgen in Unterordnern warf es DirectoryNotFoundException und schrieb nichts, unabhängig davon, ob das TAR Ordner-Einträge hatte oder nicht. Jeder Ordner, der aus GetArchiveEntryNames erstellt wurde, machte den gleichen Aufruf erfolgreich.
Warum wird dieselbe GZIP-Datei unter einem anderen Namen anders extrahiert?
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.
IronGZipArchive entscheidet nach Dateinamen. Unter einem Namen, der auf .tgz oder .tar.gz endet, packten sowohl ExtractArchiveToDirectory als auch ExtractTGZArchiveToDirectory das TAR darin aus. Unter jedem anderen Namen schrieben beide eine dekomprimierte Datei mit dem Namen des Archivs abzüglich seiner letzten Erweiterung, sodass das TGZ, das .zip genannt wird, als einzelne TAR-Datei herauskam. IronBZip2Archive packte ein TAR nur von einem .tar.bz2 Namen aus, nicht von .tbz2. Das Beispiel für das Extrahieren von GZIP ruft ExtractArchiveToDirectory in seinem ersten Codebeispiel und den TGZ-Aufruf im zweiten auf.
Was macht IronZIP mit einem Passwort, das es nicht verwenden kann?
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.
Die Extraktion war der erste Aufruf, der das falsche Passwort ablehnte, mit einer ArgumentException, deren Nachricht „Ungültiges Passwort!!“ lautete.
Warum wird das richtige Passwort abgelehnt?
Codex akzeptiert Bilder, die mit -i über die Befehlszeile übergeben werden (Langform --image), codex exec resume eingeschlossen, oder in den Composer eingefügt werden.
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.
Das angezeigte Passwort ist korrekt. Jede Methode, dieses Archiv damit zu öffnen, der Konstruktor von einem Pfad, Bytes oder einem Stream und FromArchive, warf System.Exception mit „Ungültiges Passwort!“, während ExtractArchiveToDirectory mit demselben Passwort die Rate Card mit einem passenden Hash schrieb. Das Archiv enthält einen einzigen Eintrag.
Wie debuggt man falsche Intake-Ausgaben von Anfang bis Ende?
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.
Eine fundierte Diagnose findet zwei Ursachen. Die Aufgabe verarbeitet jeden Upload unter einem gehashten Namen, der nur die letzte Erweiterung beibehält, so dass IronZIP niemals .tar.gz oder .tar.bz2 sieht. Es schreibt jedes dekomprimierte TAR als eine Datei und benennt jeden Einzeldaten-Upload nach dem Hash. Nichts vergleicht die extrahierten Dateien mit einer Prüfsumme oder einer CRC, so dass der beschädigte Ivy-Eintrag als in Ordnung gilt.
Wie wandeln Sie einmalige Codes in wiederverwendbare, getestete Komponenten um?
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.
Ein Refactoring, das die Ordnererstellung oder den Hash-Check weglässt, baut trotzdem, daher endet die Eingabeaufforderung mit einem vollständigen Neustart gegen das Manifest.
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.
Behaupten Sie auf Status und extrahierte Datei-Hashes, nie auf Archiv-Bytes.
$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.
Auf 2026.10.2 listet die Objektreferenz fünf statische Aufrufe, ExtractArchiveToDirectory auf jeder Archivklasse plus ExtractTGZArchiveToDirectory.
Wie verwendet man diese Eingabeaufforderungen erneut bei einem anderen Archiv-Drop?
Die gleichen Eingabeaufforderungen funktionieren für einen anderen Eingangs-Drop, nachdem sich die Pfade, Statusregeln und Prüfsummenlisten ändern. Der Leitfaden für KI-Coding-Assistenten führt einen Akzeptanztest durch, der von einem leeren Ordner aus startet.
Was haben die Aufforderungen in einem realen Lauf erzeugt?
Alle 14 Eingabeaufforderungen liefen der Reihe nach in einer einzigen unbeaufsichtigten Codex-CLI-Sitzung durch Codex exec. Jede Figur unten stammt aus unseren eigenen Prüfungen danach, darunter ein Release-Build mit 0 Fehlern und 0 Warnungen und einem Python-Rehash, unabhängig von IronZIP.
- Der erste Extraktor meldete 16 extrahiert, 3 geschützte und 6 unlesbare, und 23 seiner 25 Zeilen stimmten mit dem Manifest überein.
- Nach der Ticket-Aufforderung stimmten 24 der 25 Zeilen überein.
- Der letzte Job meldete 18 extrahiert, 2 geschützte und 5 unlesbare, und alle 25 Zeilen stimmten in Status und Grund überein.
- Der Rehash stimmte alle 314 Dateien aus den 18 extrahierten Uploads mit den Partner-Listen ab.
- Nichts blieb auf der Festplatte für die anderen sieben Uploads.
- Eine Wiederholung des endgültigen Jobs auf einer Kopie des Codes dauerte 3,9 Sekunden und schrieb identische Bytes.
- Alle 5 Tests bestanden mit dem Schlüssel, und alle 5 scheiterten in einer erneuten Ausführung ohne ihn.
- Der Quickstart listete 2 der 8 Beispiel-Dateien auf, mit 18 Einträgen und keinem verschlüsselten, und protokollierte eine ArgumentNullException und fünf ZipExceptions für den Rest.
- Das Inventar markierte genau die fünf oben genannten Uploads.
- Die Kopie des Explorer-Agents unterschied sich von der des Skripts in 10 von 25 Zeilen, neun im Formattext und eine mit sieben der acht Anfangsbytes.
- Listing schrieb 310 Eintragszeilen für die 16 ZIP- und TAR-Uploads, und 13 stimmten mit den Dateianzahlen des Manifests überein.
- Das geschützte ZIP ohne Passwort, das Einzeldaten-ZIP und der abgeschnittene Upload konnten nicht aufgelistet werden.
- Wurde der Schlüssel aus dem Kindprozess entfernt, warfen 8 von 8 Anrufen die Lizensierungsausnahme.
- Der Passwort-Scan las 344 Ausgabedateien und stimmte mit keiner überein.
- Die nächtliche Diagnose nannte beide Ursachen und änderte keinen Code.
- Ein Wiederholungsdurchlauf des nächtlichen Jobs protokollierte die gleichen 16 gut und 9 fehlgeschlagen, und fünf der 16 scheiterten an den Partner-Prüfsummen.
- Einige Schritte liefen anders als die Seite. Codex hat die Paketreferenz von Hand als IronZIP geschrieben, daher funktionierte dotnet list package sofort. Der erste Extraktor erstellte bereits die TAR-Ordner und platzierte GZIP TARs unter einem .tgz-Namen, also stimmten die Zeilen, die nicht übereinstimmten, Delta-Rates und Grabenbestand. Die Format-Aufforderung behob keines von beiden in drei Runden, da ihre Untersuchung IronTarArchive ein CSV übergab, das IronBZip2Archive bereits entpackt hatte. Die Ticket-Aufforderung behob Delta-Rates, und das Refactoring behob Grove-Stock. Die Refactoring-Aufforderung bat darum, namensbasiertes Staging für BZIP2 beizubehalten, was ein .tar.bz2-Name überflüssig macht. Die finale Ergebnissdatei nennt einen IronTarArchive-Aufruf für diese Zeile, den der Code nicht mehr macht. IntakeJob.cs kam auf 32 Zeilen, weil der Workflow in eine zweite Partitialdatei von 382 Zeilen überging. Die vier Agenten liefen als separate Threads ohne Agenten-Typ, sodass keine eingebaute Explorer- oder Worker-Rolle aufgezeichnet wurde.
Der Google Antigravity-Leitfaden fand denselben Einzeldaten-Passwortfehler in einem Download-Dienst und überprüfte Archive stattdessen durch Extraktion und SHA-256. Im GitHub Copilot-Leitfaden speicherte IronZIPs TAR-Schreiber jedes Protokoll unter seinem nackten Dateinamen, sodass gleichnamige Protokolle kollidierten. Die Codex-Version, das Modell und das Timing sind im gemeinsamen Laufprotokoll enthalten.
Fehlerbehebung
- TAR extrahieren, wenn ein TAR mit Unterordnern DirectoryNotFoundException wirft
- GZIP extrahieren, wenn ein TGZ als eine Datei herauskommt
- Geschütztes ZIP extrahieren, wenn das richtige Passwort abgelehnt wird
- IronZIP-Lizenzschlüssel, wenn jeder Anruf einen Lizenzierungsfehler wirft
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.