Como usar o IronZIP com ChatGPT Codex

Curtis Chau
Curtis Chau
Atualizado: 26 de outubro de 2026

Parceiros enviam seus arquivos noturnos em qualquer formato que seus próprios sistemas produzem. Uma remessa contém arquivos ZIP com e sem senhas, pacotes TAR e TGZ de hosts Linux, um pacote de ações BZIP2, um arquivo chamado .tar que é realmente um ZIP, e um upload que parou na metade. A entrada deve descompactar cada um, provar que cada arquivo chegou como o parceiro enviou e dizer quais uploads falharam e por quê.

ChatGPT Codex, o agente de codificação da OpenAI, roda no terminal, em editores, dentro do aplicativo desktop ChatGPT e como serviço em nuvem, e cada um deles aceita um login no ChatGPT. IronZIP é a biblioteca .NET da Iron Software para leitura e escrita de arquivos ZIP, TAR, GZIP e BZIP2.

Este guia dá ao Codex uma remessa de 25 uploads, um manifesto com o status que cada um deve receber e uma lista SHA-256 de cada parceiro. A maioria dos prompts pede ao Codex por um CSV que contém uma linha para cada arquivo, e todo o comportamento do IronZIP descrito abaixo foi medido na versão 2026.10.2.

Início Rápido
NuGetInstalar com NuGet

PM > Install-Package IronZip

Instale o IronZIP executando o comando acima no Console do Gerenciador de Pacotes NuGet, ou procure pelo pacote no Gerenciador de Pacotes NuGet.

Inicie o Codex do projeto de console .NET que contém a remessa e peça uma listagem primeiro.

$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


O que é ChatGPT Codex e como ele se encaixa no trabalho de arquivos .NET?

As páginas do CLI do Codex cobrem a instalação com npm install -g @openai/codex ou um instalador autônomo, e as páginas IDE cobrem os editores.

A orientação de segurança da OpenAI pede que você trate as sugestões do Codex como qualquer outro pull request, com verificação direcionada e uma revisão de diff. Um membro inventado falha na compilação, e um arquivo mal manejado aparece como um status que o manifesto contradiz.

Como você escreve um prompt IronZIP e configura o Codex para ele?

Um prompt de entrada nomeia o input, a regra de formato, as pastas de saída, a prova de checksum, a origem da senha e as pastas somente leitura. Qualquer parte deixada de fora se torna uma escolha que o agente faz por você.

Codex escaneia .agents/skills no diretório de trabalho e em cada pasta pai até a raiz do repositório. Skill.md do IronZIP, salvo como .agents/skills/IronZIP/SKILL.md, faz $ironzip ser resolvido. Seus exemplos fixam 2026.8.2, e não menciona nem o fracasso da pasta TAR nem a falha de senha de entrada única medidos abaixo.

Codex lê o AGENTS.md no início de cada execução, no máximo um arquivo por pasta no caminho da raiz do projeto até a pasta de trabalho. Arquivos mais próximos à pasta de trabalho substituem os anteriores. O índice llms.txt do IronZIP é a segunda fonte de 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

Como você pede ao Codex para adicionar IronZIP e verificar o pacote?

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 lista o pacote como IronZIP, e o código importa o namespace IronZip. Com .NET SDK 10.0.400, dotnet add package IronZip, o comando que a habilidade do IronZIP dá, escreveu a referência como IronZIP enquanto que ao restaurar foi gravado como IronZip, e dotnet list package então parou com Não foi possível ler uma referência de pacote. Adicionar o pacote como IronZIP manteve as duas grafias iguais. Sua única dependência, IronSoftware.Common 2026.4.2, adicionou mais 23 pacotes à restauração no .NET 9.

IronZIP não tem modo reduzido sem uma chave. Em uma sonda, toda chamada que abria, listava ou extraía um arquivo gerou uma LicensingException cuja mensagem lia Production License Required. Com IRONZIP_LICENSE_KEY definido, License.IsLicensed permaneceu falso até que o código atribuiu o valor a 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

A página de chaves de licença documenta a configuração IronZip.LicenseKey para appsettings.json, App.config e Web.config.

Como você determina o que um arquivo realmente é antes de extraí-lo?

IronZipArchive lê apenas arquivos ZIP. Dado um arquivo TAR, GZIP, BZIP2 ou de texto, ele gerou uma ZipException dizendo que não pôde encontrar o diretório central, e abrir um arquivo de 0 bytes deu EOF no cabeçalho. Os bytes iniciais identificam o formato. OpenAI documenta o agente explorador embutido para exploração de base de código voltada à leitura.

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

