Cómo usar IronZIP con Google Antigravity

Curtis Chau
Curtis Chau
Actualizado: 26 de octubre de 2026

Una página que entrega a los clientes sus documentos de caso como un ZIP protegido con contraseña puede compilarse limpiamente y aún así enviar un archivo con archivos faltantes, una página de error para un caso ordinario, o un documento de un caso diferente.

El comando /browser de Google Antigravity inicia un subagente del navegador Chrome que puede manejar la página en ejecución, por lo que un aviso puede escribir una contraseña, presionar Descargar para cada caso de prueba y mantener una captura de pantalla de cada resultado. IronZIP construye el archivo en el servidor con cifrado AES-256 y lo extrae de nuevo, para que la página pueda demostrar que cada documento regresó byte por byte. Esta guía construye esa página de descarga en una aplicación ASP.NET Core MVC, comenzando desde el ejemplo de protección con contraseña de IronZIP, y lo verifica contra cinco casos cuyos documentos y hashes SHA-256 se conocen de antemano.

Inicio rápido
NuGetInstalar con NuGet

PM > Install-Package IronZip

Instale IronZIP ejecutando el comando arriba en la Consola del Administrador de Paquetes NuGet, o busque el paquete en el Administrador de Paquetes NuGet.

Abre la carpeta CaseDocs en Antigravity y describe la página de descarga.

/plan CaseDocs is an ASP.NET Core MVC project that targets .NET 9.
Add the case document download that docs/case-download-rules.md describes.

The download works like this:

- A user opens /Cases/{id}, ticks documents and types a password.
- The user receives an AES-256 encrypted ZIP that the server builds with IronZIP.
- The NuGet package is IronZIP version 2026.10.2, and its namespace is IronZip.

Program.cs reads IRONZIP_LICENSE_KEY and assigns it once to IronZip.License.LicenseKey.
Confirm only that the variable exists and how many characters it holds.
Never print, log or write its value.

The Implementation Plan must state these answers:

- the entry name each document receives inside the archive
- the path the archive is saved to before the response, and when that file is deleted
- how the saved archive is compared with the ticked documents

Stop once dotnet build succeeds, and tell me the build result.
Text

Lee esas tres respuestas antes de que cambie el código. Cada una cubre una manera en que el archivo puede fallar sin un error del compilador. En agy -p sin interfaz gráfica, nadie aprueba el plan, así que lee el plan Artefacto junto al código que describe.

Nombra la variable en el aviso y nunca pegue el valor. Todo lo que se escriba en la conversación puede llegar a un archivo fuente, un commit o una transcripción de terminal. IronZIP también acepta una entrada IronZip.LicenseKey en appsettings.json, y un commit incluye ese archivo con todo lo demás. Cada ubicación compatible está en la guía de claves de licencia.



¿Qué debes revisar antes de aceptar los cambios?

Revisa de dónde viene cada nombre de entrada, la carpeta donde se guarda cada archivo, la línea que lo elimina y el código que lee el archivo de vuelta. Luego confirma cada miembro de IronZIP en la diferencia contra la referencia de API.

Antigravity guarda capturas de pantalla como artefactos de imagen que aceptan comentarios. Cuando una muestra una página de error o una cuenta de documentos incorrecta, comenta esa captura de pantalla en lugar de escribir un nuevo aviso sobre ello.

¿Cómo pruebas cada descarga en un navegador real?

Pide una tabla de resultados que solo descargas reales pueden completar.

/browser Start CaseDocs in the background with dotnet run --launch-profile http.
That profile listens on http://localhost:5065.

For each row of TestData/expected.csv, do this:

1. Open /Cases/<case> and leave every checkbox as the page sets it.
2. Type the row's password and press Download.
3. Capture a screenshot of what follows.
4. When the answer is a file, take its name and size from the download or the response headers.

In the Walkthrough and in your reply, give one line per row with these parts:

- the case
- the documents the page listed, against the documents column
- the expected outcome
- what actually happened, as the file name and size or the message shown
- a PASS or FAIL verdict

For any failing row, cite the server log entry or error page text responsible.
Do that before you edit any code.
After every fix, restart the app and go through all six rows again.
Stop the app when you are done.
Text

