Jak używać IronZIP z ChatGPT Codex

Curtis Chau
Curtis Chau
Zaktualizowano: 26 października 2026

Partnerzy wysyłają swoje nocne pliki w formacie, który produkują ich własne systemy. Jeden drop zawiera pliki ZIP z hasłami i bez nich, pakiety TAR i TGZ z hostów Linux, pakiet akcji BZIP2, plik o nazwie .tar, który tak naprawdę jest ZIP-em oraz przesyłkę, która zatrzymała się w połowie. Intake musi rozpakować każdy z nich, sprawdzić, czy każdy plik dotarł tak, jak wysłał go partner, oraz wskazać, które przesyłki nie powiodły się i dlaczego.

ChatGPT Codex, agent kodowania OpenAI, działa w terminalu, w edytorach, w aplikacji desktopowej ChatGPT oraz jako usługa chmurowa, a każda z tych opcji akceptuje logowanie ChatGPT. IronZIP to biblioteka .NET od Iron Software do odczytywania i zapisywania archiwów ZIP, TAR, GZIP i BZIP2.

Ten przewodnik daje Codexowi drop 25 przesyłek, manifest dotyczący statusu, jaki każda z nich powinna uzyskać, i listę SHA-256 od każdego partnera. Większość promptów prosi Codex o plik CSV, który zawiera jeden wiersz dla każdego pliku, a każde poniższe zachowanie IronZIP oceniano na wersji 2026.10.2.

Szybki start
NuGetInstalacja z NuGet

PM > Install-Package IronZip

Zainstaluj IronZIP, wykonując powyższe polecenie w konsoli Menedżera Pakietów NuGet lub wyszukaj pakiet w Menedżerze Pakietów NuGet.

Uruchomić Codex z projektu konsoli .NET, który zawiera drop, i najpierw zapytać o listę.

$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


Co to jest ChatGPT Codex i jak wpasowuje się w pracę z archiwami .NET?

Strony CLI Codex obejmują instalację z npm install -g @openai/codex lub samodzielnym instalatorem, a strony IDE obejmują edytory.

Wytyczne dotyczące bezpieczeństwa OpenAI zaleca traktowanie sugestii Codex jak dowolnego innego pull requestu, z ukierunkowaną weryfikacją i przeglądem różnic. Wymyślony członek powoduje błąd budowania, a nieodpowiednio obsłużone archiwum przedstawia się jako status, któremu manifest przeczy.

Jak napisać prompt IronZIP i skonfigurować dla niego Codex?

Prompt odbioru nazywa wejście, regułę formatu, foldery wyjściowe, dowód sumy kontrolnej, źródło hasła i foldery tylko do odczytu. Każda pominięta część staje się wyborem, którego agent dokonuje za użytkownika.

Codex skanuje .agents/skills w katalogu roboczym oraz w każdym nadkatalogu do korzenia repozytorium. skill.md IronZIP, zapisany jako .agents/skills/IronZIP/SKILL.md, sprawia, że $ironzip zostaje rozpoznany. Jego przykłady określają 2026.8.2 i nie wspominają ani o niepowodzeniu folderu TAR, ani o niepowodzeniu hasła dla pojedynczego wpisu opisanym poniżej.

Codex czyta AGENTS.md na początku każdego uruchomienia, maksymalnie jeden plik na folder na ścieżce od korzenia projektu do folderu roboczego. Pliki bliżej folderu roboczego nadpisują wcześniejsze. llms.txt indeks IronZIP jest drugim źródłem 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

Jak poprosić Codex o dodanie IronZIP i sprawdzenie pakietu?

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 wymienia pakiet jako IronZIP, a kod importuje przestrzeń nazw IronZip. Z SDK .NET 10.0.400, dotnet add package IronZip, polecenie, które daje umiejętność IronZIP, napisało odniesienie jako IronZIP podczas gdy przywracanie zarejestrowało IronZip, a dotnet list package następnie zatrzymało się z informacją Unable to read a package reference. Dodanie pakietu jako IronZIP trzymało dwie pisownie takie same. Jego jedyną zależnością, IronSoftware.Common 2026.4.2, dodano 23 więcej pakietów do przywracania na .NET 9.