Cinco uploads devem ser sinalizados. Um é um ZIP nomeado .tar, outro um TGZ nomeado .zip, um arquivo de texto e bytes aleatórios que ambos carregam extensões de arquivo, e um está vazio.

Como você lista o que está dentro de cada arquivo?

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 fornece apenas os nomes de um TAR, enquanto Entries retorna um Entry com o nome de cada item, tamanho, CRC armazenado e flag IsCrypted. GZIP e BZIP2 não têm chamada de listagem. Entradas de pasta contam como entradas, e o arquivo kestrel-pod listou 252 delas para 250 arquivos.

Abrir um ZIP criptografado sem uma senha gerou ArgumentNullException, assim como passar uma senha para um ZIP que não tem. Em arquivos AES com mais de uma entrada, o construtor aceitou uma senha errada e Entries listou todos os arquivos, então uma listagem não pode distinguir uma boa senha de uma ruim.

Como você extrai cada arquivo e prova que os arquivos chegaram intactos?

OpenAI descreve o agente de trabalho incorporado como focado na execução, para implementação e correções. O exemplo de extração protegida ZIP mostra a sobrecarga de senha da chamada de extração estática.

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

A verificação de hash é necessária com IronZIP, porque a extração não compara uma entrada com seu CRC armazenado. Em ivy-orders, um byte invertido em uma entrada armazenada saiu sem exceção, e o valor Crc daquela entrada diferia do CRC do arquivo gravado no disco.

Uma extração GZIP de um ZIP, TAR ou arquivo de texto foi lançada e ainda escreveu um arquivo vazio com o nome do arquivo, e uma senha errada deixou uma pasta vazia, então o README pede limpeza. Extrair na mesma pasta uma segunda vez sobrescreveu os arquivos sem um aviso.

Por que um TAR com subpastas falha ao extrair?

IronTarArchive.ExtractArchiveToDirectory não cria pastas. Em cada TAR com entradas em subpastas, gerou DirectoryNotFoundException e não escreveu nada, independentemente de o TAR conter entradas de pastas ou não. Criar cada pasta a partir de GetArchiveEntryNames primeiro fez a mesma chamada ter sucesso.

Por que o mesmo arquivo GZIP é extraído de forma diferente com outro nome?

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 decide pelo nome do arquivo. Sob um nome terminando em .tgz ou .tar.gz, tanto ExtractArchiveToDirectory quanto ExtractTGZArchiveToDirectory descompactaram o TAR dentro. Sob qualquer outro nome, ambos escreveram um único arquivo descomprimido nomeado após o arquivo menos sua última extensão, então o TGZ nomeado .zip saiu como um único arquivo TAR. IronBZip2Archive descompactou um TAR apenas de um nome .tar.bz2, não de .tbz2. O exemplo de extração GZIP chama ExtractArchiveToDirectory em seu primeiro exemplo de código e a chamada TGZ em seu segundo.

O que IronZIP faz com uma senha que não pode usar?

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

A extração foi a primeira chamada a rejeitar a senha errada, com um ArgumentException cuja mensagem dizia Senha inválida!!.

Por que a senha correta é rejeitada?

Codex aceita imagens passadas com -i (forma longa --image) na linha de comando, codex exec resume incluído, ou coladas no compositor.

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

A senha listada está correta. Toda forma de abrir aquele arquivo com ela, o construtor de um caminho, bytes ou um fluxo e FromArchive, gerou System.Exception com Invalid Password! enquanto ExtractArchiveToDirectory com a mesma senha escreveu o cartão de taxas com um hash correspondente. O arquivo contém uma única entrada.

Como você depura a saída de entrada incorreta de ponta a ponta?

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

Um diagnóstico sólido encontra duas causas. As etapas do trabalho cada upload sob um nome com hash que mantém apenas a última extensão, então o IronZIP nunca vê .tar.gz ou .tar.bz2. Ele escreve cada TAR descompactado como um arquivo e nomeia cada upload de arquivo único após o hash. Nada compara os arquivos extraídos com um checksum ou um CRC, então a entrada danificada de hera passa como ok.

Como transformar código único em componentes reutilizáveis e testados?

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

Um refatoramento que omite a criação de pastas ou a verificação de hash ainda compila, então o prompt termina com uma nova execução completa contra o manifesto.

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

Afirme sobre status e hashes de arquivos extraídos, nunca sobre bytes de arquivo.

