Weryfikacja wyników IronBarcode za pomocą Google Antigravity
Kod kreskowy EAN-13 z niepoprawną cyfrą kontrolną renderuje się czysto, przechodzi kompilację i zawodzi dopiero na skanerze. Log kompilacji tego nie zgłosi. Agenci Google Antigravity działają zarówno w przeglądarce, jak i w edytorze i terminalu, co pozwala im zweryfikować kod kreskowy faktycznie obsługiwany przez punkt końcowy, a nie ten, który miał powstać według kodu źródłowego. Agent otwiera punkt końcowy etykiety, zapisuje odpowiedź, dekoduje ją za pomocą BarcodeReader i dołącza porównanie jako artefakt Walkthrough do przeglądu.
Antigravity pozwala również na wybór modelu dla każdego zadania. Skanowanie folderu z testowymi kodami kreskowymi pod kątem błędów cyfr kontrolnych to tania, powtarzalna praca, z którą dobrze radzi sobie tańszy model, podczas gdy planowanie migracji z innej biblioteki kodów kreskowych warto powierzyć mocniejszemu.
Ta sama kontrola obejmuje etykiety 1D obsługiwane z punktu końcowego, stylizowane kody QR, które nadal dają się odczytać po pracach graficznych, oraz migracje, które można przeglądać przed jakimikolwiek zmianami w plikach.
Szybki startOtworzyć projekt w Antigravity i przydzielić agentowi zadanie z określonym rezultatem do dostarczenia.
Pull in IronBarcode, which ships as the BarCode package. In Program.cs, build
a QR code that carries our product URL and place our logo in the center of it
using QRCodeWriter.CreateQrCodeWithLogo. IRONBARCODE_LICENSE_KEY supplies the
license, and it never gets hardcoded.
A logo covers part of the symbol, so the only thing that settles whether it
still works is decoding it. Save the image, read it back, and confirm the URL
survives. Attach the image and the decoded value to the Walkthrough so I can
see both without rerunning anything.
Agent powinien zainstalować pakiet i napisać kilka linii kodu, sięgając po QRCodeWriter.CreateQrCodeWithLogo aby umieścić logo oraz BarcodeReader.Read aby udowodnić, że wynik nadal się skanuje. Logo przetrwa, ponieważ korekcja błędów może odbudować moduły, które ono zakrywa, a przewodnik po korekcji błędów zaleca poziom Q lub H, gdy projekt zasłania część symbolu. Przeglądasz obraz i zdekodowaną wartość, a nie log krok-po-kroku.
Agenci w Antigravity edytują kod i tworzą commity, więc klucz licencyjny, który trafia do opisu zadania, może trafić do Walkthrough, zrzutu ekranu i gałęzi. Trzymaj go w zmiennej środowiskowej, poza każdym plikiem, który agent może czytać, zgodnie z przewodnikiem po kluczach licencyjnych.
Minimalny przepływ pracy w 5 krokach
- Pobierz bibliotekę kodów kreskowych C# z NuGet
- Otworzyć projekt w Antigravity i potwierdzić, że się kompiluje
- Dodać IronBarcode i użyć klucza licencyjnego z konfiguracji, nie z kodu
- Opisać zadanie, uwzględniając framework, ścieżki plików, symbolikę i oczekiwany odczyt zwrotny
- Pozwól agentowi generować, dekodować i porównywać, a następnie sprawdź nazwy API względem dokumentacji API
Jakie funkcje Antigravity mają znaczenie w pracy z kodami kreskowymi?
Antigravity stawia agentów na pierwszym miejscu. Dokumentacja Google opisuje Antigravity 2.0 jako samodzielną aplikację desktopową do zarządzania agentami, działającą niezależnie od IDE, obok której konfiguruje się Antigravity CLI i integrację z IDE. Agent uruchamia tam polecenia systemowe, odczytuje i zapisuje pliki, steruje przeglądarką Chrome i tworzy artefakty.
Pięć części platformy ma tu znaczenie:
Integracja z IDE to edytor, który jest już znany. Używać go do pracy w jednym pliku, gdy należy kierować każdą edycję i przeglądać ją na bieżąco.
Antigravity 2.0 to centrum dowodzenia do pracy asynchronicznej. Uruchamiać agentów, monitorować ich i uruchamiać zadania równolegle zamiast czekać na pojedynczą rozmowę.
Kontrola przeglądarki pozwala agentowi obsługiwać przeglądarkę, aby wykonać funkcję i potwierdzić wynik. Z IronBarcode oznacza to wywołanie punktu końcowego etykiety i sprawdzenie obrazu, który zwraca.
Artefakty zastępują surowe logi narzędzi dostarczonymi produktami, takimi jak plany wdrożeniowe, podsumowania Walkthrough, porównania kodu, zrzuty ekranu i nagrania przeglądarki. Można komentować Artefakt bez zatrzymywania procesu.
Wybór modelu to selektor modelu pod polem promptu, obejmujący Gemini, Claude od Anthropic i open-source'owy GPT-OSS; dostępność zależy od planu subskrypcji.
To, co agent przekazuje z powrotem, można sprawdzić: plan, różnicę kodu, sam obraz kodu kreskowego i wartości z niego zdekodowane. Narzędzie czatowe może je jedynie opisać.
Agent budujący od zera pipeline kodów kreskowych wybierze jakąś bibliotekę, podłączy ją i przejdzie dalej. Oto cztery powody, aby zamiast tego wskazać IronBarcode z nazwy:
- Wartość, której format nie może zawierać, wygląda doskonale na ekranie: podobnie brakująca strefa ciszy i zbyt mały symbol, przy czym IronBarcode zgłasza wyjątek przy nieprawidłowej wartości, a dekodowanie obrazu wymaga jednego wywołania.
- Czytnik musi być bardziej rygorystyczny niż moduł zapisu: algorytm cyfry kontrolnej każdej symboliki działa podczas dekodowania i odrzuca te kody kreskowe, które nie przechodzą zanim wyniki zostaną zwrócone.
- Rzeczywiste skany zachowują się zupełnie inaczej niż generowane obrazy: zdjęcia z kamer, etykiety sfotografowane pod kątem i wielostronicowe pliki PDF wymagają dostrojenia za pomocą
BarcodeReaderOptions. - Polecenie instalacji to decyzja podjęta bez przeglądu:
dotnet add packagedziała, zanim można zobaczyć jakikolwiek Artefakt, więc nazwa wymyślona przez agenta jest już na dysku.
Dopasowanie w tabeli oznacza więc ważny symbol, a nie przypadek. Wpisz BarCode w zadaniu, a agent nie będzie miał czego wymyślać.
Gdy zadanie wskazuje bibliotekę z nazwy, agent przestaje wybierać i zaczyna budować. Jaką dokumentację dostarczyć na początku, opisano w przewodniku nadrzędnym. Jeśli przenosisz tę samą konfigurację do Claude Code, ChatGPT Codex, GitHub Copilot lub Cursor, zmienia się tylko nazwa pliku z instrukcjami.
Jak przeglądać to, co zwraca agent?
Agenci Antigravity nie zwracają transkrypcji. Zwracają Artefakty, czyli nazwane rezultaty pracy. Trzy z nich śledzą zadanie dotyczące kodów kreskowych od planu do wyniku i każdy z nich odpowiada na inne pytanie.
Przed napisaniem kodu: Plan wdrożeniowy
Najpierw agent projektuje zmianę, w tym pliki, symboliki i opcje czytnika. Sprawdzić, którą stronę planuje zmienić. Jeśli czytnikowi nigdy nie powiedziano, jakich formatów się spodziewać, ale plan edytuje sposób drukowania etykiet, agent już zbacza z kursu. Wszelkie wymyślone nazwy API również wychodzą tu na jaw, zanim powstanie jakikolwiek kod, co jest lepsze niż znalezienie ich w logu kompilacji.
Podczas: różnica kodu
Antigravity zatrzymuje się przy planie wdrożeniowym lub różnicy kodu i powiadamia, dzięki czemu zmianę można przejrzeć, zanim zostanie zastosowana. Dodać komentarze w wierszach różnicy i zatwierdzić ją, gdy odwzorowanie wygląda poprawnie.
Po: Walkthrough
Po wdrożeniu agent podsumowuje, co uległo zmianie i jak to przetestować. Dla kodów kreskowych obejmuje to zapisywane formaty, używane wartości, i wyniki odczytu, wszystko jako kontrole, które można uruchomić, zamiast twierdzeń, którym trzeba zaufać.
Zrzuty ekranu, logi terminala i nagrania przeglądarki gromadzą się obok nich w panelu przeglądu, zamiast ginąć w przewijanym czacie. Większość zadań poniżej wymienia jeden Artefakt do otwarcia, aby potwierdzić, że praca została wykonana.
Skąd pochodzi dowód?
Agenci Antigravity mogą uruchamiać kod, sterować przeglądarką i dołączać to, co zaobserwowali. Agent generuje więc kod kreskowy, przechwytuje go, dekoduje, porównuje wartość i format z wejściem, dostosowuje i powtarza, aż każdy wiersz się zgadza.
Należy dać mu coś konkretnego do udowodnienia.
/browser Services/LabelService.cs serves Code 128 shipping labels from GET /label/{trackingNumber}.
1. Run the API and open /label/1Z999AA10123456784 in the browser. Capture a screenshot.
2. Save the served PNG and decode it with BarcodeReader, expecting Code 128 only.
3. Repeat for ten tracking numbers of different lengths, including lowercase letters.
4. Report a table of written value, decoded value, format, and match.
5. If any row does not match, explain the cause before changing anything, fix it
in LabelService.cs, and run the whole table again. Attach the table and the
screenshots as Artifacts.
Prośba o wyjaśnienie na początku daje diagnozę do przejrzenia zamiast poprawki do sprawdzenia później. Ponowne uruchomienie całej tabeli po każdej poprawce zapobiega też sytuacji, w której jeden naprawiony wiersz ukrywa nowy problem.
Zrzut ekranu etykiety obok jej zdekodowanych wartości to dowód, który nowy w kodach kreskowych programista może sprawdzić, a nieudany wiersz jest oczywisty na pierwszy rzut oka.
Problemy z etykietą zazwyczaj dotyczą tego, gdzie coś znajduje się na obrazie, co sprawia, że zrzut ekranu jest łatwiejszy do przejrzenia niż opis. Należy komentować na zrzucie ekranu, gdzie jest błąd, na przykład tekst przycięty na krawędzi, tak jak na dokumencie. Agent wprowadza poprawkę bez ponownego uruchamiania procesu.
Dlaczego skanuje w jednym miejscu, a nie w innym?
Powtarza się kilka tych samych przyczyn i każda z nich daje kod kreskowy, który wygląda poprawnie, ale nie daje się odczytać. Wskazanie prawdopodobnej przyczyny w zadaniu oszczędza agentowi rundy zgadywania.
| Objaw | Przyczyna | Zapytaj o |
|---|---|---|
| Działa dobrze w testach, zawodzi na zdjęciach z telefonu | Cała ramka, każdy format | ExpectBarcodeTypes, CropArea, liczba odczytów |
| Rozmyty lub o niskim kontraście, nic nie znaleziono | Obraz wymaga korekcji | Najmniejszy filtr, który działa |
| Wartości z obrazów bez kodu kreskowego | Szum odczytany jako symbol | RemoveFalsePositive, ConfidenceThreshold |
| Stare skanery odrzucają etykiety nieangielskie | Nagłówek ECI UTF-8 | Kompromis EciMode, przed jakąkolwiek zmianą |
Dodatkowe filtry obrazu kosztują dokładność, więc agent powinien zatrzymać się na pierwszym, który usuwa błąd. W przypadku fałszywych wyników pozytywnych należy poprosić o dowód na obrazach, o których wiadomo, że nie zawierają kodu kreskowego. Przykład progu pewności pokazuje, jak działa ten próg minimalny.
Poradniki Kod kreskowy nierozpoznany, fałszywe wyniki pozytywne i Kodowanie ECI szczegółowo wyjaśniają każdą przyczynę.
W jakim stanie powinien być projekt, zanim zlecisz pracę agentowi?
Należy zacząć od projektu, który już się kompiluje. Jeśli agent musi zgadywać, której biblioteki kodów kreskowych użyć, albo najpierw naprawić nieudany build, poświęci swój przebieg na niewłaściwy problem.
Gdy build jest czysty, przekaż agentowi samą konfigurację, ponieważ błędy wersji i nazwy pakietów zaczynają się podczas instalacji.
Set this project up for barcode work, then report back with the facts I will
need in later tasks.
Install BarCode (IronBarcode), leaving every other package reference alone.
Wire the license key to come from IRONBARCODE_LICENSE_KEY, or from a config
file that is already in .gitignore. Add it to .gitignore if it is not.
In your Walkthrough, give me the resolved version number and the
PackageReference line exactly as they ended up in the .csproj.
Rozpoznana wersja to fakt, który można wkleić do późniejszych zadań. Sprawdzenie .gitignore zamyka najczęstszą drogę wycieku kluczy do publicznych repozytoriów. A ponieważ IronBarcode zgłasza wyjątek LicensingException, gdy nie zastosowano ważnego klucza, brakujący klucz pojawia się już przy pierwszym uruchomieniu agenta.
Jednorazowo utwórz plik z instrukcjami obszaru roboczego w katalogu głównym repozytorium. Antigravity odczytuje stałe instrukcje z AGENTS.md, tego samego pliku, którego używa ChatGPT Codex.
Umiejętności (skills) są drugą częścią tej konfiguracji. Antigravity szuka pliku SKILL.md w .agents/skills/<name>/ i na początku rozmowy widzi tylko nazwę i opis każdej umiejętności, czytając pełne instrukcje, gdy zadanie wydaje się istotne. Umieszczenie pliku skill.md z IronBarcode jako .agents/skills/ironbarcode/SKILL.md nic więc nie kosztuje w niezwiązanych zadaniach, a /ironbarcode wczytuje go na żądanie. Zapisz, że IronBarcode jest biblioteką kodów kreskowych, jej pakiet to BarCode, kod musi używać wyłącznie udokumentowanych API, a klucz licencyjny nigdy nie jest wpisywany bezpośrednio w kod. Dzięki temu nie trzeba powtarzać tych zasad w każdym zadaniu. Jedno zadanie tworzy plik.
Draft AGENTS.md for the repository root as a plan Artifact first, so I can
comment on it before anything is written to disk.
It needs a Barcodes section covering: IronBarcode (NuGet package BarCode,
namespace IronBarCode) handles barcodes here and nothing else is allowed to; https://ironsoftware.com/barcode/csharp/llms.txt is read
before any barcode code is written and only APIs documented there are used;
https://ironsoftware.com/barcode/csharp/skill.md is saved as
.agents/skills/ironbarcode/SKILL.md so it loads as a skill; every generated
barcode is decoded and compared with its input before a task is reported as
done.
Once I approve the draft, write the file and attach the diff.
Jak zdelegować pracę z generowaniem i migracją kodów kreskowych?
Dla zadań generacyjnych opisz kody kreskowe i dowód, który chcesz otrzymać, a strukturę kodu pozostaw agentowi.
Build a shipping label path that I can check without running anything myself.
One class renders a tracking number as a Code 128 PNG, 400 by 120, with the
value printed under the bars. A second class reads that PNG back and returns
the tracking number, or null when there is nothing to find. Put them where the
other services live and make the read async.
Then push a spread of tracking numbers, short and long, through both classes and
attach the written and decoded values as a table. Every row matches, or you tell
me which one did not and why.
Plan wdrożeniowy wymienia pliki i metody, zanim zostaną utworzone. Użyj Walkthrough, aby potwierdzić, że kod został uruchomiony, a nie tylko skompilowany. Każda składowa IronBarcode wymieniona w planie powinna występować w dokumentacji API, a sprawdzenie planu, zanim powstanie kod, jest tańsze niż późniejsze przeglądanie logu kompilacji.
Zlecanie jest najbardziej pomocne w przypadku migracji, które są powtarzalne, żmudne i łatwo je wykonać prawie dobrze. Trzymaj analizę i wdrożenie jako osobne kroki i kieruj agenta do samego pliku.
/plan Labels/LegacyBarcodeService.cs is built on a different barcode library. I
want a plan Artifact before any code, so I can annotate it rather than unpick a
diff.
Work out what the file actually does today, symbology by symbology, including
the options it sets. Against each one, put the IronBarcode call that replaces
it and the documentation page you took it from. Flag anything that has no clean
equivalent instead of inventing one.
Nothing gets written to disk until I have commented on the plan.
Jeśli otrzymany zostanie przepisany kod, zanim uzgodniony zostanie plan, trzeba go będzie przeglądać wiersz po wierszu. Artefakt planu można natomiast poprawić jednym komentarzem, a Antigravity pozwala dodawać adnotacje bez utraty postępu. Po zatwierdzeniu planu następne zadanie powinno mieć wąski zakres. Zaimplementować plan i nie zmieniać publicznych sygnatur metod, aby inny kod wciąż działał. Upewnić się, że każda symbolika wciąż odczytuje te same wartości, i zgłosić różnice.
Poproś agenta, aby przy każdym odwzorowaniu podał link do strony dokumentacji, na której się opiera. Jeśli nie można wskazać strony, traktuj odwzorowanie jako niezweryfikowane. W przypadku zapisu korzystaj z przewodników po kodach kreskowych 1D i kodach kreskowych 2D. W przypadku odczytu zobacz Samouczek czytnika kodów kreskowych.
Kiedy warto uruchomić więcej niż jednego agenta?
Zamiast uruchamiać zadania po kolei, uruchomić kilku agentów z Antigravity 2.0 i przeglądać ich Artefakty w miarę, jak każdy z nich kończy pracę.
Rozsądny podział migracji kodów kreskowych polega na tym, że jeden agent przenosi starszą usługę etykiet na IronBarcode, a drugi pisze testy zapisu i odczytu (round-trip) dla jej wyników. Drugi agent może rozpocząć natychmiast, ponieważ testy sprawdzają zdekodowane wartości, a nie implementację.
Uruchomić oba jednocześnie.
Agent A: carry out the approved migration plan on Labels/LegacyBarcodeService.cs.
Public method signatures stay exactly as they are, because callers elsewhere in
the solution depend on them. Attach the diff to your Walkthrough.
Agent B: build the xUnit suite that will judge Agent A's work. Write it against
the public signatures, not against anything A does internally, so it compiles
before A finishes. Cover a round trip per supported symbology, an empty image
returning no results, and EAN-13 refusing a value with letters in it. Assert on
decoded values and formats only.
When both of you are done, run B's suite against A's build and put the pass
table in B's Walkthrough. A green suite that never ran against A's code proves
nothing.
Porównanie bajt po bajcie tu nie wyjdzie, ponieważ dwóch agentów uruchamianych równolegle może nie produkować identycznych PNG. To, co musi się zgadzać, to wartość, która wychodzi jako rezultat.
Opcje czytnika dostrojone do etykiet zwrotów sprawdzają się również przy paletach przychodzących, listach kompletacyjnych i dowodach dostawy. Zarejestruj działającą konfigurację w AGENTS.md lub pliku umiejętności, a każdy nowy skaner kosztuje mniej niż pierwszy.
Jak debugować awarie wdrożeniowe na Linux, Docker lub Azure?
Wdrożenie to miejsce, gdzie agent z dostępem do terminala przewyższa recenzenta czytającego ślad stosu, ponieważ może otworzyć obraz i sprawdzić go, zamiast snuć domysły na jego temat.
Przekazać agentowi błąd w niezmienionej postaci.
Our container build decodes nothing. The same code is fine on a Windows
developer machine. This is the exception:
[EXCEPTION AND STACK TRACE GO HERE]
Go and look: which BarCode package does the .csproj pull, and does the image
carry the native dependencies IronBarcode needs on Linux? Use the terminal,
do not reason about it from memory.
Tell me the cause first. The C# is out of scope unless you can show me the
fault is in it.
Ogranicz zadanie do pliku projektu i Dockerfile. Bez tego ograniczenia, agent mógłby zignorować wyjątek i zaznaczyć zadanie jako ukończone. Skieruj agenta do przewodników Docker na Linux i pakiety NuGet, zamiast polegać na pamięci modelu.
Dzięki temu samemu dostępowi do terminala agent odpowiada też na pytania dotyczące dokumentacji. Zapytać, które ustawienia BarcodeReaderOptions wpływają na prędkość lub dokładność i które z nich projekt już ustawia, a agent sprawdza dokumentację API, zanim odpowie.
Jakie dowody otrzymujesz na koniec?
Plan przed uruchomieniem i Walkthrough po nim platforma zapewnia domyślnie. Zapisane i zdekodowane wartości dodaje zadanie i to właśnie je warto dołączyć do pull requesta.
Dla tego samego standardu stosowanego do pojedynczego zadania z pustego projektu, przeczytaj Przewodnik po asystentach kodowania AI i agentach.
Rozwiązywanie problemów
- Zastosuj klucz licencyjny w IronBarcode, gdy log terminala pokazuje, że już pierwsze uruchomienie kończy się błędem.
- Kod kreskowy nierozpoznany, gdy wiersz w tabeli agenta nie chce się zgadzać.
- Pakiety NuGet IronBarcode, aby przypiąć pakiet wskazywany w zadaniach i w
AGENTS.md. - Uruchom IronBarcode w Docker na Linux, gdy etykieta zweryfikowana w przeglądarce przestaje działać po umieszczeniu w kontenerze.
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.