IronZIP nie ma trybu ograniczonego bez klucza. W próbie, każde wywołanie, które otwarło, wymieniło lub wyodrębniło archiwum, wyrzuciło LicensingException, której wiadomość oznajmiła, że wymagana jest licencja produkcyjna. Z IRONZIP_LICENSE_KEY zdefiniowanym, License.IsLicensed pozostawało fałszywe, dopóki kod nie przypisał wartości do 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

Strona kluczy licencyjnych dokumentuje ustawienie IronZip.LicenseKey dla appsettings.json, App.config i Web.config.

Jak poznać, czym naprawdę jest archiwum przed jego wyodrębnieniem?

IronZipArchive czyta tylko pliki ZIP. Podając TAR, GZIP, BZIP2 lub plik tekstowy, wyrzucił ZipException mówiące, że nie można znaleźć katalogu centralnego, a otwarcie pliku o rozmiarze 0 bajtów dało EOF w nagłówku. Początkowe bajty identyfikują format. OpenAI dokumentuje wbudowanego agenta explorer do eksploracji bazy kodu z dużym naciskiem na odczyt.

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

Pięć przesyłek powinno być oznaczone. Jeden to ZIP nazwany .tar, jeden to TGZ nazwany .zip, jeden to plik tekstowy oraz jedne losowe bajty, które oba noszą rozszerzenia archiwum, a jeden jest pusty.

Jak wymienić, co znajduje się w każdym archiwum?

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 podaje tylko nazwy TAR, podczas gdy Entries zwraca Entry z nazwą każdego elementu, rozmiarem, zapisanym CRC i flagą IsCrypted. GZIP i BZIP2 nie mają wywołania do listowania. Wpisy folderów liczą się jako wpisy i archiwum kestrel-pod wymieniło ich 252 dla 250 plików.

Otwieranie zaszyfrowanego ZIP bez hasła wyrzuciło ArgumentNullException, podobnie jak podanie hasła dla ZIP, który go nie ma. W przypadku archiwów AES z więcej niż jednym wpisem konstruktor akceptował niewłaściwe hasło, a Entries wymieniało każdy plik, więc listowanie nie może odróżnić poprawnego hasła od złego.

Jak wyodrębnić każde archiwum i udowodnić, że pliki dotarły w stanie nienaruszonym?

OpenAI opisuje wbudowanego agenta worker jako skupionego na wykonaniu, do implementacji i poprawek. Przykład wyodrębniania chronionego ZIP pokazuje przeciążenie hasłem statycznego wywołania ekstrakcji.

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

Sprawdzenie skrótu jest wymagane z IronZIP, ponieważ ekstrakcja nie porównuje wpisu z jego zapisanym CRC. W przypadku ivy-orders jeden odwrócony bajt w zapisanym wpisie wyszedł bez wyjątku, a wartość Crc tego wpisu różniła się od CRC pliku zapisanego na dysku.

Ekstrakcja GZIP dla ZIP, TAR lub pliku tekstowego wyrzuciła i nadal zapisywała pusty plik pod nazwą archiwum, a błędne hasło zostawiło pusty folder, więc README prosi o oczyszczenie. Wyodrębnianie do tego samego folderu po raz drugi nadpisało pliki bez ostrzeżenia.

Dlaczego TAR z podfolderami nie powiodło się przy ekstrakcji?

IronTarArchive.ExtractArchiveToDirectory nie tworzy folderów. Przy każdym TAR z wpisami w podfolderach wyrzuciło DirectoryNotFoundException i nic nie zapisało, niezależnie od tego, czy TAR zawierał wpisy folderowe. Tworzenie każdego folderu z GetArchiveEntryNames na początku sprawiło, że to samo wywołanie zakończyło się sukcesem.