$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

Em 2026.10.2 a lista de referências de objeto cinco chamadas estáticas, ExtractArchiveToDirectory em cada classe de arquivo, mais ExtractTGZArchiveToDirectory.

Como você reutiliza esses prompts em outra remessa de arquivos?

Os mesmos prompts funcionam para outra remessa de entrada após seus caminhos, regras de status e listas de checksums mudarem. O guia de assistentes de codificação de IA executa um teste de aceitação que começa a partir de uma pasta vazia.

O que os prompts produziram em uma execução real?

Todos os 14 prompts foram executados, em ordem, em uma única sessão de CLI Codex não assistida através de codex exec. Cada figura abaixo vem de nossas próprias verificações posteriormente, entre elas uma compilação Release com 0 erros e 0 avisos e uma reorganização em Python independente do IronZIP.

  • O primeiro extrator relatou 16 Extraídos, 3 Protegidos e 6 Ilegíveis, e 23 de suas 25 linhas corresponderam ao manifesto.
  • Após o prompt do ticket, 24 de 25 linhas corresponderam.
  • O trabalho final relatou 18 Extraídos, 2 Protegidos e 5 Ilegíveis, e todas as 25 linhas corresponderam no status e na razão.
  • A reorganização combinou todos os 314 arquivos dos 18 uploads Extraídos contra as listas de parceiros.
  • Nada foi deixado no disco para os outros sete uploads.
  • A nova execução do trabalho final em uma cópia do código levou 3,9 segundos e escreveu bytes idênticos.
  • Todos os 5 testes passaram com a chave e todos os 5 falharam em nova execução sem ela.
  • O Quickstart listou 2 dos 8 arquivos de exemplo, com 18 entradas e nenhum criptografado, e registrou uma ArgumentNullException e cinco ZipExceptions para o restante.
  • O inventário sinalizou exatamente os cinco uploads acima mencionados.
  • A cópia do agente explorador diferiu do script em 10 de 25 linhas, nove na formatação de texto e uma com sete dos oito bytes de abertura.
  • A listagem escreveu 310 linhas de entrada para os 16 uploads ZIP e TAR, e 13 corresponderam às contagens de arquivos do manifesto.
  • O ZIP protegido sem senha, o ZIP de entrada única e o upload truncado não puderam ser listados.
  • Com a chave removida do processo filho, 8 de 8 chamadas geraram a exceção de licenciamento.
  • A varredura de senha leu 344 arquivos de saída e não combinou nenhum.
  • O diagnóstico noturno nomeou ambas as causas e não mudou nenhum código.
  • Uma reprodução do trabalho noturno registrou o mesmo 16 ok e 9 falhados, e cinco dos 16 falharam nos checksums dos parceiros.
  • Alguns passos foram executados de forma diferente da página. Codex escreveu a referência do pacote manualmente como IronZIP, então dotnet list package funcionou de imediato. O primeiro extrator já criou as pastas TAR e colocou TARs GZIP sob um nome .tgz, então as linhas que discordavam eram delta-rates e grove-stock. O prompt de formato não corrigiu nenhum dos dois em três rodadas, porque sua sonda passou IronTarArquivo um CSV que IronBZip2Arquivo já tinha descompactado. O prompt do ticket corrigiu delta-rates e o refatoramento corrigiu grove-stock. O prompt de refatoramento pediu para manter a preparação baseada em nomes para BZIP2, o que um nome .tar.bz2 torna desnecessário. O arquivo de resultados finais nomeia uma chamada IronTarArchive para essa linha que o código não faz mais. IntakeJob.cs chegou a 32 linhas porque o fluxo de trabalho se moveu para um segundo arquivo parcial de 382 linhas. Os quatro agentes foram executados como threads gerados sem tipo de agente, portanto, nenhum agente explorador ou função de trabalhador integrado foi registrado.

O guia de antidensidade do Google encontrou o mesmo erro de senha de entrada única em um serviço de download e verificou arquivos por extração e SHA-256 em vez disso. No guia do GitHub Copilot, o gravador de TAR do IronZIP armazenou cada log com seu nome de arquivo básico, então logs com o mesmo nome colidiram. A versão, o modelo e o tempo do Codex estão no registro de execução compartilhado.


Solução de problemas


Questões?

Se você tiver dúvidas, entre em contato com support@ironsoftware.com

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

Leia Mais

Pronto para começar?

Downloads no NuGet 25,383Versão:2026.11recém-lançado