Jak korzystać z IronQR w Google Antigravity

Curtis Chau
Curtis Chau
Zaktualizowano: 9 października 2026

Strona przesyłania Blazor może kompilować się bez ostrzeżeń, ale nadal nieprawidłowo przetwarzać pliki użytkowników. Proces kompilacji nie wskazuje, czy stronie brakuje interaktywności, czy duże obrazy przekraczają limity przesyłania, ani czy obrazy zawierające wiele przejść są przetwarzane tylko częściowo. Te problemy są widoczne tylko podczas testowania w rzeczywistych warunkach.

Google Antigravity rozwiązuje to wyzwanie. Jej polecenie /browser wybiera pliki w kontrolce przesyłania. IronQR dekoduje przesłane obrazy po stronie serwera za pomocą QrReader.Read, więc strona nie potrzebuje skanera JavaScript. Ten przewodnik pokazuje, jak zbudować stronę rejestracji odwiedzających za pomocą obu narzędzi i weryfikuje wyniki poprzez porównanie każdego przesłanego pliku z jego oczekiwanymi wartościami i wartościami wyświetlonymi na stronie.

Jedno przypomnienie dotyczące terminologii. IronQR zawiera model uczenia maszynowego do wykrywania kodów QR w trudnych obrazach, jak opisano w przewodniku po trybach skanowania. W tym przewodniku 'AI' odnosi się do agenta kodującego odpowiedzialnego za pisanie i testowanie strony.

Szybki start
NuGetInstalacja z NuGet

PM > Install-Package IronQR

Zainstaluj IronQR, wykonując powyższe polecenie w konsoli Menedżera Pakietów NuGet lub wyszukaj pakiet w Menedżerze Pakietów NuGet.

Otworzyć projekt Blazor w Antigravity i określić żądaną konfigurację strony za pomocą /plan.

/plan This repo is a .NET 9 Blazor Web App with Interactive Server render
mode. Add a visitor check-in page at /scanner. Staff pick a photo of a visitor
pass with InputFile, the server decodes it with IronQR (NuGet package IronQR,
namespace IronQr) by loading the upload into an AnyBitmap and calling
QrReader.Read, and the page lists every value found. Set
IronQr.License.LicenseKey once in Program.cs, read from IRONQR_LICENSE_KEY in
the environment, and never write the key to a file. Add a NavMenu link.
In the Implementation Plan, state the render mode the page will use and the
largest upload it will accept. Then build until dotnet build is clean.
Text

Plan musi określić dwa ustawienia. Blazor Web App renderuje stronę statycznie, chyba że strona zdecyduje się na interaktywną działanie, jak wyjaśniono w przewodniku po trybach renderowania. OpenReadStream odrzuca każdy plik powyżej 512 000 bajtów, chyba że wywołanie podniesie ten limit, zgodnie z przewodnikiem po przesyłaniu plików Blazor firmy Microsoft, a zdjęcia z telefonu są znacznie większe. Po uruchomieniu agy -p z --dangerously-skip-permissions, każde wywołanie narzędzia jest zatwierdzone, dlatego należy przejrzeć plan i różnice jednocześnie.

Nadać agentowi nazwę zmiennej IRONQR_LICENSE_KEY, nigdy wartość. Agent, który zapisuje pliki i uruchamia polecenia, może skopiować wklejony klucz do commit lub logu. IronQR również czyta wpis IronQr.LicenseKey z appsettings.json, który łatwo jest przypadkowo umieścić w commit. Przewodnik po kluczach licencyjnych obejmuje wszystkie opcje.



Czym jest Google Antigravity i czym różni się od asystenta czatu?

Antigravity uruchamia agentów, którzy planują zmiany, edytują kod, używają terminalu, obsługują przeglądarkę, a następnie raportują w Artefaktach, które można przeglądać zamiast oglądać każdy krok. Google opisuje Antigravity 2.0 jako samodzielną aplikację desktopową do zarządzania agentami, a CLI instaluje się jako agy.