Dlaczego ten sam plik GZIP wyodrębnia się inaczej pod inną nazwą?

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 decyduje na podstawie nazwy pliku. Pod nazwą kończącą się na .tgz lub .tar.gz, zarówno ExtractArchiveToDirectory, jak i ExtractTGZArchiveToDirectory rozpakowały TAR w środku. Pod jakąkolwiek inną nazwą, oba zapisały jeden zdekompresowany plik nazwany po archiwum minus jego ostatnie rozszerzenie, więc TGZ nazwany .zip wyszedł jako pojedynczy plik TAR. IronBZip2Archive rozpakował TAR tylko z nazwy .tar.bz2, nie z .tbz2. Przykład wyodrębniania GZIP w pierwszym przykładzie kodu używa ExtractArchiveToDirectory, a w drugim wywołania TGZ.

Co robi IronZIP z hasłem, którego nie może użyć?

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

Ekstrakcja była pierwszym wywołaniem, które odrzuciło niewłaściwe hasło, z ArgumentException, którego wiadomość brzmi Invalid password!!

Dlaczego poprawne hasło zostało odrzucone?

Codex akceptuje obrazy przesyłane z -i (długą formą --image) na linii poleceń, codex exec resume włącznie, lub wklejone do kompozytora.

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

Wymienione hasło jest poprawne. Każda metoda otwierania tego archiwum z nim, konstruktor z ścieżki, bajtów lub strumienia i FromArchive, wyrzuciło System.Exception z Invalid Password!, podczas gdy ExtractArchiveToDirectory z tym samym hasłem zapisało kartę taryfową z dopasowanym skrótem. Archiwum zawiera pojedynczy wpis.

Jak debugować nieprawidłowe wyjście przyjęcia od początku do końca?

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

Poprawna diagnoza znajduje dwie przyczyny. Etapy zadania każdy przesyłek przypisuje pod hasłem z zachowanym tylko ostatnim rozszerzeniem, więc IronZIP nigdy nie widzi .tar.gz ani .tar.bz2. Zapisuje każdy zdekompresowany TAR jako jeden plik i nazywa każdy pojedynczy przesyłek nazwy po skrócie. Nic nie porównuje wyekstrahowanych plików z sumą kontrolną ani CRC, więc uszkodzony wpis ivy przechodzi jako ok.

Jak zmienić jedno-znaczne kody na komponenty do wielokrotnego wykorzystania i testowania?

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

Refactor, który usuwa tworzenie folderu lub sprawdzanie skrótu, nadal się buduje, więc prompt kończy się pełnym ponownym uruchomieniem w porównaniu z manifestem.

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

Potwierdzać na statusach i skrótach wyodrębnionych plików, nigdy na bajtach archiwum.

$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

Na 2026.10.2 lista odniesień do obiektu zawiera pięć statycznych wywołań, ExtractArchiveToDirectory na każdej klasie archiwum plus ExtractTGZArchiveToDirectory.

Jak ponownie wykorzystać te prompty na innym archiwum?

Te same prompty działają dla innego nadchodzącego zrzutu po zmianie ścieżek, zasad statusów i list kontrolnych sumy. Przewodnik po asystentach kodowania AI uruchamia test akceptacji, który rozpoczyna się od pustego folderu.

Co wyprodukowały zapytania w rzeczywistym uruchomieniu?