Una corrección en los nombres de entrada cambia cada archivo, incluso para casos que ya pasaron, por lo que el aviso vuelve a ejecutar todas las seis filas.

Por favor, tenga en cuenta: Abre la captura de pantalla para el caso de un documento primero. Una página que pasa los otros casos aún puede devolver una página de error allí.

¿Qué causa descargas incompletas o fallidas?

En nuestra calibración, el código del ejemplo de protección con contraseña se movió a una acción de descarga. Cambiaron a AES-256 y contaron las entradas del archivo guardado abriéndolo con el constructor. Chrome sin interfaz gráfica luego presionó Descargar para cada caso con IronZIP 2026.10.2. Cada fallo a continuación compiló sin advertencia.

Qué pasóCausaQué preguntar
El caso de seis documentos se descargó, pero al extraerlo dio 3 archivosIronZIP nombra cada entrada después del archivo solo, así que dos letter.pdf, dos scan.jpg y dos summary.pdf compartieron nombresLos nombres de entrada se construyeron a partir de la ruta relativa, con copias guardadas bajo esos nombres
El caso de un documento devolvió una página de errorLa lectura con el constructor lanzó "¡Contraseña Inválida!" con la contraseña correctaUna lectura que extrae el archivo
El caso vacío devolvió una página de errorGuardar un archivo sin entradas lanzó "¡El archivo existente está roto!"Una comprobación de selección antes de que se ejecute IronZIP
Un valor del checkbox editado a ../C-1001/ledger.csv puso el archivo de otro caso en la descargaLa acción confiaba en las rutas publicadasCada ruta publicada resolvía y se mantenía dentro de la carpeta del caso
Cuatro archivos ZIP se quedaron en la carpeta temporalIronZIP guarda solo a una ruta, y nada eliminó el archivoUna carpeta por solicitud, eliminada cuando la solicitud termina

La verificación de conteo de entradas pasó para el caso de seis documentos, porque el archivo contenía seis entradas.

¿Cómo configuras un proyecto en el que Antigravity pueda trabajar?

El agente necesita una app que ya se construye y responde en localhost. dotnet new mvc --framework net9.0 te da una, y ejecutarla una vez muestra el puerto en Properties/launchSettings.json. El puerto difiere de proyecto a proyecto, y los avisos de /browser deben nombrarlo. La lista de permitidos del navegador contiene solo localhost al principio, por lo que mantén la dirección en la forma http://localhost:<port>.

Commit las carpetas de casos bajo CaseFiles, las reglas en docs/case-download-rules.md, TestData/expected.csv con el resultado para cada caso y contraseña, y TestData/manifest.csv con el nombre de entrada, tamaño y SHA-256 de cada documento. Los cinco casos de prueba contenían cinco documentos simples, seis documentos con tres nombres repetidos a través de subcarpetas, una instrucción única, tres documentos con nombres acentuados y japoneses, y ningún documento en absoluto. Luego haz que el agente audite el paquete y la clave.

Which IronZIP version does CaseDocs.csproj reference? Quote its PackageReference line.
Then show the line in Program.cs that assigns the license key.
Add either line if it is missing.

IRONZIP_LICENSE_KEY is the only allowed source of that key.
Search these files for an IronZip.LicenseKey entry or a key value, and remove any you find:

- appsettings.json
- appsettings.Development.json
- Properties/launchSettings.json

When the variable is missing at startup, the app logs a single warning.
That warning mentions IRONZIP_LICENSE_KEY and contains no value.
Add it only if it is absent, and leave every other file alone.
Tell me what you found and what you changed.
Text

Repite ese número de versión siempre que un aviso posterior agregue un proyecto o un paquete, para que cada proyecto se construya contra la misma versión de IronZIP. Un agente que escribe el nombre de un paquete de memoria puede instalar un paquete malicioso publicado bajo un nombre imaginado, un ataque llamado slopsquatting. El paquete es IronZIP y el namespace es IronZip.

Con la variable establecida y License.LicenseKey nunca asignada, la página de calibración falló en la llamada de guardado para los cuatro casos de archivo. Cada uno lanzó una LicensingException leyendo "Licencia de Producción Requerida". IronZIP no leyó IRONZIP_LICENSE_KEY por sí mismo, por lo que la app tiene que asignar IronZip.License.LicenseKey por sí misma. Para los documentos de la agente de IronZIP y una prueba de aceptación de un solo aviso, ve la guía de asistentes de codificación AI.

