Jak używać IronZIP z Google Antigravity
Strona, która przekazuje klientom ich dokumenty jako zabezpieczony hasłem plik ZIP, może skompilować się poprawnie i nadal wysłać archiwum z brakującymi plikami, stronę błędów dla zwykłej sprawy lub dokument z innej sprawy.
Komenda /browser Google Antigravity uruchamia podagenta przeglądarki Chrome, który może obsługiwać uruchomioną stronę, więc jeden monit może wpisać hasło, nacisnąć przy pobieraniu dla każdego przypadku testowego i zatrzymać zrzut ekranu każdego wyniku. IronZIP tworzy archiwum na serwerze z szyfrowaniem AES-256 i ponownie je rozpakowuje, aby strona mogła udowodnić, że każdy dokument wrócił bajt po bajcie. Ten przewodnik buduje stronę do pobierania w aplikacji ASP.NET Core MVC, zaczynając od przykładu zabezpieczenia hasłem IronZIP, i sprawdza ją w pięciu przypadkach, których dokumenty i skróty SHA-256 są znane z góry.
Otwórz folder CaseDocs w Antigravity i opisz stronę do pobierania.
/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.
Przeczytaj te trzy odpowiedzi przed wprowadzeniem zmian w kodzie. Kazdy opisuje sposób, w jaki archiwum moze pojsc zle bez bledu kompilatora. W trybie headless agy -p nikt nie zatwierdza planu, wiec przeczytaj artefakt planu obok opisanego kodu.
Nazwij zmienną w poleceniu i nigdy nie wklejaj wartości. Wszystko, co zostanie wpisane do rozmowy, moze dotrzec do pliku zródowego, zatwierdzenia lub transkrypcji terminala. IronZIP akceptuje równiez wpis IronZip.LicenseKey w pliku appsettings.json, a zatwierdzenie zawiera ten plik z cala reszta. Kazda obslugiwana lokalizacja jest w przewodniku po kluczu licencyjnym.
Minimalny proces (5 kroków)
- Pobierz bibliotekę C# ZIP z NuGet
- Uruchomić aplikację ASP.NET Core MVC na localhost przed pierwszym monitowaniem
- Zatwierdź zasady pobierania i manifest z SHA-256 każdego dokumentu
- Każdy przypadek naciska Pobierz w
/browseri zrzuca obraz wyniku - Rozpakuj kazde archiwum z jego haslem, zhashuj kazdy plik i potwierdz czlonków IronZIP w dokumentacji API
Co należy przeanalizować przed zaakceptowaniem zmian?
Sprawdzić, skąd pochodzą nazwy wpisów, folder, w którym każde archiwum jest zapisywane, linia, która je usuwa, i kod, który odczytuje archiwum z powrotem. Następnie potwierdzić każdego członka IronZIP w różnicy z dokumentacja API.
Antigravity zapisuje zrzuty ekranu jako artefakty obrazów, które akceptuja komentarze. Kiedy jeden pokazuje strone bledów lub niewlasciwa liczbe dokumentów, skomentuj ten zrzut zamiast pisac o tym nowy monit.
Jak przetestować każde pobieranie w rzeczywistej przeglądarce?
Poproś o tabelę wyników, którą można wypełnić tylko rzeczywistymi pobraniami.
/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.
Poprawka do nazw wpisów zmienia kazde archiwum, nawet dla przypadków, które juz przeszly, co jest powodem, dla którego monit ponownie uruchamia wszystkie szesc wierszy.
Co powoduje niekompletne lub nieudane pobierania?
W naszej kalibracji kod z przykładu zabezpieczenia hasłem został przeniesiony do akcji pobierania. Przełączono na AES-256 i zliczano wpisy zapisanych archiwów, otwierając je za pomocą konstruktora. Headless Chrome nacisnął Pobierz dla każdego przypadku z IronZIP 2026.10.2. Każda nieprawidłowość poniżej została skompilowana bez ostrzeżenia.
| Co się stało | Przyczyna | O co pytac |
|---|---|---|
| Przypadek z szescioma dokumentami zostal pobrany, ale podczas wyodrebniania jego zawartosc dala 3 pliki | IronZIP nadaje nazwy kazdemu wpisowi na podstawie samego pliku, wiec dwa pliki letter.pdf, dwa scan.jpg i dwa pliki summary.pdf mialy wspólne nazwy | Nazwy wpisów zostaly zbudowane z sciezki względnej, z kopiami zapisanymi pod tymi nazwami |
| Przypadek z jednym dokumentem zwrócil strone bledów | Odczyt za pomoca konstruktora wyrzucil "Nieprawidłowe hasło!" z właściwym hasłem | Odczyt, który extrahuje archiwum |
| Przypadek pusty zwrócil strone bledów | Zapisanie archiwum bez wpisów wyrzuciło "Istniejące archiwum jest uszkodzone!" | Sprawdzenie wyboru przed uruchomieniem IronZIP |
| Edytowana wartość pola wyboru na ../C-1001/ledger.csv wstawila plik z innej sprawy do pobierania | Akcja ufasła przesłanym ścieżkom | Każda wysłana ścieżka rozwiązała się i pozostawała wewnątrz folderu danej sprawy |
| Cztery pliki ZIP pozostaly w folderze tymczasowym | IronZIP zapisuje tylko do sciezki, a nic nie usuwało pliku | Folder na zapytanie, usuniety po zakonczenu zapytania |
Sprawdzenie liczby wpisów przeszło dla przypadku z szescioma dokumentami, poniewaz archiwum zawieralo sześć wpisów.
Jak skonfigurować projekt, w którym Antigravity może działać?
Agent potrzebuje aplikacji, która już buduje i odpowiada na localhost. dotnet new mvc --framework net9.0 dostarcza jedną, a uruchomienie jej raz pokazuje port w Properties/launchSettings.json. Port różni się w każdym projekcie, a monity /browser muszą go nazywać. Na liście dozwolonych przeglądarki najpierw znajduje się tylko localhost, więc należy zachować adres w formie http://localhost:<port>.
Zatwierdź foldery przypadków pod CaseFiles, zasady w docs/case-download-rules.md, TestData/expected.csv z wynikami dla każdego przypadku i hasła, oraz TestData/manifest.csv z nazwą wpisu każdego dokumentu, jego rozmiarem i SHA-256. Pięć przypadków testowych zawierało pięć zwykłych dokumentów, sześć dokumentów z trzema powtarzającymi się nazwami w podfolderach, jedno oświadczenie, trzy dokumenty z nazwami z akcentami i japońskimi znakami oraz żadne dokumenty w ogóle. Następnie niech agent przeprowadzi audyt pakietu i klucza.
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.
Powtórz ten numer wersji za każdym razem, gdy późniejszy monit doda projekt lub pakiet, aby każdy projekt był budowany w odniesieniu do tej samej wersji IronZIP. Agent, który zapisuje nazwę pakietu z pamięci, może zainstalować złośliwy pakiet opublikowany pod wymyśloną nazwą, atak nazywany slopsquatting. Pakiet to IronZIP, a przestrzeń nazw to IronZip.
Przy ustawionej zmiennej i License.LicenseKey nigdy nie przypisanym, strona kalibracji nie powiodła się przy wywołaniu zapisu dla wszystkich czterech przypadków archiwum. Każdy wyrzucił LicensingException odczytujący "Wymagana licencja produkcyjna". IronZIP nie przeczytał IRONZIP_LICENSE_KEY samodzielnie, więc aplikacja musi przypisać IronZip.License.LicenseKey samodzielnie. W przypadku dokumentacji agenta IronZIP i testu akceptacji z jednym monitowaniem, zobacz przewodnik po asystentach programowania AI.
Jak usługa powinna przekazywać dokumenty do IronZIP?
Add, AddArchiveEntry i FromFiles zostawily katalog w sondzie, nawet z względnej ścieżki jak 2025/letter.pdf, a wyodrębnianie zachowało ostatni z dwóch wpisów o tej samej nazwie. Dodanie ścieżki do folderu wyrzuciło UnauthorizedAccessException. Usługa zatem kopiuje każdy dokument do tymczasowego folderu pod nazwą, którą nadają mu zasady, i dodaje kopie.
Awaria konstruktora dotyczy wszystkich sposobów otwierania archiwów AES-256 z jednym wpisem, ponieważ strumień, tablica bajtów i FromArchive overloads wyrzucily ten sam System.Exception. Z dwoma lub więcej wpisami AES-256 konstruktor je listował nawet z niewłaściwym hasłem, podczas gdy Tradycyjna metoda archiwum wyrzuciła ZipException przy konstruktorze. Wyodrębnianie zwróciło archiwum z jednym wpisem w calosci i wyrzuciło ArgumentException z "Invalid password!!" dla każdego błędnego, pustego lub brakującego hasła.
Poziom kompresji ZIP nie miał znaczenia w IronZIP 2026.10.2. Poziomy 0, 1, 6 i 9 produkowały takie samo archiwum o rozmiarze 970,545 bajtów z 1,042,684 bajty dokumentów próbnych, a każde budowanie trwało 119 do 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.
Porównać usługę agenta z tą tutaj. Buduje z IronZIP 2026.10.2 i zwróciło wszystkie cztery archiwa w całości i nie zostawiło żadnego folderu tymczasowego.
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);
}
}
}
Jak udowodnić ze każde archiwum zawiera właściwe pliki?
/goal działa dopóki cel nie zostanie osiągnięty i nie zatrzymuje się, aby zapytać o potwierdzenie po drodze.
/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.
Własny czytnik .NET nie może wykonać tego sprawdzenia. System.IO.Compression listował nazwy wpisów kalibracyjnych archiwów AES-256, ale wyrzucił InvalidDataException, "unsupported compression method", dla zawartości wszystkich 15 wpisów, więc test oparty na nim może policzyć wpisy bez czytania ani jednego bajta.
Jak zastosować zasady pobierania do późniejszych zadań?
Zgodnie z dokumentacją zasad Antigravity, zasady pochodzą z AGENTS.md, GEMINI.md i plików .agents/rules/*.md w każdym folderze od edytowanego pliku do katalogu głównego obszaru roboczego. Pliki w .agents/rules muszą otwierać się przedmiotem YAML nazwąjącej ważny trigger, a brakujący lub nierozpoznany wyzwalacz powoduje, że Antigravity usuwa zasadę bez wiadomości. Z model_decision, tylko ścieżka i opis zasady wchodzą do monitu, a agent ładuje pełny tekst, gdy jego zadanie pasuje do opisu.
/learn zmienia korekty z sesji w zasadę lub umiejętność. Strona komend slash mówi, że może pisać AGENTS.md, GEMINI.md lub plik w .agents/rules, dlatego nazwij ścieżkę zasady w monicie.
/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.
Następnie przeczytaj pierwsze linie pliku i potwierdź, że w przedmiocie pisze się wyzwalacz model_decision, w nomenklaturze snake case.
Kiedy należy wysłać więcej niż jednego agenta?
Przekazać automatycznych testów jednemu agentowi, a dowodu przeglądarkowego drugiemu.
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.
Testy, które przesyłają formularz za pomocą WebApplicationFactory nie potrzebują przeglądarki ani otworzonego portu, więc łapią błędną nazwę wpisu w ciągu sekund.
Co wyprodukowały zapytania w rzeczywistym uruchomieniu?
Wszystkie siedem monitów odbyły się w jednej rozmowie CLI Antigravity, po kolei, bez nikogo przy klawiaturze, w nowej aplikacji .NET 9 MVC, która miała pięć przypadków, zasady i oba pliki CSV. Podane poniżej liczby pochodzą z naszych własnych wersji Release, pobrań headless Chrome i ekstrakcji IronZIP, a nie z odpowiedzi agenta.
- Po monicie 01 i w ostatecznej aplikacji kod pasował do wszystkich sześciu wierszy expected.csv w niezależnym przejściu przeglądarki i odpowiedział na edytowaną ścieżkę z błędem 400.
- W obu punktach, ekstrakcja IronZIP każdego pobrania zwróciła nazwy z manifestu i wartości SHA-256 dla 5 z 5, 6 z 6, 1 z 1 i 3 z 3 dokumentów.
- W obu punktach, ekstrakcja z błędnym hasłem wyrzuciła "Invalid password!!".
- Ostateczne archiwa miały rozmiary 979,949, 779,422, 3,637 i 154,332 bajtów, takie same rozmiary, jakie produkuje powyżej usługa.
- Ostateczny przebieg pobierania nie zostawił żadnego pliku CaseDocs w katalogu tymczasowym.
- Wersje Release aplikacji, narzędzia audytu i projektu testowego zgłosiły 0 ostrzeżeń i 0 błędów.
- Pakiet xUnit przeszedł 7 z 7 w 2 sekundy.
- Zanim napisał odczyt, monit 01 przetestował IronZIP w konsolowym projekcie testowym i napotkał awarię jednowpisową.
- Kontroler monitu 01 otworzył tylko archiwum z konstruktorem, gdy zaznaczono więcej niż jeden dokument.
- Dla jednego dokumentu ten kontroler listował wpis za pomocą System.IO.Compression.
- Monit 04 zastąpił to sprawdzenie wyodrębnianiem i porównaniem SHA-256.
- Audyt /goal przeszedł przy pierwszym uruchomieniu bez niczego do naprawy.
- /learn napisał regułę 68-liniową z wyzwalaczem model_decision.
- W monicie 03 agent przetestował ostrzeżenie o brakującym kluczu za pomocą zagnieżdżonego powershell -Command którego podwójne cudzysłowy rozszerzyły IRONZIP_LICENSE_KEY.
- Wynikająca wiadomość o błędzie przekazała wartość klucza do modelu i do plików transkrypcji Antigravity pod .gemini/antigravity-cli, podczas gdy żaden plik repozytorium go nie trzymał.
- Niektóre kroki uruchomiono inaczej niż na stronie. Podagent /browser nie mógł połączyć się z Chrome na testowej maszynie ("Could not find DevToolsActivePort"), więc agent obsługiwał headless Chrome z własnym skryptem Playwright dla każdego przejścia przeglądarki, zrzutów ekranów i obu nagrań. Jego odpowiedź nadal przypisywała zasługi podagentowi przeglądarki. Monity 01, 04 i 06 każdy stwierdziły, że czekają na recenzję, a potem edytowane były w tej samej turze. CLI trzymało jeden plan i jeden Przewodnik dla całej rozmowy, a późniejsze monity nadpisywały oba, więc tylko odpowiedzi trzymały wcześniejsze tabele. Reguła /learn stwierdzała przyczynę wziętą z dekompilacji IronZIP i nazwała System.IO.Compression jako sposób na wyodrębnienie tych archiwów. Jeden agent przeprowadził obie połówki monitu dwuagentowego w jednej turze tej samej rozmowy. Narzędzie audytu celuje w .NET 10. Każdy monit o pozwolenia został pominięty.
Przewodnik ChatGPT Codex podzielił pracę związaną z wprowadzaniem archiwów między agentów eksploracji i pracy, a jego uruchomienie wygenerowało cztery wątki agenta. Przewodnik Claude Code planuje aktualizację archiwów zaszyfrowanych przypadków bez zmiany miejsca w trybie planowania, tak jak robi to prompty /plan. Rekord przebiegu huba's run record podaje wersję Antigravity, model, czas trwania poleceń i maszynę testową.
Rozwiązywanie problemów
- Zabezpieczenie hasłem ZIP dla przykładu, od którego zaczyna ta strona
- Wyodrębnij zabezpieczony ZIP dla wywołania ekstrakcji, na którym opiera się każde sprawdzenie
- Pokaż wpisy archiwum, gdy potrzebne są nazwy i rozmiary wpisów bez wyodrębniania
- Klucze licencyjne IronZIP jeśli każde pobranie kończy się LicensingException
- IronZIP Limity rozmiarów plików i archiwów przed obsługą spraw ponad 4 GB lub 65,535 dokumentów
Pytania?
W przypadku jakichkolwiek pytań, 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.