Wszystkie 14 promptów uruchomiło się, w kolejności, w jednym, nieprzerwanym sesji CLI Codex przez codex exec. Każda poniższa liczba pochodzi z własnych późniejszych kontroli, w tym kompilacji Release z 0 błędami i 0 ostrzeżeniami oraz ponownego haszowania w Pythonie niezależnie od IronZIP.

  • Pierwszy ekstraktor zgłosił 16 Wyodrębionych, 3 Chronionych i 6 Nieczytelnych, a 23 z 25 wierszy pasowało do manifestu.
  • Po wprowadzeniu promptu biletu, 24 z 25 wierszy zgodziło się.
  • Ostateczne zadanie zgłosiło 18 Wyodrębionych, 2 Chronione i 5 Nieczytelnych, a wszystkie 25 wierszy zgadzało się co do statusu i powodu.
  • Nowe haszowanie dopasowało wszystkie 314 plików z 18 Wyodrębnionych przesyłek z listami partnerów.
  • Nic nie pozostało na dysku dla pozostałych siedmiu przesyłek.
  • Ponowne uruchomienie ostatecznego zadania na kopii kodu zajęło 3,9 sekundy i zapisało identyczne bajty.
  • Wszystkie 5 testów przeszło z kluczem i wszystkie 5 nie przeszło w ponownym uruchomieniu bez niego.
  • Szybki start wylistował 2 z 8 przykładowych plików, z 18 wpisami i żadnym zaszyfrowanym oraz zarejestrował jedną ArgumentNullException i pięć ZipException dla reszty.
  • Inwentarz oznaczył dokładnie pięć przesyłek nazwanych powyżej.
  • Kopia agenta explorer różniła się od skryptu na 10 z 25 wierszy, dziewięć w formacie słowa i jeden z siedmioma z ośmiu początkowych bajtów.
  • Wymienianie napisało 310 wierszy wpisów dla 16 przesyłek ZIP i TAR, i 13 pasowało do liczb plików w manifeście.
  • Chroniony ZIP bez hasła, ZIP z jednym wpisem i przerwana przesyłka nie mogły zostać wymienione.
  • Po usunięciu klucza z procesu potomnego, 8 z 8 wywołań wyrzuciło wyjątek licencyjny.
  • Skanowanie hasła przeczytało 344 pliki wyjściowe i żadne nie pasowało.
  • Nocna diagnoza nazwała obie przyczyny i nie zmieniła żadnego kodu.
  • Powtórne uruchomienie nocnej pracy zarejestrowało te same 16 ok i 9 niepowodzeń, a pięć z 16 nie przeszło kontroli sum kontrolnych partnera.
  • Niektóre kroki uruchomiono inaczej niż na stronie. Codex napisał odniesienie do pakietu ręcznie jako IronZIP, więc dotnet lista pakietów działała od razu. Pierwszy ekstraktor już stworzył foldery TAR i umieścił GZIP TARY pod nazwą .tgz, więc wiersze, które się nie zgadzały, to delta-rates i grove-stock. Prompt formatu nie naprawił żadnego w trzech rundach, ponieważ jego próba przeszła IronTarArchive CSV, które IronBZip2Archive już rozpakował. Prompt biletu naprawił delta-rates, a refactor naprawił grove-stock. Prompt refaktoryzacji zapytał o zachowanie podstawy na nazwach dla BZIP2, co nazwa .tar.bz2 czyni zbędnym. Ostateczny plik wyników nazywa wywołanie IronTarArchive dla tego wiersza, które kod już nie wykonuje. IntakeJob.cs liczył 32 linie, ponieważ przepływ pracy przeniósł się do drugiego częściowego pliku o 382 liniach. Cztery agenty działały jako wątki zainicjowane bez typu agenta, więc nie zarejestrowano żadnej wbudowanej roli eksploratora ani pracownika.

Przewodnik Google Antigravity znalazł to samo niepowodzenie z hasłem dla jednokrotnego wpisu w usłudze pobierania i sprawdził archiwa przez ekstrakcję i SHA-256 zamiast tego. W przewodniku GitHub Copilot, pisarz TAR IronZIP przechowywał każdy log pod jego nazwą pliku, więc dzienniki o tej samej nazwie zderzały się. Wersja, model i czas Codex znajdują się w udostępnionej rejestrze uruchomienia.


Rozwiązywanie problemów


Pytania?

Jeśli są jakiekolwiek pytania, należy skontaktować się z support@ironsoftware.com

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 25,383Wersja:2026.11właśnie wydane