¿Cómo debe el servicio pasar documentos a IronZIP?

Add, AddArchiveEntry y FromFiles todos dejaron caer la carpeta en una sonda, incluso desde una ruta relativa como 2025/letter.pdf, y la extracción mantuvo la última de dos entradas con el mismo nombre. Agregar una ruta de carpeta lanzó UnauthorizedAccessException. Por lo tanto, el servicio copia cada documento en una carpeta temporal bajo el nombre que las reglas le dan y agrega las copias.

El fallo del constructor cubre cualquier manera de abrir un archivo AES-256 de una entrada, ya que los sobrecargos del stream, byte array y FromArchive lanzaron la misma System.Exception. Con dos o más entradas AES-256, el constructor las listó incluso con una contraseña incorrecta, mientras que un archivo Tradicional lanzó ZipException en el constructor. La extracción devolvió el archivo de una entrada intacto y lanzó ArgumentException con "¡Contraseña inválida!" para cada contraseña incorrecta, vacía o faltante.

El nivel de compresión ZIP no hizo diferencia en IronZIP 2026.10.2. Los niveles 0, 1, 6 y 9 produjeron el mismo archivo de 970,545 bytes a partir de 1,042,684 bytes de documentos de sonda, y cada construcción tomó de 119 a 121 ms.

/plan Draft the Implementation Plan for this change, and wait for review before you edit anything.
Move every IronZIP call out of the controller into Services/CaseArchiveBuilder.cs.
Register it in DI as a singleton.
Given the case folder, the ticked relative paths and the password, it returns the ZIP bytes.

The service works in this order:

1. It copies each document into a new folder under the system temp path.
2. Each copy gets the entry name from the rules.
3. It adds those copies and saves the archive beside that folder.
4. It extracts that archive with the same password into a second folder.
5. It compares the SHA-256 of every extracted file with its source.
6. On any difference, it throws with the document's entry name.

Both folders are removed in a finally block.
The controller keeps the password, selection and path checks.
Afterward, repeat the /browser pass over TestData/expected.csv and report each row.
Text

Compara el servicio del agente con este. Se construye contra IronZIP 2026.10.2, y devolvió los cuatro archivos intactos y no dejó ninguna carpeta temporal atrás.

using System.Security.Cryptography;
using IronZip;
using IronZip.Enum;

public sealed class CaseArchiveBuilder
{
    public byte[] Build(string caseFolder, IReadOnlyList<string> relativePaths, string password)
    {
        var work = Path.Combine(Path.GetTempPath(), "case-" + Guid.NewGuid().ToString("N"));
        var staged = Path.Combine(work, "staged");
        var check = Path.Combine(work, "check");
        Directory.CreateDirectory(staged);
        try
        {
            var sources = new Dictionary<string, string>();
            foreach (var relativePath in relativePaths)
            {
                var entryName = relativePath.Replace('/', '_');
                var source = Path.Combine(caseFolder, relativePath);
                File.Copy(source, Path.Combine(staged, entryName));
                sources.Add(entryName, source);
            }

            var zipPath = Path.Combine(work, "case.zip");
            using (var archive = new IronZipArchive())
            {
                archive.Encrypt(password, EncryptionMethods.AES256);
                foreach (var entryName in sources.Keys)
                    archive.Add(Path.Combine(staged, entryName));
                archive.SaveAs(zipPath);
            }

            IronZipArchive.ExtractArchiveToDirectory(zipPath, check, password);
            if (Directory.GetFiles(check).Length != sources.Count)
                throw new InvalidOperationException("The archive does not hold one entry per document.");
            foreach (var (entryName, source) in sources)
            {
                var extracted = Path.Combine(check, entryName);
                if (!File.Exists(extracted) ||
                    !SHA256.HashData(File.ReadAllBytes(extracted)).SequenceEqual(SHA256.HashData(File.ReadAllBytes(source))))
                    throw new InvalidOperationException($"{entryName} did not come back from the archive intact.");
            }
            return File.ReadAllBytes(zipPath);
        }
        finally
        {
            Directory.Delete(work, recursive: true);
        }
    }
}
C#

