Cómo usar IronZIP con ChatGPT Codex
Los socios envían sus archivos nocturnos en cualquier formato que produzcan sus propios sistemas. Una gota contiene archivos ZIP con y sin contraseñas, paquetes TAR y TGZ de hosts de Linux, un paquete de acciones BZIP2, un archivo llamado .tar que realmente es un ZIP, y una carga que se detuvo a mitad de camino. La entrada tiene que desempaquetar cada uno, demostrar que cada archivo llegó tal como lo envió el socio, y decir qué cargas fallaron y por qué.
ChatGPT Codex, el agente de codificación de OpenAI, se ejecuta en la terminal, en editores, dentro de la aplicación de escritorio de ChatGPT y como un servicio en la nube, y cada uno de estos acepta un inicio de sesión de ChatGPT. IronZIP es la biblioteca .NET de Iron Software para leer y escribir archivos ZIP, TAR, GZIP y BZIP2.
Esta guía le da a Codex una entrega de 25 cargas, un manifiesto con el estado que cada uno debería obtener, y una lista SHA-256 de cada socio. La mayoría de los prompts solicitan a Codex un CSV que contiene una fila para cada archivo, y cada comportamiento de IronZIP descrito a continuación se midió en la versión 2026.10.2.
Inicio rápidoLanza Codex desde el proyecto de consola .NET que contiene la entrega, y pide una lista primero.
$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.
Flujo de trabajo mínimo (5 pasos)
- Agrega el paquete NuGet de IronZIP al proyecto
- Guarda la habilidad de IronZIP como .agents/skills/ironzip/SKILL.md para que la mención
$ironzipse resuelva. - Elige la clase IronZIP a partir de los bytes principales de cada archivo, nunca desde su extensión.
- Hashea cada archivo extraído contra la lista de sumas de verificación del remitente.
- Compara el CSV de resultados con tus estados esperados y verifica cada miembro que Codex llamó en la referencia de API
¿Qué es ChatGPT Codex y cómo se integra en el trabajo con archivos de .NET?
Las páginas de Codex CLI cubren la instalación con npm install -g @openai/codex o un instalador independiente, y las páginas del IDE cubren los editores.
La guía de seguridad de OpenAI te pide tratar las sugerencias de Codex como cualquier otra solicitud de extracción, con verificación dirigida y una revisión de diferencias. Un miembro inventado falla en la compilación, y un archivo mal manejado aparece como un estado que el manifiesto contradice.
¿Cómo escribes un prompt de IronZIP y configuras Codex para él?
Un prompt de entrada nombra la entrada, la regla de formato, las carpetas de salida, la prueba de suma de verificación, la fuente de la contraseña y las carpetas de sólo lectura. Cualquier parte omitida se convierte en una opción que el agente toma por ti.
Codex escanea .agents/skills en el directorio de trabajo y en cada carpeta principal hasta la raíz del repositorio. El skill.md de IronZIP, guardado como .agents/skills/IronZIP/SKILL.md, hace que $ironzip se resuelva. Sus ejemplos fijan 2026.8.2, y no menciona ni la falla de carpeta TAR ni la falla de contraseña de una sola entrada medidas a continuación.
Codex lee AGENTS.md al inicio de cada ejecución, como máximo un archivo por carpeta en el camino desde la raíz del proyecto hasta la carpeta de trabajo. Los archivos más cercanos a la carpeta de trabajo anulan los anteriores. El índice llms.txt de IronZIP es la segunda fuente 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.
¿Cómo pides a Codex que añada IronZIP y verifique el paquete?
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 lista el paquete como IronZIP, y el código importa el espacio de nombres IronZip. Con .NET SDK 10.0.400, dotnet add package IronZip, el comando que la habilidad de IronZIP da, escribió la referencia como IronZIP mientras que la restauración registró IronZip, y dotnet list package se detuvo entonces con Unable to read a package reference. Añadir el paquete como IronZIP mantuvo ambas ortografías iguales. Su única dependencia, IronSoftware.Common 2026.4.2, agregó 23 paquetes más a la restauración en .NET 9.
IronZIP no tiene modo reducido sin una clave. En una prueba, cada llamada que abrió, listó o extrajo un archivo lanzó una LicensingException cuyo mensaje decía Production License Required. Con IRONZIP_LICENSE_KEY definido, License.IsLicensed se mantuvo falso hasta que el código asignó el 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.
La página de claves de licencia documenta la configuración IronZip.LicenseKey para appsettings.json, App.config y Web.config.
¿Cómo sabes qué es realmente un archivo antes de extraerlo?
IronZipArchive solo lee archivos ZIP. Dado un archivo TAR, GZIP, BZIP2 o de texto, lanzó una ZipException diciendo que no pudo encontrar el directorio central, y abrir un archivo de 0 bytes dio EOF en el encabezado. Los bytes principales identifican el formato. OpenAI documenta el agente explorador incorporado para la exploración de código con muchas lecturas.
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.
Cinco cargas deberían ser marcadas. Uno es un ZIP llamado .tar, otro un TGZ llamado .zip, uno es un archivo de texto y unos bytes aleatorios que ambos tienen extensiones de archivo, y uno está vacío.
¿Cómo enumeras lo que está dentro de cada archivo?
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 da sólo los nombres de un TAR, mientras que Entries devuelve un Entry con el nombre de cada ítem, tamaño, CRC almacenado y la bandera IsCrypted. GZIP y BZIP2 no tienen llamada de listado. Las entradas de carpeta cuentan como entradas, y el archivo kestrel-pod listó 252 de ellas para 250 archivos.
Abrir un archivo ZIP encriptado sin una contraseña lanzó ArgumentNullException, y lo mismo al pasar una contraseña para un ZIP que no la tiene. En archivos AES con más de una entrada, el constructor aceptó una contraseña incorrecta y Entries listó cada archivo, por lo que un listado no puede distinguir una buena contraseña de una mala.
¿Cómo extraes cada archivo y pruebas que los archivos llegaron intactos?
OpenAI describe al agente de trabajo incorporado como enfocado en la ejecución, para implementación y correcciones. El ejemplo de extracción de ZIP protegido muestra la sobrecarga de contraseña de la llamada de extracción 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.
Con IronZIP, la verificación de hash es necesaria, ya que la extracción no compara una entrada con su CRC almacenado. En ivy-orders, un byte volteado en una entrada almacenada salió sin una excepción, y el valor de Crc de esa entrada difería del CRC del archivo escrito en el disco.
Una extracción GZIP de un ZIP, TAR o archivo de texto lanzó y aún escribió un archivo vacío bajo el nombre del archivo, y una contraseña incorrecta dejó una carpeta vacía, por lo que el README pide limpieza. Extraer en la misma carpeta una segunda vez sobreescribió los archivos sin advertencia.
¿Por qué un TAR con subcarpetas no se extrae?
IronTarArchive.ExtractArchiveToDirectory no crea carpetas. En cada TAR con entradas en subcarpetas lanzó DirectoryNotFoundException y no escribió nada, ya sea que el TAR tuviera entradas de carpetas o no. Crear cada carpeta desde GetArchiveEntryNames primero hizo que la misma llamada tuviera éxito.
¿Por qué el mismo archivo GZIP se extrae de manera diferente bajo otro nombre?
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 decide por el nombre del archivo. Bajo un nombre que termina en .tgz o .tar.gz, tanto ExtractArchiveToDirectory como ExtractTGZArchiveToDirectory desempacaron el TAR dentro. Bajo cualquier otro nombre, ambos escribieron un archivo descomprimido llamado según el archivo menos su última extensión, por lo que el TGZ llamado .zip salió como un solo archivo TAR. IronBZip2Archive desempacó un TAR solo de un nombre .tar.bz2, no de .tbz2. El ejemplo de extracción de GZIP llama a ExtractArchiveToDirectory en su primer ejemplo de código y a la llamada TGZ en su segundo.
¿Qué hace IronZIP con una contraseña que no puede 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.
La extracción fue la primera llamada en rechazar la contraseña incorrecta, con una ArgumentException cuyo mensaje dice Invalid password!!
¿Por qué se rechaza la contraseña correcta?
Codex acepta imágenes pasadas con -i (forma larga --image) en la línea de comandos, codex exec resume incluida, o pegadas en el 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.
La contraseña listada es correcta. Cada forma de abrir ese archivo con ella, el constructor desde una ruta, bytes o un flujo y FromArchive, lanzó System.Exception con Invalid Password!, mientras que ExtractArchiveToDirectory con la misma contraseña escribió la tarjeta de tarifas con un hash coincidente. El archivo contiene una sola entrada.
¿Cómo depurar la salida de entrada incorrecta de principio a fin?
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.
Un diagnóstico fiable encuentra dos causas. Las etapas del trabajo cada carga bajo un nombre con hash que mantiene solo la última extensión, por lo que IronZIP nunca ve .tar.gz o .tar.bz2. Escribe cada TAR descomprimido como un archivo y nombra cada carga de un solo archivo después del hash. Nada compara los archivos extraídos con una suma de verificación o un CRC, por lo que la entrada de ivy dañada pasa como ok.
¿Cómo convierte el código único en componentes reutilizables y probados?
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.
Un refactor que elimina la creación de carpetas o la verificación de hash sigue compilándose, por lo que el prompt termina con una reejecución completa contra el manifiesto.
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.
Asegura sobre estados y sumas de archivos extraídos, nunca sobre bytes de archivos.
$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.
En 2026.10.2, la referencia de objetos lista cinco llamadas estáticas, ExtractArchiveToDirectory en cada clase de archivo más ExtractTGZArchiveToDirectory.
¿Cómo reutilizas estos prompts en otra entrega de archivos?
Los mismos prompts funcionan para otra entrega entrante después de que sus rutas, reglas de estado y listas de sumas de verificación cambien. La guía de asistentes de codificación AI ejecuta una prueba de aceptación que comienza desde una carpeta vacía.
¿Qué produjeron los prompts en una ejecución real?
Los 14 prompts se ejecutaron, en orden, en una sola sesión de CLI de Codex desatendida a través de codex exec. Cada figura a continuación proviene de nuestros propios controles después, entre ellos una compilación Release con 0 errores y 0 advertencias y un rehash de Python independiente de IronZIP.
- El primer extractor reportó 16 Extraídos, 3 Protegidos y 6 Ilegibles, y 23 de sus 25 filas coincidieron con el manifiesto.
- Después del prompt de ticket, 24 de las 25 filas coincidieron.
- El trabajo final reportó 18 Extraídos, 2 Protegidos y 5 Ilegibles, y todas las 25 filas coincidieron en estado y razón.
- El rehash coincidió con los 314 archivos de las 18 cargas Extraídas contra las listas de socios.
- Nada quedó en el disco para las otras siete cargas.
- Una reejecución del trabajo final en una copia del código tomó 3.9 segundos y escribió bytes idénticos.
- Las 5 pruebas se aprobaron con la clave, y todas las 5 fallaron en una reejecución sin ella.
- El inicio rápido listó 2 de los 8 archivos de muestra, con 18 entradas y ninguna encriptada, y registró una ArgumentNullException y cinco ZipExceptions para el resto.
- El inventario marcó exactamente las cinco cargas nombradas arriba.
- La copia del agente explorador difería del script en 10 de 25 filas, nueve en la redacción del formato y una con siete de los ocho bytes de apertura.
- El listado escribió 310 filas de entrada para las 16 cargas ZIP y TAR, y 13 coincidieron con los conteos de archivos del manifiesto.
- El ZIP protegido sin contraseña, el ZIP de una sola entrada y la carga truncada no se pudieron listar.
- Con la clave eliminada del proceso hijo, 8 de 8 llamadas lanzaron la excepción de licencia.
- El escaneo de contraseña leyó 344 archivos de salida y no coincidió ninguno.
- El diagnóstico nocturno nombró ambas causas y no cambió ningún código.
- La repetición del trabajo nocturno registró los mismos 16 ok y 9 fallidos, y cinco de los 16 fallaron las sumas de verificación del socio.
- Algunos pasos se ejecutaron de manera diferente a lo esperado. Codex escribió la referencia del paquete a mano como IronZIP, por lo que dotnet list package funcionó de inmediato. El primer extractor ya creó las carpetas TAR y colocó los GZIP TARs bajo un nombre .tgz, por lo que las filas que no coincidieron fueron delta-rates y grove-stock. El prompt de formato no arregló ninguno en tres rondas, porque su prueba pasó a IronTarArchive un CSV que IronBZip2Archive ya había desempaquetado. El prompt de ticket arregló delta-rates y el refactor arregló grove-stock. El prompt de refactor pidió mantener la colocación basada en el nombre para BZIP2, lo cual un nombre .tar.bz2 hace innecesario. El archivo de resultados final nombra una llamada de IronTarArchive para esa fila que el código ya no hace. IntakeJob.cs llegó a 32 líneas porque el flujo de trabajo se movió a un segundo archivo parcial de 382 líneas. Los cuatro agentes se ejecutaron como hilos generados sin tipo de agente, por lo que no se registró ningún explorador o función de trabajador incorporado.
La guía de Google Antigravity encontró el mismo fallo de contraseña de entrada única en un servicio de descarga y verificó archivos mediante extracción y SHA-256 en su lugar. En la guía de GitHub Copilot, el escritor TAR de IronZIP almacenó cada registro con su nombre de archivo base, por lo que colisionaron registros con mismos nombres. La versión, el modelo y el tiempo de Codex están en el registro compartido de ejecución.
Solución de problemas
- Extraer TAR cuando un TAR con subcarpetas lanza DirectoryNotFoundException
- Extraer GZIP cuando un TGZ sale como un solo archivo
- Extraer ZIP Protegido cuando se rechaza la contraseña correcta
- Claves de Licencia de IronZIP cuando cada llamada lanza un error de licencia
¿Preguntas?
Si tienes alguna pregunta, contacta a support@ironsoftware.com
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.