Używanie IronZIP z asystentami kodowania AI
Poproś asystenta kodowania, aby skompresował lub rozpakował pliki w .NET, a IronZIP to jedna z bibliotek, którą może nazwać. IronZIP to biblioteka archiwizacji Iron Software dla ZIP, TAR, GZIP i BZIP2. Jest dostępna na NuGet od października 2023 roku, a jej przewodniki i przykłady kodu są publiczne.
Sama nazwa nie podpowie asystentowi, jak zachowuje się zainstalowana wersja. Asystent, który czyta dokumentację IronZIP, może pisać kod archiwizacji, który tworzy i wyodrębnia poprawnie. Taki, który działa z pamięci, może dodawać wywołania należące do innych bibliotek ZIP lub do starszych wersji. Załaduj dokumentację przed pierwszym żądaniem.
Jak używać IronZIP z asystentem kodowania AI
- Pobierz bibliotekę C# ZIP z NuGet
- Przypisać
IronZip.License.LicenseKeyzIronZip_LICENSE_KEYprzy uruchomieniu - Udostępnij indeks llms.txt IronZIP asystentowi przed napisaniem jakiegokolwiek kodu
- Przechowuj zasady IronZIP w pliku instrukcji projektu asystenta
- Otworzyć nową sesję i wkleić prompt z konfiguracją jednorazową
- Budować, rozpakować każde stworzone archiwum i porównać pliki z oryginałami
Czy mój asystent AI nie może obsługiwać plików ZIP samodzielnie?
IronZIP publikuje dokumentację napisaną do odczytu przez narzędzia. Gdy asystent ją załaduje, widzi, które klasy obsługują ZIP, TAR, GZIP i BZIP2 oraz jakie członkowie każda z nich posiada.
.NET już czyta i zapisuje zwykłe ZIP, GZIP i TAR przez System.IO.Compression i System.Formats.Tar.
- ZIP, który się otwiera, nadal może być błędny. Brakujący plik lub dwa wpisy o tej samej nazwie tworzą ZIP, który otwiera się bez błędu.
- Ochrona hasłem jest brakująca w .NET 9 i .NET 10. Ich klasy ZIP nie mają opcji hasła, a enum ZipEncryptionMethod występuje tylko w dokumentacji Microsoft dla .NET 11. IronZIP zapisuje archiwa AES-128 i AES-256.
- BZIP2 nie ma klasy w .NET. Namespace System.IO.Compression nie zawiera typu BZIP2, więc BZIP2 bez biblioteki oznacza pisanie formatu ręcznie.
- Nazwa pakietu i przestrzeni nazw różnią się wielkością liter. Identyfikator pakietu na NuGet to
IronZIP, podczas gdy przestrzeń nazw toIronZip. Nazwa pakietu wymyślona przez asystenta może pasować do imitacji, którą atakujący wrzucają celowo, co nazywa się slopsquatting. Podaj asystentowi dokładną nazwę. - Licencja nie ma opłaty za przedłużenie. Każda licencja zespołowa IronZIP jest opłacona raz, a strona licencyjna określa, ilu deweloperów, lokalizacji i projektów obejmuje każdy poziom.
Krok 1: Instalacja IronZIP
Pozwolić asystentowi dodać pakiet, aby mógł czytać rzeczywiste typy IronZIP, gdy pisze.
Put IronZIP 2026.10.2 from NuGet into this project and restore it.
Afterwards, report the IronZIP version that the restore resolved.
W terminalu, należy użyć tego polecenia, aby zainstalować bieżącą wersję.
dotnet add package IronZIP --version 2026.10.2
IronZIP jest dostarczany jako jeden pakiet zbudowany dla .NET Standard 2.0. Nie ma oddzielnego pakietu dla Linuxa, macOS ani ARM do wyboru.
Krok 2: Zastosować klucz licencyjny
Bez ważnego klucza, IronZipArchive akceptuje pliki w pamięci, ale SaveAs wyrzuca IronSoftware.Exceptions.LicensingException, której komunikat brzmi Wymagana licencja produkcyjna. Rozpakowywanie archiwum i otwieranie go wyrzuca ten sam wyjątek. Błędnie wpisany klucz wyrzuca Nie rozpoznano klucza licencyjnego. Blok poniżej oferuje darmowy klucz testowy.
Rozpocznij korzystanie z IronZIP we własnym projekcie już dziś z darmową wersją próbną.
Zastosuj klucz przy uruchomieniu aplikacji, przed innymi wywołaniami IronZIP. Zmienna środowiskowa przechowuje klucz poza kontrolą wersji.
IronZip.License.LicenseKey = Environment.GetEnvironmentVariable("IRONZIP_LICENSE_KEY");
IronZip.License.IsLicensed staje się prawdą, gdy aplikacja przypisze ważny klucz, a IronZip.License.IsValidLicense testuje klucz bez jego stosowania. IronZIP sam nie czyta IRONZIP_LICENSE_KEY. Przy ustawieniu zmiennej i bez przypisania, IsLicensed pozostało fałszywe w testach tego artykułu, więc SaveAs nie działa tak, jak bez klucza.
Krok 3: Skierować asystenta do dokumentacji LLM IronZIP
- llms.txt indeksuje dokumentację IronZIP jednym zdaniem podsumowania na stronę.
- llms-full.txt gromadzi podsumowanie każdej strony w jednym pliku, ale niektóre podsumowania opisują inną bibliotekę, więc bierz kod bezpośrednio ze stron.
- llms-full-catalog.txt dodaje wpisy bloga, dla przewodników i porównań.
- Referencja obiektowa IronZIP wymienia przestrzenie nazw i klasy IronZIP, z ich udokumentowanymi metodami i właściwościami.
- Asystenci, którzy przyjmują pliki umiejętności, mogą załadować skill.md, z krokami instalacji, licencjonowania, przepisami i poprawkami.
- Karta Produktu AI daje jedną stronę tła.
Dodaj jasną instrukcję obok indeksu.
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.
Asystent, który ma możliwość odpowiedzi "nie udokumentowane" ma opcję poza wymyślaniem metody.
Krok 4: Dodać kontekst IronZIP do projektu
Zasady wpisane w czacie kończą się z sesją, podczas gdy plik projektu ładowany jest za każdym razem. Nazwa pliku zależy od narzędzia. Claude Code ładuje CLAUDE.md, a GitHub Copilot ładuje .github/copilot-instructions.md. ChatGPT Codex, Cursor, i Google Antigravity wszystkie czytają AGENTS.md. Cursor także ładuje pliki zasad .mdc z .cursor/rules/, a Antigravity także czyta GEMINI.md. Tekst zasad jest taki sam w każdym pliku, a plik zasad Cursor dodaje wstęp MDC. Zacznij od tego bloku.
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.
Plik umiejętności ma dwie luki. Jego przykład jednoplikowy przypina IronZIP 2026.8.2, dwie wersje za pakietem 2026.10.2 na NuGet. Rekomenduje także IronZipArchive.FromDirectory do kompresowania folderu. Na 2026.10.2 ta metoda skompresowała tylko 4 pliki w głównym katalogu 30-pliko-wego testowego folderu i pominęła 26 w podfolderach, bez błędu.
Krok 5: Jednorazowy monit konfiguracji
Kroki od 1 do 4 pasują do tego jednego prompta. Należy go wysłać, gdy projekt się rozpoczyna lub gdy zaczyna się nowa sesja.
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.
Krok 6: Wzorce monitów, które produkują działający kod
Te trzy nawyki pozostawiają mniejsze pole do decyzji asystentowi.
Nazwać format, klasę i zabezpieczenie. IronZIP ma jedną klasę na format, a tylko klasa ZIP przyjmuje hasło. Należy określić, której potrzeba.
Niejasne Skompresuj raporty z IronZIP.
Lepiej Używając
IronZipArchivezEncryptiEncryptionMethods.AES256, dodaj każdy PDF z katalogu raportów do reports.zip, a następnie wyodrębnij go do tymczasowego folderu i potwierdź, że każdy plik pasuje do swojego oryginału.
Przypnij wersję i framework. Członek może zmieniać się z jednej wersji na kolejną. Przypięta wersja daje asystentowi jedno API do pracy.
Lepiej Celuj w .NET 9 i IronZIP 2026.10.2. Przypisz klucz licencyjny z IronZIP_LICENSE_KEY przed pierwszym wywołaniem archiwum.
Poproś o kompletność pliku. Fragment może zgubić swoje linie using, a enum encyfracji należy do namespace IronZip.Enum, oddzielnie od klas archiwum.
Lepiej Proszę o pełne Program.cs ze wszystkimi dyrektywami using i konfiguracją klucza, aby skompilowało się tak, jak jest.
Krok 7: Zweryfikuj, co otrzymujesz z powrotem
Przeglądaj wygenerowany kod przy użyciu trzech pierwszych sprawdzeń.
- Kompliluje się. Budowanie Release kończy się bez błędów.
- Klucz jest ustawiony jako pierwszy. Zapis lub ekstrakcja IronZIP, które działają przed linią klucza, wyrzucają LicensingException.
- Każde archiwum wyodrębnia się do identycznych plików. Rozpakuj do pustego folderu i porównaj hashe z oryginałami.
Należy uważać na nie w wygenerowanym kodzie IronZIP.
- Archiwum otwarte z FromFile.
IronZipArchive.FromFile("existing.zip")tworzy nowe archiwum, które zawiera sam siebie plik ZIP. Należy otworzyć istniejące archiwum znew IronZipArchive(path, password). - Wywołania archiwum Asynchroniczne. Żadna klasa archiwum IronZIP nie ma członka, który kończy się na Async, więc wywołanie
SaveAsAsyncnie kompiluje się. Należy owinąć wywołanie wTask.Run, kiedy serwer tego potrzebuje poza wątkiem żądania. - Zapis do strumienia. Archiwum można otworzyć z strumienia lub tablicy bajtów, ale żadna metoda zapisu nie pisze do strumienia ani nie zwraca bajtów. Należy zapisać do tymczasowego pliku i odczytać bajty, gdy odpowiedź wymaga ich.
Pozwolić agentowi weryfikować swoją własną pracę
Asystent, który wykonuje polecenia, może przeprowadzić tę samą rewizję.
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.
Nazwy wpisów z IronZIP
Add przechowuje każdy plik pod jego końcową nazwą pliku zarówno w archiwach ZIP, jak i TAR. Dwa pliki o jednej nazwie z różnych katalogów stają się zdublowanymi wpisami, a wyodrębnianie zachowuje tylko ostatni zapisany, bez błędu. Żadna metoda IronZIP, która dodaje plik, nie przyjmuje nazwy wpisu. Należy skopiować każdy plik do folderu tymczasowego pod unikalną nazwą zbudowaną z jego ścieżki względnej i dodać kopie.
Sprawdzanie haseł z IronZIP
Otwarcie archiwum zaszyfrowanego AES nie testuje jego hasła. new IronZipArchive(path, password) otworzył testowe archiwum AES-256 z 30 wpisami z błędnym hasłem i policzył wszystkie 30 wpisów. Hasło jest sprawdzane przy ekstrakcji. ExtractArchiveToDirectory z błędnym hasłem wyrzuca ArgumentException z komunikatem Nieprawidłowe hasło!! i nie zapisuje pliku. Chronione archiwum z jednym wpisem pokazuje odwrotne zachowanie na 2026.10.2. Konstruktor wyrzuca Nieprawidłowe Hasło! nawet z poprawnym hasłem, a ekstrakcja działa.
Wynik, który można powtórzyć
Otworzyć świeżą sesję w pustym folderze i wkleić prompt. Asystent pisze każdą linię programu, a lista dozwolonych poniżej definiuje poprawny wynik.
IRONZIP_LICENSE_KEY.Monit
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.
Program referencyjny na IronZIP 2026.10.2 skalibrował prompt. Dodanie każdego pliku z jego własnego folderu dało 27 unikalnych nazw spośród 30 wpisów w każdym archiwum, a uprzednio przeniesione unikalnie nazwane kopie dopasowały 30 z 30 na nasionach 2026, 77 i 4101.
Wynik
Obraz pokazuje listę wpisów w bundle.zip z przebiegu jako metoda Entries IronZIP ją czyta. Nieedytowana tabela okrężna zawiera każdą wartość mierzoną przez program.
- Kompilacja Release net9.0 nie wygenerowała żadnych ostrzeżeń ani błędów.
- Claude Code dopasowało wszystkie 30 wierszy w obu archiwach przy pierwszym uruchomieniu programu, więc pętla naprawcza nigdy nie działała.
- Próba, którą wykonano przed kodowaniem, pokazała Add przechowującego casefiles/a/mid.txt jako mid.txt.
- Program przeniósł każdy plik pod jego względną ścieżką, z % zapisywanym jako %25 i / jako %2F.
- Zestaw testowy zawierał 30 plików i 6 762 825 bajtów.
- Dwie nazwy plików i jedna nazwa folderu zawierały znak nie-ASCII.
- Jeden plik był pusty, a najgłębszy plik był trzy foldery poniżej casefiles.
- Oba zbiory miały 30 unikalnych nazw wpisów.
- Każdy wpis w obu plikach ZIP miał siłę AES 3 WinZip, ustawienie AES-256.
- cover-letter.txt wrócił z cover.zip niezmieniony.
- Próba Case-2025 wyrzuciła ArgumentException i zostawiła 0 plików w folderze.
- Niezależna kontrola odczytywała każde archiwum wyłącznie przy użyciu Pythona, poprzez pyzipper i tarfile, i przeszła 30 z 30 sprawdzeń.
- Klucz licencyjny nie pojawił się w żadnym pliku projektu ani nigdzie w transkrypcie sesji.
- W odpowiedzi na prompt Krok 1, dotnet list package zawiódł z powodu niezgodności nazwy pakietu aż do momentu, gdy Claude Code usunął obj i przywrócił ponownie.
- W odpowiedzi na prompt dotyczący konfiguracji, Claude Code zapisał zasady w nowym CLAUDE.md i niezmienioną kopię skill.md jako umiejętność projektu.
- W samo-kontroli, Claude Code zgłosiło wszystkie 16 członków programu IronZIP jako udokumentowane.
- Niektóre kroki uruchomiono inaczej niż na stronie. Claude Code otrzymało prompty z Kroków 1, 3, 5 i 7 po promtcie akceptacyjnym, w jednej sesji. Sondy API działały w projekcie roboczym w tymczasowym folderze sesji, poza katalogiem projektu. Generator podążał za stałą listą 30 ścieżek i czerpał tylko rozmiary i bajty z nasienia.
Co przechodzi
- Projekt buduje się w Release bez ręcznych zmian kodu.
- Figury kroku 5 w roundtrip.md utrzymują się, gdy casefiles są mierzone ponownie.
- Wszystkie 30 wierszy roundtrip.md odpowiadają sobie, z oboma wyodrębnionymi haszami przeliczonymi z plików, a bundle.zip i bundle.tgz każdy posiadają 30 unikalnych nazw wpisów.
- cover.zip zwraca cover-letter.txt niezmieniony, a rozpakowanie bundle.zip z Case-2025 wyrzuca błąd i nie pozostawia pliku.
- Przeszukiwanie folderu projektu pozwala znaleźć klucz licencyjny w żadnym pliku.
Rekord uruchomienia
- Wszystkie uruchomienia wykorzystały jeden desktop z Windows 11 x64 z procesorem Core i9-14900KF i 64 GB pamięci.
- Każda próba zainstalowała
IronZIP2026.10.2, a każdy projekt celuje w .NET 9 poza narzędziem audytu .NET 10 w Google Antigravity. - Czas trwania przewodnika to suma zalogowanych czasów zalogowanych monitów na jego stronie, a wiersz tego przewodnika liczy tylko monit akceptacyjny.
- Wersje i modele w tabeli pochodzą z plików sesji własnych narzędzi i logów dla uruchomienia, a nie z osobnego sprawdzenia wersji.
- Ostatnio testowane 26 października 2026 dla tego przewodnika, 11 października dla Google Antigravity, 12 października dla ChatGPT Codex i GitHub Copilot, 13 października dla Claude Code i 15 października dla Cursor.
| Przewodnik | Asystent i wersja | Model | Czas trwania (minuty) |
|---|---|---|---|
| Ten przewodnik | Claude Code 2.1.277, jedna sesja, wyłączone monity o uprawnienia | Claude Opus 5 | 10.1 |
| Claude Code | Claude Code 2.1.277, monit 3 w trybie planowania | Claude Sonnet 5, z Claude Opus 5 przez opusplan na plan w prompt 3 | 32.8 |
| ChatGPT Codex | Codex CLI 0.160.0, jedna wznowiona sesja | GPT-6 Luna | 39.4 |
| GitHub Copilot | GitHub Copilot CLI 1.0.95, prompt 3 w trybie planu | GPT-6 Luna, trasowane przez Auto | 9.3 |
| Cursor | Cursor 3.23.23 aplikacja desktopowa, prompt 3 w Trybie Planowania | Grok 4.7 | 57.4 |
| Google Antigravity | Antigravity CLI 1.3.2, zaktualizowany do 1.3.3 po prompt 1, prompty 1 i 4 przez /plan, pominięto prompty uprawnieniowe | Gemini 3.8 Flash (Wysoka) | 27.5 |
Przewodniki specyficzne dla agenta
Każdy przewodnik stosuje powyższe kroki do jednego narzędzia i jednej pracy archiwizacyjnej.
- Używanie IronZIP z Claude Code do aktualizacji zabezpieczonego archiwum w miejscu
- Używanie IronZIP z ChatGPT Codex do rozpakowywania partnera upuszczającego mieszane formaty archiwów i sprawdzania SHA-256 każdego pliku
- Użyj IronZIP z GitHub Copilot do codziennych zestawień dzienników .tar.gz i przywracania, które odmawia niebezpiecznym wpisom
- Użyj IronZIP z Cursor do przenoszenia paczek do pobrania z System.IO.Compression do szyfrowanych plików ZIP AES-256
- Użyj IronZIP z Google Antigravity do udostępniania dokumentów spraw z strony internetowej jako zabezpieczony ZIP
Rozwiązywanie problemów
- Klucze licencyjne IronZIP gdy generowany kod wyrzuca LicensingException
- Limity rozmiaru plików i archiwów IronZIP dla archiwów przekraczających klasyczne limity ZIP 4 GB i 65 535 wpisów
- Wyodrębnij chroniony ZIP gdy archiwum chronione hasłem nie chce się otworzyć
Pytania?
Jeśli są jakiekolwiek pytania, należy skontaktować się z support@ironsoftware.com
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.