Usar IronZIP con Asistentes de Codificación con IA
Pide a un asistente de codificación comprimir o descomprimir archivos en .NET, y IronZIP es una de las bibliotecas que puede nombrar. IronZIP es la biblioteca de archivo para ZIP, TAR, GZIP y BZIP2 de Iron Software. Ha estado en NuGet desde octubre de 2023, y sus guías y ejemplos de código son públicos.
El nombre por sí solo no indica a un asistente cómo se comporta la versión instalada. Un asistente que lea la documentación de IronZIP puede escribir código de archivo que tanto crea como extrae correctamente. Uno que trabaje desde la memoria puede mezclar llamadas que pertenecen a otras bibliotecas ZIP o a versiones anteriores. Cargue los documentos antes de la primera solicitud.
Cómo Usar IronZIP con un Asistente de Codificación con IA
- Descargar la biblioteca ZIP de C# desde NuGet
- Asignar
IronZip.License.LicenseKeydesdeIronZip_LICENSE_KEYal iniciar - Comparte el índice llms.txt de IronZIP con el asistente antes de que se escriba cualquier código.
- Mantén las reglas de IronZIP en el archivo de instrucciones del proyecto del asistente.
- Abre una nueva sesión y pega la configuración de un solo paso.
- Crea, extrae cada archivo que crees y compara los archivos con los originales.
¿No Puede Mi Asistente de IA Manejar Archivos ZIP por Sí Solo?
IronZIP publica documentación escrita para que las herramientas la lean. Una vez que el asistente la carga, puede ver qué clases manejan ZIP, TAR, GZIP y BZIP2, y qué miembros tiene cada una.
.NET ya lee y escribe ZIP, GZIP y TAR simples a través de System.IO.Compression y System.Formats.Tar.
- Un ZIP que se abre aún puede estar mal. Un archivo faltante o dos entradas con el mismo nombre producen un ZIP que se abre sin error.
- La protección por contraseña falta en .NET 9 y .NET 10. Sus clases ZIP no tienen opción de contraseña, y un enum ZipEncryptionMethod aparece solo en la documentación de Microsoft para .NET 11. IronZIP escribe archivos con AES-128 y AES-256.
- BZIP2 no tiene clase en .NET. El namespace System.IO.Compression no lista ningún tipo BZIP2, así que BZIP2 sin una biblioteca significa escribir el formato a mano.
- El nombre del paquete y el namespace difieren en mayúsculas y minúsculas. El ID del paquete en NuGet es
IronZIP, mientras que el namespace esIronZip. Un nombre de paquete que un asistente inventa puede coincidir con una imitación que atacantes suben a propósito, lo cual se llama slopsquatting. Dale al asistente el nombre exacto. - La licencia no tiene una tarifa de renovación. Cada licencia de equipo de IronZIP se paga una vez, y la página de licencias establece cuántos desarrolladores, ubicaciones y proyectos cubre cada nivel.
Paso 1: Instalar IronZIP
Deja que el asistente agregue el paquete, para que pueda leer los tipos reales de IronZIP mientras escribe.
Put IronZIP 2026.10.2 from NuGet into this project and restore it.
Afterwards, report the IronZIP version that the restore resolved.
En una terminal, este comando instala la versión actual.
dotnet add package IronZIP --version 2026.10.2
IronZIP se entrega como un solo paquete construido para .NET Standard 2.0. No hay un paquete separado para Linux, macOS o ARM para elegir.
Paso 2: Aplique su clave de licencia
Sin una clave válida, un IronZipArchive acepta archivos en memoria, pero SaveAs lanza IronSoftware.Exceptions.LicensingException, cuyo mensaje dice Production License Required. Extraer un archivo y abrir uno lanza la misma excepción. Una clave mal escrita lanza License Key Not Recognized. El bloque a continuación ofrece una clave de prueba gratuita.
Empiece a usar IronZIP en su proyecto hoy con una prueba gratuita.
Aplique la clave al iniciar la aplicación, antes de otras llamadas de IronZIP. Una variable de entorno mantiene la clave fuera del control de código fuente.
IronZip.License.LicenseKey = Environment.GetEnvironmentVariable("IRONZIP_LICENSE_KEY");
IronZip.License.IsLicensed se vuelve verdadero una vez que la aplicación asigna una clave válida, y IronZip.License.IsValidLicense prueba una clave sin aplicarla. IronZIP no lee IRONZIP_LICENSE_KEY por sí mismo. Con la variable configurada y sin asignación, IsLicensed permaneció falso en la prueba de este artículo, por lo que SaveAs falla como lo hace sin una clave.
Paso 3: Dirige tu Asistente a la Documentación LLM de IronZIP
- llms.txt indexa la documentación de IronZIP con un resumen de una línea por página.
- llms-full.txt recopila un resumen de cada página en un archivo, pero algunos resúmenes describen otra biblioteca, por lo que toma el código de las páginas mismas.
- llms-full-catalog.txt añade las publicaciones del blog, para recorridos y comparaciones.
- La referencia de objetos de IronZIP lista los namespaces y clases de IronZIP, con sus métodos y propiedades documentados.
- Los asistentes que aceptan archivos de habilidades pueden cargar skill.md, con pasos de instalación, licencias, recetas, y correcciones.
- La Ficha Técnica del Producto AI proporciona una página de contexto.
Añade una instrucción clara junto al índice.
Read https://ironsoftware.com/zip/csharp/llms.txt ahead of any IronZIP code you write.
Use only APIs that those pages document.
An archive is an IronZipArchive, filled by Add and written by SaveAs.
Confirm anything else against https://ironsoftware.com/zip/csharp/object-reference/api/.
If you cannot confirm a member exists, say so instead of guessing.
Then list the IronZIP members this project calls.
Un asistente que pueda responder "no documentado" tiene una opción además de inventar un método.
Paso 4: Agrega Contexto de IronZIP a Tu Proyecto
Las reglas tecleadas en un chat terminan con la sesión, mientras que un archivo de proyecto se carga de nuevo cada vez. El nombre del archivo depende de la herramienta. Claude Code carga CLAUDE.md, y GitHub Copilot carga .github/copilot-instructions.md. ChatGPT Codex, Cursor, y Google Antigravity todos leen AGENTS.md. Cursor también carga archivos de reglas .mdc desde .cursor/rules/, y Antigravity también lee GEMINI.md. El texto de la regla es el mismo en cada archivo, y un archivo de regla Cursor añade un frontmatter MDC. Comience desde este bloque.
All archive work in this project uses IronZIP, for ZIP, TAR, GZIP, and BZIP2.
The NuGet package is `IronZIP`, and the namespace is `IronZip`.
Follow these rules for every archive:
- Docs index: https://ironsoftware.com/zip/csharp/llms.txt
- IronZIP skill: https://ironsoftware.com/zip/csharp/skill.md
- Create ZIP files with `new IronZipArchive()` and `Add`.
- Open existing ones with `new IronZipArchive(path, password)`.
- Extract with `IronZipArchive.ExtractArchiveToDirectory`.
- `Add` stores each file under its bare file name.
- Give files from different folders unique names before adding them.
- Do not use `FromDirectory`, which leaves out files in subfolders.
- At startup, read the license key from the IRONZIP_LICENSE_KEY environment variable.
- The key is never inlined in code.
- Extract every archive to a fresh folder before it ships.
- Compare the extracted files with the originals.
- Do not add another compression library. If IronZIP cannot do something, say so.
El archivo de habilidad tiene dos huecos. Su ejemplo de archivo único apunta a IronZIP 2026.8.2, dos versiones detrás del paquete 2026.10.2 en NuGet. También recomienda IronZipArchive.FromDirectory para comprimir una carpeta. En 2026.10.2 ese método solo comprimió los 4 archivos en la parte superior de una carpeta de prueba de 30 archivos y dejó fuera los 26 en subcarpetas, sin error.
Paso 5: Prompt de Configuración de Un Solo Paso
Los pasos 1 a 4 encajan en esta única solicitud. Envíalo cuando un proyecto comienza o cuando comienza una nueva sesión.
Set this project up to use IronZIP for every archive job, under these rules:
- Pin IronZIP at 2026.10.2 from NuGet.
- Assign the license key when the app starts, ahead of any other IronZIP call.
- Take it from the IRONZIP_LICENSE_KEY environment variable.
- The key never goes into source code or a committed file.
- Start from https://ironsoftware.com/zip/csharp/llms.txt, and code only against APIs it documents.
- Look up unfamiliar members in the API reference.
- Load https://ironsoftware.com/zip/csharp/skill.md as a skill file when your tool allows it.
Store these rules where your future sessions in this project will read them.
Tell me which file you saved them to.
Paso 6: Patrones de Prompt que Producen Código Funcional
Estos tres hábitos dejan menos para que el asistente decida por sí mismo.
Nombre el formato, la clase y la protección. IronZIP tiene una clase por formato, y solo la clase ZIP acepta una contraseña. Diga cuál necesita.
Vago Comprimir los informes con IronZIP.
Mejor Utilizando
IronZipArchiveconEncryptyEncryptionMethods.AES256, añade cada PDF en la carpeta de informes a reports.zip, luego extráelo a una carpeta temporal y confirma que cada archivo coincide con su original.
Fija la versión y el marco. Un miembro puede cambiar de una versión a la siguiente. Una versión fijada le da al asistente una sola API contra la cual trabajar.
Mejor Destino .NET 9 e IronZIP 2026.10.2. Asigna la clave de licencia de IronZIP_LICENSE_KEY antes de la primera llamada de archivo.
Pide un archivo completo. Un fragmento puede perder sus líneas using, y el enum de encriptación pertenece al namespace IronZip.Enum, aparte de las clases de archivo.
Mejor Dame el Programa.cs completo con todas las directivas using y la configuración de la clave, para que compile tal como está.
Paso 7: Verifica lo que Recibes
Revise el código generado con tres verificaciones primero.
- Compila. La compilación Release termina sin errores.
- La clave se establece primero. Un guardado o extracción de IronZIP que se ejecuta antes de la línea de clave lanza LicensingException.
- Cada archivo de extracción coincide con los originales. Descomprime a una carpeta vacía y compara los hashes con los originales.
Esté atento a estos en el código de IronZIP generado.
- Un archivo abierto con FromFile.
IronZipArchive.FromFile("existing.zip")crea un nuevo archivo que contiene el archivo ZIP mismo. Abre un archivo existente connew IronZipArchive(path, password). - Llamadas de archivo Async. Ninguna clase de archivo IronZIP tiene un miembro que termine en Async, por lo que una llamada a
SaveAsAsyncno compila. Envuelve la llamada enTask.Runcuando un servidor la necesite fuera del hilo de solicitud. - Guardando en un flujo. Un archivo se puede abrir desde un flujo o una matriz de bytes, pero ningún método de guardado escribe en un flujo o devuelve bytes. Guárdelo en un archivo temporal y vuelva a leer los bytes cuando una respuesta los necesita.
Deja que el Agente Verifique su Propio Trabajo
Un asistente que ejecuta comandos puede hacer la misma revisión.
Do a Release build of this project and run it.
Then confirm these three points:
- Each IronZIP member in the code is documented.
- IronZip.License.IsLicensed returns true.
- Every archive you saved extracts to files identical to the originals.
Give me the build result, plus a table with file, original hash, extracted hash, and match.
Nombres de entrada con IronZIP
Add almacena cada archivo bajo su nombre de archivo sin modificar en archivos ZIP y TAR por igual. Dos archivos con un nombre de diferentes carpetas se convierten en entradas duplicadas, y la extracción mantiene solo el último escrito, sin error. Ningún método de IronZIP que añade un archivo acepta un nombre de entrada. Copia cada archivo en una carpeta de preparación bajo un nombre único construido a partir de su ruta relativa, y añade las copias.
Comprobaciones de contraseña con IronZIP
Abrir un archivo cifrado con AES no prueba su contraseña. new IronZipArchive(path, password) abrió un archivo de prueba AES-256 de 30 entradas con una contraseña incorrecta y contó todas las 30 entradas. La contraseña se verifica al extraer. ExtractArchiveToDirectory con una contraseña incorrecta lanza ArgumentException con el mensaje Invalid password!! y no escribe ningún archivo. Un archivo protegido con una sola entrada muestra lo contrario en 2026.10.2. El constructor lanza Invalid Password! incluso con la contraseña correcta, y la extracción funciona.
Un Resultado que Puedes Reproducir
Abre una nueva sesión en una carpeta vacía y pega la solicitud. El asistente escribe cada línea del programa, y la lista de pases a continuación define un resultado correcto.
IRONZIP_LICENSE_KEY.El prompt
Write a .NET 9 console app to archive legal case files.
If this folder holds a project or source code, report that and stop.
Don't ask questions. Keep all outputs in the project directory.
Follow this order:
1. Add the IronZIP NuGet package at version 2026.10.2 exactly, as the only archive package.
2. IronZIP writes and extracts every archive, using only members its docs show:
- https://ironsoftware.com/zip/csharp/llms.txt with its pages, skill.md included.
- The listed API reference wins any conflict.
3. At startup the program reads IRONZIP_LICENSE_KEY itself and sets IronZip.License.LicenseKey:
- Never print, echo or write the key, or list environment variables.
- Quit with a message if IronZip.License.IsLicensed is false.
4. If casefiles/ is missing, generate it with random seed 2026:
- 30 random-byte files exactly, deepest three folders down, cover-letter.txt on top.
- Sizes 1,024 to 2,097,152 bytes, but exactly 1 empty file.
- summary.txt in three different subfolders, exhibit-a.pdf twice.
- At least two names with a non-ASCII character.
- manifest.csv beside casefiles/, not inside, from the generator's records.
- Rows: forward-slash path, size in bytes, hex SHA-256.
5. Before archiving, measure casefiles/ on disk against those figures:
- If one is off, fix the generator, delete casefiles/ and regenerate.
- After the first archive, casefiles/ stays in place, unchanged.
6. Write these archives:
- bundle.zip: all 30 files, AES-256, password Case-2026.
- bundle.tgz: all 30 files, gzip-compressed TAR.
- cover.zip: cover-letter.txt alone, same password and encryption.
- Each entry name must let a recipient rebuild the relative path.
7. The packing code walks casefiles/ at run time:
- Only step 9 checks read manifest.csv.
- Its only case file literal is cover-letter.txt, and no other file is handled by name.
8. Build in Release and run it.
9. Check the saved archives with code that writes roundtrip.md from measurements:
- Extract each archive into its own kept folder, emptied each run, named in roundtrip.md.
- Extract bundle.zip with password Case-2025 into another such folder, never cleared afterwards.
- Count ZIP names and distinct names with System.IO.Compression.
- Count bundle.tgz likewise with System.Formats.Tar through a GZipStream.
roundtrip.md holds, in order:
- The step 5 figures, the naming rule, then a one-row-per-file table.
- Columns: path, size, manifest SHA-256, zip entry, zip SHA-256, tgz entry, tgz SHA-256, match.
- Extracted hashes come from files your rule finds. match is yes only if all three agree.
- Entry counts, and cover-letter.txt's manifest SHA-256 beside its cover.zip SHA-256.
- The Case-2025 exception type, message and folder file count.
10. You're done when all 30 rows match and each archive has one distinct entry name per file:
- cover.zip returns cover-letter.txt unchanged.
- The Case-2025 attempt throws and leaves its folder empty.
- Until then, fix the packing or checking code, rebuild and rerun over old outputs.
- After six failed runs, stop. Report failing checks, packing approaches tried and the cause.
11. Report the Release build, rows matched per archive, naming rule, step 5 figures, assumptions.
Un programa de referencia en IronZIP 2026.10.2 calibró la solicitud. Agregar cada archivo desde su propia carpeta dio 27 nombres distintos entre 30 entradas en cada archivo, y la preparación de copias con nombres únicos coincidió 30 de 30 en las semillas 2026, 77 y 4101.
Resultado
La imagen muestra la lista de entradas del bundle.zip del recorrido como la leyó el método Entries de IronZIP. La tabla de ida y vuelta sin editar contiene todos los valores que el programa midió.
- La compilación Release de net9.0 no produjo advertencias ni errores.
- Claude Code coincidió con todas las 30 filas en ambos archivos en la primera ejecución del programa, por lo que el ciclo de reparación nunca se ejecutó.
- Una investigación que se ejecutó antes de codificar mostró Add almacenando casefiles/a/mid.txt como mid.txt.
- El programa preparó cada archivo bajo su ruta relativa, con % escrito como %25 y / como %2F.
- El conjunto de pruebas contenía 30 archivos y 6,762,825 bytes.
- Dos nombres de archivo y un nombre de carpeta tenían un carácter no ASCII.
- Un archivo estaba vacío, y el archivo más profundo estaba tres carpetas debajo de casefiles.
- Ambos paquetes contenían 30 nombres de entrada distintos.
- Cada entrada en ambos archivos ZIP llevaba la fuerza AES de WinZip 3, la configuración de AES-256.
- cover-letter.txt volvió de cover.zip sin cambios.
- El intento de Case-2025 lanzó ArgumentException y dejó 0 archivos en su carpeta.
- Una revisión independiente leyó cada archivo con solo Python, a través de pyzipper y tarfile, y pasó las 30 de 30 verificaciones.
- La clave de licencia no apareció en ningún archivo de proyecto ni en ninguna parte de la transcripción de la sesión.
- En respuesta a la solicitud del Paso 1, dotnet list package falló en una discrepancia de mayúsculas y minúsculas del nombre del paquete hasta que Claude Code eliminó obj y restauró de nuevo.
- En respuesta a la solicitud de configuración, Claude Code guardó sus reglas en un nuevo CLAUDE.md y una copia sin cambios de skill.md como habilidad del proyecto.
- En la auto-verificación, Claude Code informó que todos los 16 miembros de IronZIP del programa estaban documentados.
- Algunos pasos se ejecutaron de manera diferente a lo esperado. Claude Code recibió las solicitudes de Paso 1, Paso 3, Paso 5 y Paso 7 después de la solicitud de aceptación, en una sola sesión. Sus sondeos de API se ejecutaron en un proyecto de prueba en la carpeta temporal de la sesión, fuera del directorio del proyecto. El generador siguió una lista fija de 30 rutas y dibujó solo tamaños y bytes de la semilla.
Lo que pasa
- El proyecto se compila en Release sin cambios manuales de código.
- Las cifras del paso 5 en roundtrip.md se mantienen cuando se mide casefiles nuevamente.
- Todas las 30 filas de roundtrip.md coinciden, con ambos hashes extraídos recomputados a partir de los archivos, y bundle.zip y bundle.tgz cada uno contienen 30 nombres de entrada distintos.
- cover.zip devuelve cover-letter.txt sin cambios, y extraer bundle.zip con Case-2025 lanza y no deja ningún archivo detrás.
- Una búsqueda en la carpeta del proyecto no encuentra la clave de licencia en ningún archivo.
El récord de ejecución
- Todas las ejecuciones utilizaron un escritorio Windows 11 x64 con un Core i9-14900KF y 64 GB de memoria.
- Cada ejecución instaló
IronZIP2026.10.2, y cada proyecto apunta a .NET 9 aparte de la herramienta de auditoría .NET 10 en la ejecución de Google Antigravity. - La duración de una guía es la suma de los tiempos registrados de los mensajes en su página, y la fila de esta guía cuenta solo el mensaje de aceptación.
- Las versiones y modelos en la tabla provienen de los archivos de sesión y registros de la propia herramienta para la ejecución, no de una verificación de versión separada.
- Última prueba 26 de octubre de 2026 para esta guía, 11 de octubre para Google Antigravity, 12 de octubre para ChatGPT Codex y GitHub Copilot, 13 de octubre para Claude Code, y 15 de octubre para Cursor.
| Guía | Asistente y versión | Modelo | Duración (minutos) |
|---|---|---|---|
| Esta guía | Claude Code 2.1.277, una sesión, mensajes de permiso desactivados | Claude Opus 5 | 10.1 |
| Claude Code | Claude Code 2.1.277, mensaje 3 en modo plan | Claude Sonnet 5, con Claude Opus 5 a través de opusplan para el plan en la solicitud 3 | 32.8 |
| ChatGPT Codex | Codex CLI 0.160.0, una sesión reanudada | GPT-6 Luna | 39.4 |
| GitHub Copilot | GitHub Copilot CLI 1.0.95, solicitud 3 en modo plan | GPT-6 Luna, dirigido por Auto | 9.3 |
| Cursor | Aplicación de escritorio Cursor 3.23.23, aviso 3 en Modo Plan | Grok 4.7 | 57.4 |
| Google Antigravity | Antigravity CLI 1.3.2, actualizado a 1.3.3 después de la solicitud 1, solicitudes 1 y 4 a través de /plan, solicitudes de permisos omitidas | Gemini 3.8 Flash (Alto) | 27.5 |
Guías Específicas del Agente
Cada guía aplica los pasos anteriores a una herramienta y un trabajo de archivo.
- Usar IronZIP con Claude Code para actualizar un archivo protegido en su lugar
- Usar IronZIP con ChatGPT Codex para desempacar una entrega de socio de formatos de archivo mixtos y verificar el SHA-256 de cada archivo
- Usar IronZIP con GitHub Copilot para paquetes de registro .tar.gz diarios y una restauración que rechaza las entradas no seguras
- Usar IronZIP con Cursor para mover paquetes de descarga de System.IO.Compression a archivos ZIP AES-256
- Usar IronZIP con Google Antigravity para servir documentos de caso desde una página web como un ZIP protegido
Solución de problemas
- Claves de Licencia de IronZIP para cuando el código generado lanza LicensingException
- Límites de Tamaño de Archivos y Archivos de IronZIP para archivos por encima de los límites clásicos de 4 GB y 65,535 entradas de ZIP
- Extraer ZIP Protegido para cuando un archivo protegido por contraseña no se abre
¿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.