Agent pozostawiony do wyboru pakietu może zgadnąć jego nazwę, a atakujący rejestrują wiarygodnie brzmiące nazwy z wyprzedzeniem i wypełniają je malwarem, praktyką zwaną slopsquatting. Nazwać pakiet IronQR, a przestrzeń nazw IronQr.

Dokumentacja IronQR dla agentów i jednokrotnego testu akceptacji znajduje się w przewodniku po asystentach kodowania AI.

Co sprawdzić w planie, w diffie i w Walkthrough?

Plan Wdrożeniowy powinien również określać, co strona pokazuje dla obrazu bez kodu oraz dla obrazu z kilkoma kodami.

W różnicy kodu sprawdź, jak przesyłanie staje się AnyBitmap i wyszukaj każdego członka IronQR użytego w różnicy w dokumentacji API.

Dla zadań w przeglądarce Google mówi, że Walkthrough często zawiera zrzuty ekranu i nagrania tego, co zrobił agent. Podczas naszego uruchomienia CLI każde zadanie w rozmowie przepisywało ten sam walkthrough.md, więc zawierało jedynie raport najnowszego zadania. Skopiować każdą tabelę, którą należy zatrzymać, zanim zostanie wysłane kolejne polecenie.

Jak przetestować stronę przesyłania IronQR w prawdziwej przeglądarce?

Komenda /browser uruchamia izolowanego subagenta Chrome, który otwiera strony i robi zrzuty ekranu, zgodnie z dokumentacją poleceń slash. Poproś o tabelę, którą można wypełnić tylko poprzez przesyłanie plików.