¿Cómo demuestras que cada archivo contiene los archivos correctos?

/goal corre hasta que se cumple su objetivo y no se detiene para pedir confirmación en el camino.

/goal Every archive the download page produces matches TestData/manifest.csv.

Create a console project at tools/ArchiveAudit that meets these conditions:

- It references IronZIP 2026.10.2.
- The web project's compile items exclude it.
- Its startup copies IRONZIP_LICENSE_KEY into IronZip.License.LicenseKey.

Start CaseDocs with dotnet run --launch-profile http before the first post.
Stop it once the audit passes.

For each expected.csv row with the outcome zip, the audit does this:

1. Post that case page's form with every document ticked and the row's password.
2. Store the response as audit-output/<case>.zip.
3. Extract it with IronZipArchive.ExtractArchiveToDirectory and the password.
4. Confirm that the entry names and SHA-256 values equal that case's manifest rows.

Confirm too that extraction with a wrong password throws.
Keep fixing the app and rerunning the audit until all four archives pass.
Then put the results table in the Walkthrough and in your reply.
Text

El propio lector de .NET no puede hacer esta comprobación. System.IO.Compression listó los nombres de entrada de los archivos de calibración AES-256 pero lanzó InvalidDataException, "método de compresión no soportado", para el contenido de todas las 15 entradas, por lo que una prueba construida sobre él puede contar entradas sin leer nunca un byte.

¿Cómo aplicas las reglas de descarga a tareas posteriores?

