Usando IronZIP com Assistentes de Codificação de IA
Peça a um assistente de codificação para compactar ou descompactar arquivos em .NET, e IronZIP é uma das bibliotecas que ele pode citar. IronZIP é a biblioteca de arquivos da Iron Software para ZIP, TAR, GZIP e BZIP2. Está no NuGet desde outubro de 2023, e seus guias e exemplos de código são públicos.
O nome sozinho não informa a um assistente como a versão instalada se comporta. Um assistente que lê a documentação do IronZIP pode escrever código de arquivo que cria e extrai corretamente. Um que trabalha a partir da memória pode misturar chamadas que pertencem a outras bibliotecas ZIP ou a lançamentos mais antigos. Carregue os documentos antes da primeira solicitação.
Como Usar IronZIP com um Assistente de Codificação de IA
- Baixar a biblioteca C# ZIP do NuGet
- Atribua
IronZip.License.LicenseKeya partir deIronZip_LICENSE_KEYna inicialização - Compartilhe o índice llms.txt do IronZIP com o assistente antes de qualquer código ser escrito
- Mantenha as regras do IronZIP no arquivo de instruções do projeto do assistente
- Abra uma nova sessão e cole o prompt de configuração de uma vez
- Construa, extraia todos os arquivos que criar e compare os arquivos com os originais
Meu Assistente de IA Não Pode Lidar com Arquivos ZIP Sozinho?
IronZIP publica documentação escrita para ferramentas lerem. Uma vez que o assistente a carrega, ele pode ver quais classes lidam com ZIP, TAR, GZIP e BZIP2 e quais membros cada uma possui.
.NET já lê e escreve ZIP simples, GZIP e TAR através de System.IO.Compression e System.Formats.Tar.
- Um ZIP que abre ainda pode estar errado. Um arquivo ausente ou duas entradas com o mesmo nome produzem um ZIP que abre sem erro.
- A proteção por senha está ausente no .NET 9 e no .NET 10. Suas classes ZIP não têm opção de senha, e um enum ZipEncryptionMethod aparece apenas na documentação da Microsoft para o .NET 11. IronZIP escreve arquivos AES-128 e AES-256.
- BZIP2 não tem classe no .NET. O namespace System.IO.Compression não lista nenhum tipo BZIP2, então BZIP2 sem uma biblioteca significa escrever o formato à mão.
- O nome do pacote e o namespace diferem em caixa. O ID do pacote no NuGet é
IronZIP, enquanto o namespace éIronZip. Um nome de pacote que um assistente inventa pode corresponder a uma imitação que atacantes carregam de propósito, chamada de slopsquatting. Dê ao assistente o nome exato. - A licença não tem taxa de renovação. Cada licença de equipe do IronZIP é paga uma vez, e a página de licenciamento define quantos desenvolvedores, locais e projetos cada nível cobre.
Etapa 1: Instalar IronZIP
Deixe o assistente adicionar o pacote, para que ele possa ler os tipos reais do IronZIP enquanto escreve.
Put IronZIP 2026.10.2 from NuGet into this project and restore it.
Afterwards, report the IronZIP version that the restore resolved.
Em um terminal, este comando instala o lançamento atual.
dotnet add package IronZIP --version 2026.10.2
IronZIP é distribuído como um pacote construído para .NET Standard 2.0. Não há pacote separado para Linux, macOS ou ARM para escolher.
Passo 2: Aplique sua chave de licença
Sem uma chave válida, um IronZipArchive aceita arquivos na memória, mas SaveAs lança IronSoftware.Exceptions.LicensingException, cuja mensagem lê Produção de Licença Requerida. Extrair um arquivo e abrir um lança a mesma exceção. Uma chave digitada incorretamente lança Chave de Licença Não Reconhecida. O bloco abaixo oferece uma chave de teste gratuita.
Comece a usar IronZIP em seu projeto hoje com uma avaliação gratuita.
Aplique a chave na inicialização do aplicativo, antes de outras chamadas ao IronZIP. Uma variável de ambiente mantém a chave fora do controle de origem.
IronZip.License.LicenseKey = Environment.GetEnvironmentVariable("IRONZIP_LICENSE_KEY");
IronZip.License.IsLicensed se torna verdadeiro assim que a aplicação atribui uma chave válida, e IronZip.License.IsValidLicense testa uma chave sem aplicá-la. IronZIP não lê IRONZIP_LICENSE_KEY por si mesmo. Com a variável definida e sem atribuição, IsLicensed ficou falso na pesquisa deste artigo, então SaveAs falha como se não houvesse uma chave.
Etapa 3: Aponte Seu Assistente para a Documentação LLM do IronZIP
- llms.txt indexa a documentação do IronZIP com um resumo de uma linha por página.
- llms-full.txt reúne um resumo de cada página em um arquivo, mas alguns resumos descrevem outra biblioteca, então pegue código das próprias páginas.
- llms-full-catalog.txt adiciona os posts de blog, para tutoriais e comparações.
- A referência de objeto IronZIP lista os namespaces e classes do IronZIP, com seus métodos e propriedades documentadas.
- Assistentes que aceitam arquivos de habilidade podem carregar skill.md, com as etapas de instalação, licenciamento, receitas, e correções.
- O Fato do Produto com IA fornece uma página de antecedentes.
Adicione uma instrução clara ao lado do í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.
Um assistente permitido a responder "não documentado" tem uma opção além de inventar um método.
Etapa 4: Adicione Contexto do IronZIP ao Seu Projeto
Regras digitadas em um chat terminam com a sessão, enquanto um arquivo de projeto carrega novamente toda vez. O nome do arquivo depende da ferramenta. Claude Code carrega CLAUDE.md, e GitHub Copilot carrega .github/copilot-instructions.md. ChatGPT Codex, Cursor, e Google Antigravity todos leem AGENTS.md. Cursor também carrega arquivos de regra .mdc de .cursor/rules/, e Antigravity também lê GEMINI.md. O texto da regra é o mesmo em todos os arquivos, e um arquivo de regra Cursor adiciona frontmatter MDC. Comece com este bloco.
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.
O arquivo de habilidade tem duas lacunas. Seu exemplo de arquivo único fixa IronZIP 2026.8.2, duas versões atrás do pacote 2026.10.2 no NuGet. Ele também recomenda IronZipArchive.FromDirectory para compactar uma pasta. Em 2026.10.2, esse método compactou apenas os 4 arquivos no topo de uma pasta de teste com 30 arquivos e deixou de fora os 26 em subpastas, sem erro.
Passo 5: Prompt de Configuração Única
As etapas 1 a 4 cabem neste único prompt. Envie-o quando um projeto começa ou quando uma nova sessão inicia.
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.
Passo 6: Padrões de Prompt que Produzem Código Funcional
Esses três hábitos deixam menos para o assistente decidir por conta própria.
Nomeie o formato, a classe e a proteção. IronZIP tem uma classe por formato, e apenas a classe ZIP aceita uma senha. Diga qual você precisa.
Vago Compacte os relatórios com IronZIP.
Melhor Usando
IronZipArchivecomEncrypteEncryptionMethods.AES256, adicione cada PDF na pasta de relatórios a reports.zip, então extraia-o para uma pasta temporária e confirme se cada arquivo corresponde ao original.
Fixe a versão e o framework. Um membro pode mudar de um lançamento para o próximo. Uma versão fixada dá ao assistente uma API para trabalhar.
Melhor Alvo .NET 9 e IronZIP 2026.10.2. Atribua a chave de licença de IronZIP_LICENSE_KEY antes da primeira chamada de arquivo.
Peça por um arquivo completo. Um trecho pode perder suas linhas using, e o enum de criptografia pertence ao namespace IronZip.Enum, além das classes de arquivo.
Melhor Dê-me o Program.cs completo com todas as diretivas using e a configuração da chave, para que compile como está.
Passo 7: Verifique o Que Você Obtém de Volta
Revise código gerado com três verificações primeiro.
- Gera com sucesso. A compilação Release termina sem erros.
- A chave é definida primeiro. Um salvamento ou extração IronZIP que executa antes da linha de chave lança LicensingException.
- Cada arquivo assim gera arquivos idênticos. Extraia para uma pasta vazia e compare os hashes com os originais.
Observe estes em código IronZIP gerado.
- Um arquivo aberto com FromFile.
IronZipArchive.FromFile("existing.zip")gera um novo arquivo que contém o próprio arquivo ZIP. Abra um arquivo existente comnew IronZipArchive(path, password). - Chamadas de arquivo assíncronas. Nenhuma classe de arquivo IronZIP possui um membro que termina em Async, então uma chamada para
SaveAsAsyncnão compila. Envolva a chamada emTask.Runquando um servidor precisar fora do thread de solicitação. - Salvando em um fluxo. Um arquivo pode ser aberto a partir de um fluxo ou uma matriz de bytes, mas nenhum método de salvamento escreve para um fluxo ou retorna bytes. Salve em um arquivo temporário e leia os bytes de volta quando uma resposta precisar deles.
Deixe o Agente Verificar Seu Próprio Trabalho
Um assistente que executa comandos pode fazer a mesma revisão.
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.
Nomes de entrada com IronZIP
Add armazena cada arquivo sob seu nome de arquivo base em arquivos ZIP e TAR igualmente. Dois arquivos com um nome de pastas diferentes se tornam entradas duplicadas, e a extração mantém apenas o último gravado, sem erro. Nenhum método IronZIP que adiciona um arquivo aceita um nome de entrada. Copie cada arquivo para uma pasta temporária sob um nome único construído a partir de seu caminho relativo e adicione as cópias.
Verificações de senha com IronZIP
Abrir um arquivo criptografado com AES não testa sua senha. new IronZipArchive(path, password) abriu um arquivo de teste AES-256 com 30 entradas com uma senha errada e contou todas as 30 entradas. A senha é verificada na extração. ExtractArchiveToDirectory com uma senha errada lança ArgumentException com a mensagem Senha inválida!! e não escreve arquivo algum. Um arquivo protegido com uma única entrada mostra o reverso em 2026.10.2. O construtor lança Senha Inválida! mesmo com a senha correta, e a extração funciona.
Um Resultado Que Você Pode Reproduzir
Abra uma sessão nova em uma pasta vazia e cole o prompt. O assistente escreve cada linha do programa, e a lista de passes abaixo define um resultado correto.
IRONZIP_LICENSE_KEY.O 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.
Um programa de referência em IronZIP 2026.10.2 calibrado para o prompt. Adicionar cada arquivo de sua própria pasta deu 27 nomes distintos entre 30 entradas em cada arquivo, e a preparação de cópias nomeadas exclusivamente igualou 30 de 30 em sementes 2026, 77, e 4101.
Saída
A imagem mostra a lista de entradas do bundle.zip da execução conforme o método Entries de IronZIP a lê. A tabela de ida e volta não editada contém todos os valores que o programa mediu.
- A compilação Release do net9.0 não produziu avisos e nem erros.
- Claude Code combinou todas as 30 linhas em ambos arquivos na primeira execução do programa, então o loop de reparação nunca executou.
- Uma investigação realizada antes de codificar mostrou Add armazenando casefiles/a/mid.txt como mid.txt.
- O programa preparou cada arquivo sob seu caminho relativo, com % escrito como %25 e / como %2F.
- O conjunto de testes continha 30 arquivos e 6.762.825 bytes.
- Dois nomes de arquivos e um nome de pasta carregavam um caractere não-ASCII.
- Um arquivo estava vazio, e o arquivo mais profundo estava três pastas abaixo de casefiles.
- Ambos os bundles continham 30 nomes de entrada distintos.
- Cada entrada em ambos os arquivos ZIP carregava força WinZip AES 3, a configuração AES-256.
- cover-letter.txt voltou de cover.zip inalterado.
- A tentativa Case-2025 lançou ArgumentException e deixou 0 arquivos em sua pasta.
- Uma verificação independente leu cada arquivo com apenas Python, através de pyzipper e tarfile, e passou em 30 de 30 verificações.
- A chave de licença não apareceu em nenhum arquivo de projeto e em nenhum lugar na transcrição da sessão.
- Em resposta ao prompt da Etapa 1, dotnet list package falhou por uma incompatibilidade de nome do pacote até que Claude Code deletou obj e restaurou novamente.
- Em resposta ao prompt de configuração, Claude Code salvou suas regras em um novo CLAUDE.md e uma cópia inalterada de skill.md como uma habilidade de projeto.
- Na auto-verificação, Claude Code reportou todos os 16 membros do IronZIP do programa como documentados.
- Alguns passos foram executados de forma diferente da página. Claude Code recebeu os prompts da Etapa 1, Etapa 3, Etapa 5, e Etapa 7 após o prompt de aceitação, em uma sessão. Seus testes de API foram realizados em um projeto de rascunho na pasta temporária da sessão, fora do diretório do projeto. O gerador seguiu uma lista fixa de 30 caminhos e retirou apenas tamanhos e bytes da semente.
O que passa
- O projeto compila em Release sem alterações manuais no código.
- Os números da Etapa 5 em roundtrip.md mantêm-se quando o casefiles é medido novamente.
- Todas as 30 linhas de roundtrip.md combinam, com ambos os hashes extraídos recomputados dos arquivos, e bundle.zip e bundle.tgz cada um contém 30 nomes de entrada distintos.
- cover.zip retorna cover-letter.txt inalterado, e extrair bundle.zip com Case-2025 lança e não deixa arquivo algum.
- Uma busca na pasta do projeto não encontra a chave de licença em nenhum arquivo.
O registro da execução
- Todas as execuções usaram um desktop Windows 11 x64 com um Core i9-14900KF e 64 GB de memória.
- Cada execução instalou
IronZIP2026.10.2, e cada projeto tem como alvo o .NET 9 exceto a ferramenta de auditoria .NET 10 na execução do Google Antigravity. - A duração de um guia é a soma dos tempos registrados dos prompts em sua página, e a linha deste guia conta apenas o prompt de aceitação.
- As versões e modelos na tabela vêm dos próprios arquivos de sessão e logs de cada ferramenta para a execução, não de uma verificação de versão separada.
- Último teste em 26 de outubro de 2026 para este guia, 11 de outubro para Google Antigravity, 12 de outubro para ChatGPT Codex e GitHub Copilot, 13 de outubro para Claude Code, e 15 de outubro para Cursor.
| Guia | Assistente e versão | Modelo | Duração (minutos) |
|---|---|---|---|
| Este guia | Claude Code 2.1.277, uma sessão, prompts de permissão desativados | Claude Opus 5 | 10.1 |
| Claude Code | Claude Code 2.1.277, prompt 3 em modo de plano | Claude Sonnet 5, com Claude Opus 5 através de opusplan para o plano no prompt 3 | 32.8 |
| ChatGPT Codex | Codex CLI 0.160.0, uma sessão retomada | GPT-6 Luna | 39.4 |
| GitHub Copilot | GitHub Copilot CLI 1.0.95, prompt 3 em modo de plano | GPT-6 Luna, roviado pelo Auto | 9.3 |
| Cursor | Aplicativo desktop Cursor 3.23.23, prompt 3 em Modo de Plano | Grok 4.7 | 57.4 |
| Google Antigravity | Antigravity CLI 1.3.2, atualizado para 1.3.3 após prompt 1, prompts 1 e 4 através de /plan, prompts de permissão pulados | Gemini 3.8 Flash (Alto) | 27.5 |
Guias Específicos para Agentes
Cada guia aplica as etapas acima a uma ferramenta e um trabalho de arquivo.
- Use IronZIP com Claude Code para atualizar um arquivo de caso protegido no lugar
- Use IronZIP com ChatGPT Codex para descompactar uma entrega de parceiro de formatos de arquivo mistos e verificar o SHA-256 de cada arquivo
- Use IronZIP com GitHub Copilot para pacotes de log .tar.gz diários e uma restauração que recusa entradas inseguras
- Use IronZIP com Cursor para mover pacotes de download de System.IO.Compression para arquivos ZIP AES-256
- Use IronZIP com Google Antigravity para servir documentos de caso de uma página web como um ZIP protegido
Solução de problemas
- Chaves de Licença IronZIP para quando o código gerado lança LicensingException
- Limites de Tamanho de Arquivo e Arquivo IronZIP para arquivos acima dos limites clássicos de 4 GB e 65.535 entradas ZIP
- Extrair ZIP Protegido para quando um arquivo protegido por senha não abre
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.