/browser Run the app with dotnet run (the http profile listens on
http://localhost:5181) and open /scanner. Upload each image in TestData/scans
through the page's file input, one at a time, wait until the page shows a
result or a message, and screenshot it. TestData/scans/expected.csv lists the
values each image carries, separated by | when there are several, and an empty
cell means no code. Return a Walkthrough table of file, bytes, expected values,
values the page displayed, and pass or fail. When a row fails, quote the server
log or browser console line that explains it, or say that neither recorded
anything, before you edit anything. Then fix the page, restart the app, and
upload all seven images again. Stop the app at the end.
Text

Poprawka na liście wyników zmienia oznaczenia dla każdego obrazu, więc tylko kompletny ponowny test pokaże, że nic się nie cofnęło.

Uwaga: Otwórz najpierw zrzut ekranu dla największego zdjęcia. Zbyt duże przesyłanie może się nie powieść bez linii w logu serwera, więc raport zbudowany tylko na podstawie logów uznałby, że rząd jest poprawny.

Każdy zrzut ekranu zapisany jako artefakt obrazu. Gdy jeden z nich pokazuje problem, na przykład skrócony numer przesyłki, skomentuj to zamiast opisywania w nowym wyzwaniu.

Skąd biorą się brakujące lub błędne wartości QR?

Większość nieudanych rzędów sprowadza się do kilku przyczyn, a nazywanie prawdopodobnej w zadaniu uzupełniającym oszczędza agentowi jedną próbę i błąd. Umieściliśmy stronę z przewodnika skanera Blazor w nowym szablonie .NET 9 i przesłaliśmy siedem obrazów testowych przez bezgłową przeglądarkę Chrome z IronQR 2026.10.1. Każdy poniższy defekt skompilował się czysto. Po dodaniu trybu renderowania pięć z siedmiu obrazów pokazało prawidłową wartość.

  • Przycisk Skanuj, który pozostaje wyłączony dla każdego obrazu, wymaga trybu renderowania, który określa plan Quickstart.
  • Zdjęcie 48 MP (17 955 400 bajtów) przekracza limit 10 000 000 bajtów w przewodniku i zostawia przycisk wyłączony bez komunikatu. Ustawić limit powyżej największego zdjęcia i pokazać wiadomość dla większych plików.
  • Gdy obraz z dwoma przejściami pokaże jedną wartość, wymień każdy wynik.

Jak skonfigurować projekt i jego reguły dla Antigravity?

Dać agentowi projekt, który już się kompiluje i działa. Utworzyć go z dotnet new blazor --interactivity Server --framework net9.0, uruchomić raz i zanotować URL w Properties/launchSettings.json. Szablon wybiera inny port dla każdego projektu, a polecenie /browser go potrzebuje.

Następnie deleguj sprawdzanie pakietu i klucza.

Tell me which IronQR version the project references and paste its
PackageReference line. Then show me where the license key is applied. It has
to be set once at startup from IRONQR_LICENSE_KEY, appsettings.json and
appsettings.Development.json must carry no IronQr.LicenseKey entry, and when
the variable is missing the app should log one startup warning that names the
variable but prints no value. Change no other file, and touch Program.cs
only if that warning is missing.
Text

Używaj zgłoszonej wersji w każdym kolejnym zadaniu. Bez klucza dekodowanie nie powiedzie się z LicensingException i "Production License Required", więc brakująca zmienna spowoduje niepowodzenie pierwszego skanowania.

Gdy tabela przesyłania przejdzie, zapisz zasady. Antigravity ładuje AGENTS.md i GEMINI.md na każdym poziomie folderu aż do katalogu głównego przestrzeni roboczej, zgodnie z dokumentacją zasad, a /learn przekształca korekty sesji w trwałe zasady.

/learn Write the rules this session established into a new AGENTS.md at the
repository root (the always-on rules file, not .antigravity/rules.md) under a
"QR check-in page" heading. Cover the render mode the scanner page needs, the
upload cap and the reason for its value, showing every decoded value instead
of the first, keeping IRONQR_LICENSE_KEY out of files, and that no scanner
change is done until the /browser upload table passes for every image in
TestData/scans.
Text

Każde kolejne zadanie ładuje ten plik, więc polecenia przestają powtarzać tryb renderowania. Zadanie, które zmienia zasadę, musi zmienić też plik. Podczas naszej próby AGENTS.md zachował limit 30 MB z planu Quickstart po tym, jak refaktoryzacja przesyłania przeniosła usługę na 25 MB.

Jak zdekodować przesłany plik bez pliku tymczasowego?

IronQR czyta obrazy jako AnyBitmap, więc strona musi zamienić przesłanie przeglądarki na jeden. Przewodnik skanera Blazor kopiuje przesłanie do pliku tymczasowego nazwanym po nazwie pliku klienta i otwiera go z dysku. Dwa biurka przesyłające pliki o tej samej nazwie jednocześnie mogą się zderzyć, a Microsoft mówi, aby nigdy nie zapisywać przesłania pod nazwą podaną przez klienta.

AnyBitmap.FromStream unika pliku, ale strumień przeglądarki za przesłaniem nie może poszukiwać i odrzuca synchroniczne odczyty. W IronQR 2026.10.1 strumień z takim ograniczeniami po prostu rzuca NotSupportedException. Skopiowanie przesłania do MemoryStream z CopyToAsync przed odczytem działa. Microsoft zaleca nie buforować całych przesyłanych danych w pamięci serwera, więc limit przesyłania ogranicza również bufor.

Open an Implementation Plan Artifact for this refactor before editing. Move
the decoding out of the Razor page into Services/PassScanService.cs,
registered as a singleton. The service takes the IBrowserFile, rejects files
over 25 MB with a message the page shows, copies the upload into a
MemoryStream with CopyToAsync, builds the AnyBitmap from that buffer, reads it
with QrReader.ReadAsync and QrScanMode.Auto, and returns value, QrType and Url
for every result. No temporary files and no client file names on disk. Show
the scan time in milliseconds under the results. Then repeat the /browser
upload table for all seven images.
Text

Szukaj usługi w tych ramach w różnicy. Skompilowaliśmy tę wersję przeciwko IronQR 2026.10.1, a strona, która ją wywołała, pokazała właściwe wartości dla wszystkich siedmiu obrazów testowych.

using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Components.Forms;

public sealed class PassScanService
{
    public const long MaxUploadBytes = 25 * 1024 * 1024;

    public async Task<List<QrResult>> ScanAsync(IBrowserFile file)
    {
        using var buffer = new MemoryStream();
        await using (var upload = file.OpenReadStream(MaxUploadBytes))
        {
            await upload.CopyToAsync(buffer);
        }
        buffer.Position = 0;

        using var image = AnyBitmap.FromStream(buffer);
        var results = await new QrReader().ReadAsync(new QrImageInput(image, QrScanMode.Auto));
        return results.ToList();
    }
}
C#

QrResult.Url jest ustawione tylko wtedy, gdy wartość jest prawidłowym URI, co pasuje do biurka, gdzie niektóre przejścia niosą łącze, a inne numer przesyłki.

Dlaczego pierwsze skanowanie po ponownym uruchomieniu jest wolne?

Pakiet IronQR zawiera IronQrDetection.dll, 44 MB montaż w 2026.10.1, który jest niemal w całości jednym osadzonym zasobem, i zależy od Microsoft.ML.OnnxRuntime 1.20.1 do uruchomienia modelu detekcji. QrScanMode.Auto próbuje detektora przed podstawowym skanem, który działa tylko wtedy, gdy detektor nic nie znajdzie.

W trzech nowych procesach konsolowych czytających czysty obraz, pierwszy automatyczny odczyt trwał 3,1 do 4,7 sekundy, a późniejsze odczyty zajmowały 0,5 do 1,0 sekund. Nowy czytnik na odczyt nie przyniósł opóźnienia z powrotem, więc koszt to proces. Pierwsze odczyty OnlyBasicScan, w tym załadowanie pliku, trwały 0,33 do 0,56 sekund. Na Blazor Server, pierwszy odwiedzający po ponownym uruchomieniu lub zwiększeniu skali czeka, dopóki aplikacja nie załaduje detektora przy starcie.

/browser Measure the cold-start cost of the detection model. Restart the app,
upload TestData/scans/pass-clean.png three times on /scanner, and note the
scan time the page shows each time. Then add an IHostedService that reads one
small blank AnyBitmap with QrReader at startup, off the request path, restart,
repeat the three uploads, and put both sets of timings side by side in the
Walkthrough with a screenshot of each first upload.
Text

Rozgrzanie IHostedService, które blokuje uruchomienie, wymienia powolne pierwsze przesłanie na powolne pierwsze ładowanie strony, a czas pracy agenta pokazuje, którą opcję wybrał.

Kiedy należy wysłać więcej niż jednego agenta?

Agent testowy i agent przeglądarkowy sprawdzają różne rzeczy, wyniki usługi w kodzie i to, co widzi personel na stronie.

Agent A: create an xUnit project QrScanner.Tests that calls PassScanService
for every row of TestData/scans/expected.csv through a test double of
IBrowserFile, and asserts the exact set of values in any order. Add one test
that a file over the cap is rejected before IronQR reads it. Never compare
QR images byte for byte.

Agent B: start only after Agent A's tests pass against the current code. Use
/browser to upload the same seven images on /scanner, attach a screenshot of
each result to the Walkthrough, and state there that the tests passed first.
Text

W naszych testach IronQR zwrócił dwa przejścia w innej kolejności pod Auto niż pod OnlyBasicScan, dlatego testy porównują zestawy.

Uwaga: W aplikacji desktopowej, przypisz każdemu agentowi jego zadanie i porównaj dwa Przewodniki.

Jak wdrożyć skaner w kontenerze Linux?

IronQR 2026.10.1 zależy także od IronQR.Slim i IronSoftware.ReaderInternals.Windows, a IronQR.Linux zamienia wewnętrze dla Windows na IronSoftware.ReaderInternals.Linux.

This app will ship in a linux-x64 container built from
mcr.microsoft.com/dotnet/aspnet:9.0. Do not change any C#. Make the project
reference IronQR for Windows builds and IronQR.Linux when RuntimeIdentifier is
linux-x64, add a Dockerfile that publishes for linux-x64 and passes
IRONQR_LICENSE_KEY in at run time, then run dotnet publish -r linux-x64
--self-contained false -o publish-linux and list every .so file in that
folder with the NuGet package it came from. Docker is not installed on this
machine, so stop before docker build.
Text

Folder publikacji jest dowodem, a można go sprawdzić na Windows. Z pakietem IronQR dla Windows, publikacja linux-x64 zawierała biblioteki ONNX Runtime, ale nie ReaderInterop.so, natywnego czytnika dla Linux. PackageReference uzależniony od RuntimeIdentifier wybierze odpowiedni pakiet dla każdej kompilacji.

Oba natywne biblioteki łączą się z glibc, i żaden pakiet nie dostarcza kompilacji musl, więc baza obrazu Alpine nie ma co załadować. IronSoftware.ReaderInternals.Linux 2026.3.47413 dostarcza tylko kompilację linux-x64, więc ARM64 Linux jest poza zakresem IronQR.Linux 2026.10.1. Jeżeli pliki DLL detektora będą nieobecne w folderze wynikowym, IronQR rzuci wyjątek IronQrRuntimesCopyException, a strona wyjątków do kopiowania środowisk wyjaśnia naprawę. Przewodnik po pakietach NuGet wymienia wszystkie pakiety platformowe, a sam IronQR.Slim uruchamia OnlyBasicScan bez modelu detekcji.

Co wyprodukowały zapytania w rzeczywistym uruchomieniu?

Osiem powyższych poleceń uruchomiono w kolejności w jednym dialogu Antigravity CLI, bez nadzoru dzięki --dangerously-skip-permissions, przeciwko nowemu .NET 9 Blazor Web App z interaktywnym trybem serwera. Magazyn zawierał siedem obrazów testowych o znanych wartościach, wymienionych w TestData/scans/expected.csv. Były to czysty zrzut ekranu, zdjęcie telefonem 12 MP oraz 48 MP, obraz z dwoma przejściami, przechylone zdjęcie przy słabym oświetleniu, przepustka zawierająca URL i zdjęcie biurka bez przejścia. Klucz dotarł do agenta tylko przez środowisko. Po uruchomieniu odbudowano aplikację w trybie Release, przeprowadzono testy i przesłano wszystkie obrazy przez bezgłową przeglądarkę Chrome samodzielnie.

Ponieważ plan Quickstart już wcześniej ograniczył przesyłanie powyżej zdjęcia 48 MP i wymienił każdy wynik, dwie wadliwe przesyłania z przewodnika nigdy się nie pojawiły.

  • Pierwsze przesłanie po restarcie trwało 3 315 ms przed rozgrzewką i 901 ms po niej.
  • W tabeli przesłań agenta 6 z 7 rzędów przeszło, potem 7 z 7, kiedy posortowało wartości dwupasmowe.
  • Nasza kontrola przesłań końcowej aplikacji zaliczyła 7 z 7, a testy xUnit zaliczyły 8 z 8.
  • Wersja Release ukończyła się z 0 ostrzeżeń i 0 błędów.
  • ReaderInterop.so w linux-x64 publikacji wynosił 21 475 192 bajty.
  • Obie komendy z planem jako pierwszy napisały plan i zmieniły pliki w tym samym obrocie, a jeden agent wykonał pracę zleconą na dwuagentowe wezwanie.
  • Zrzuty ekranów z przeglądarki i folder publikacji linux-x64 pozostały w repozytorium.

Rekord uruchomionego zestawu w centrum run record wymienia wersję Antigravity, model i czas trwania, i maszynę używaną do uruchomienia.


Rozwiązywanie problemó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.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 82,442Wersja:2026.11właśnie wydane