Según la documentación de reglas de Antigravity, las reglas vienen de AGENTS.md, GEMINI.md y los archivos .agents/rules/*.md en cada carpeta desde el archivo editado hasta la raíz del espacio de trabajo. Los archivos en .agents/rules deben abrirse con YAML frontmatter nombrando un trigger válido, y un disparador faltante o no reconocido hace que Antigravity descarte la regla sin un mensaje. Con model_decision, solo la ruta y descripción de la regla entra en el aviso, y el agente carga el texto completo cuando su tarea se ajusta a la descripción.

/learn convierte correcciones de la sesión en una regla o una habilidad. La página de comandos de barra diagonal dice que puede escribir AGENTS.md, GEMINI.md o un archivo en .agents/rules, así que nombra la ruta de la regla en el aviso.

/learn Turn what this session established about case downloads into a rule.
Write it at .agents/rules/case-archives.md.
Start the file with YAML frontmatter that sets trigger: model_decision.
Add a description saying the rule applies to work on case downloads or IronZIP archives.

The rule covers these points:

- how entry names are formed, and why
- how the saved archive is verified
- which temporary folders each request creates, and when they are deleted
- the messages for a short password and an empty selection
- that no change to the download is finished until two checks succeed

Those two checks are the expected.csv browser pass and the tools/ArchiveAudit run.
Record only what this session verified, and list anything unproven as open.
Text

Luego, lee las primeras líneas del archivo y confirma que el frontmatter deletrea el disparador model_decision, en snake case.

¿Cuándo deberías enviar más de un agente?

Dale las pruebas automatizadas a un agente y la evidencia del navegador a un segundo.

Split this work between Agent A and Agent B.

Agent A creates CaseDocs.Tests, an xUnit project that references IronZIP 2026.10.2.
Keep it outside the web project's build.
The tests work like this:

- They start the app with WebApplicationFactory<Program>.
- They post the download form for every expected.csv row and assert the outcome.
- For zip rows, they extract the response with IronZIP into a temporary folder.
- They compare the names and SHA-256 values with manifest.csv.
- One test shows that a path outside the case folder gets a 400 response.
- They assert on extracted files, never on archive bytes.

Agent B starts once Agent A's suite passes:

1. Start the app with dotnet run --launch-profile http (http://localhost:5065).
2. Use /browser to download C-1002 and C-1003 from their case pages, and record each session.
3. Read each file's name and size from what the browser receives or from the response headers.
4. Stop the app.
5. Add the two recordings and one screenshot per finished page to the Walkthrough.

If there is no Walkthrough, save them under audit-output/ instead.
List them with those names and sizes in your reply.
If Agent A's suite does not pass, report the failing tests instead.
Text

Las pruebas que publican el formulario a través de WebApplicationFactory no necesitan navegador ni puerto abierto, por lo que detectan un nombre de entrada roto en segundos.

Por favor, tenga en cuenta: En la aplicación de escritorio, el Agente A y el Agente B pueden ejecutarse como agentes en segundo plano separados. Confía en las grabaciones del Agente B solo si la suite del Agente A pasó primero en el mismo commit.

¿Qué produjeron los prompts en una ejecución real?

Los siete avisos se ejecutaron en una conversación CLI de Antigravity, en orden, sin nadie en el teclado, en una nueva aplicación .NET 9 MVC que contenía los cinco casos, las reglas y ambos archivos CSV. Las cifras a continuación provienen de nuestras propias construcciones Release, descargas de Chrome sin interfaz gráfica y extracción de IronZIP, no de las respuestas del agente.

  • Después del aviso 01 y en la aplicación final, el código coincidió todas las seis filas expected.csv en el pase del navegador independiente y respondió la ruta editada con un 400.
  • En ambos puntos, la extracción de IronZIP de cada descarga devolvió los nombres y valores SHA-256 del manifiesto para 5 de 5, 6 de 6, 1 de 1 y 3 de 3 documentos.
  • En ambos puntos, la extracción con una contraseña incorrecta lanzó "¡Contraseña inválida!".
  • Los archivos finales llegaron a 979,949, 779,422, 3,637 y 154,332 bytes, los mismos tamaños que produce el servicio anterior.
  • El pase de descarga final no dejó ningún archivo CaseDocs en la carpeta temporal.
  • Las construcciones Release de la aplicación, la herramienta de auditoría y el proyecto de prueba reportaron 0 advertencias y 0 errores.
  • La suite xUnit pasó 7 de 7 en 2 segundos.
  • Antes de que escribiera la lectura, el aviso 01 probó IronZIP en un proyecto consola de prueba y alcanzó el fallo de una entrada.
  • El controlador de aviso 01 abrió el archivo con el constructor solo cuando más de un documento estaba marcado.
  • Para un único documento, ese controlador listó la entrada con System.IO.Compression.
  • El aviso 04 reemplazó esa comprobación con extracción y una comparación SHA-256.
  • La auditoría /goal pasó en su primer intento sin nada que arreglar.
  • /learn escribió una regla de 68 líneas con el disparador model_decision.
  • En el aviso 03 el agente probó la advertencia de clave faltante con un powershell -Command anidado cuyas comillas dobles expandieron IRONZIP_LICENSE_KEY.
  • El mensaje de error resultante llevó el valor de la clave al modelo y a los archivos de transcripción de Antigravity bajo .gemini/antigravity-cli, mientras que ningún archivo del repositorio lo contenía.
  • Algunos pasos se ejecutaron de manera diferente a lo esperado. El subagente /browser no pudo conectarse a Chrome en la máquina de prueba ("Could not find DevToolsActivePort"), así que el agente manejó Chrome sin interfaz gráfica con su propio script Playwright para cada pase de navegador, las capturas de pantalla y ambas grabaciones. Su respuesta aún acreditó al subagente del navegador. Los avisos 01, 04 y 06 cada uno dijeron que estaban esperando revisión y luego editaron en el mismo turno. La CLI mantuvo un plan y un Walkthrough para toda la conversación, y los avisos posteriores sobrescribieron ambos, así que solo las respuestas mantuvieron las tablas anteriores. La regla /learn indicó una causa tomada de descompilar IronZIP y nombró System.IO.Compression como una forma de extraer estos archivos. Un agente hizo ambas mitades del aviso de dos agentes en un solo turno de la misma conversación. La herramienta de auditoría está destinada a .NET 10. Cada aviso de permiso se omitió.

La guía de Codex ChatGPT divide un trabajo de toma de archivos entre agentes explorador y trabajador, y su ejecución generó cuatro hilos de agente. La guía de Claude Code planea una actualización en su lugar de archivos de casos cifrados en modo plan, como lo hacen los avisos /plan aquí. El registro de ejecución del hub ofrece la versión de Antigravity, el modelo, duraciones de aviso y la máquina de prueba.


Solución de problemas


¿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.

Leer más

¿Listo para empezar?

Descargas de NuGet 25,383Versión:2026.11recién lanzado