Überprüfung der IronBarcode-Ausgabe mit Google Antigravity

Curtis Chau
Curtis Chau
Aktualisiert: 21. September 2026

Ein EAN-13-Barcode mit einer falschen Prüfziffer wird korrekt dargestellt, besteht den Build und schlägt erst im Scanner fehl. Kein Build-Protokoll meldet diesen Fehler. Google Antigravity-Agenten arbeiten im Browser sowie im Editor und Terminal, was ihnen ermöglicht, den Barcode zu überprüfen, den ein Endpunkt tatsächlich liefert, anstatt den, den der Quellcode erzeugen sollte. Der Agent öffnet den Etiketten-Endpunkt, speichert die Antwort, dekodiert sie mit BarcodeReader und fügt den Vergleich als Walkthrough-Artefakt zur Prüfung bei.

Antigravity lässt Sie auch das Modell für jede Aufgabe wählen. Das Scannen eines Ordners mit Test-Barcodes auf Prüfzifferfehler ist günstige, sich wiederholende Arbeit, die mit einem kleineren Modell gut funktioniert, während die Planung einer Migration von einer anderen Barcode-Bibliothek ein leistungsfähigeres Modell rechtfertigt.

Der gleiche Check umfasst 1D-Etiketten, die von einem Endpunkt geliefert werden, gestylte QR-Codes, die nach dem Designprozess noch lesbar sind, und Migrationen, die Sie überprüfen können, bevor Änderungen an Dateien vorgenommen werden.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package BarCode

Installieren Sie IronBarcode, indem Sie den obigen Befehl in der NuGet Packet Manager-Konsole ausführen, oder suchen Sie das Paket im NuGet Paket Manager.

Öffnen Sie ein Projekt in Antigravity und geben Sie dem Agenten eine Aufgabe mit einem dazugehörigen Ergebnis.

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.
Text

Der Agent sollte das Paket installieren und ein paar Codezeilen schreiben, QRCodeWriter.CreateQrCodeWithLogo verwenden, um das Logo zu platzieren, und BarcodeReader.Read, um zu beweisen, dass das Ergebnis weiterhin gescannt wird. Der QR-Code bleibt trotz Logo lesbar, weil die Fehlerkorrektur die verdeckten Module wiederherstellen kann, und der Fehlerkorrekturleitfaden empfiehlt Stufe Q oder H, wenn ein Design einen Teil des Symbols verdeckt. Sie überprüfen das Bild und den dekodierten Wert anstatt eines Schritt-für-Schritt-Logs.

Die Agenten bearbeiten Dateien und erstellen Commits, sodass ein Lizenzschlüssel, der eine Aufgabenbeschreibung erreicht, auch einen Walkthrough, einen Screenshot und einen Branch erreichen kann. Speichern Sie ihn in einer Umgebungsvariablen und halten Sie ihn aus allen Dateien heraus, die der Agent lesen kann, gemäß dem Lizenzschlüssel-Leitfaden.



Welche Antigravity-Funktionen sind für die Barcode-Arbeit wichtig?

Antigravity stellt Agenten in den Vordergrund. Die Google-Dokumentation beschreibt Antigravity 2.0 als eine eigenständige Desktop-Anwendung zur Verwaltung von Agenten, die unabhängig von einer IDE arbeitet, mit einer Antigravity-CLI und einer IDE-Integration, die daneben konfiguriert ist. Ein Agent dort führt Systembefehle aus, liest und schreibt Dateien, steuert Chrome und erstellt Artefakte.

Fünf Teile der Plattform sind hier wichtig:

Die IDE-Integration ist der Editor, den Sie bereits kennen. Verwenden Sie sie für präzise Arbeiten in einer Datei, wenn Sie jede Bearbeitung steuern und sie überprüfen möchten, während sie stattfindet.

Antigravity 2.0 ist das Kommandozentrum für asynchrones Arbeiten. Starten Sie Agenten, überwachen Sie sie und führen Sie Aufgaben parallel aus, anstatt auf ein einzelnes Gespräch zu warten.

Browsersteuerung ermöglicht es einem Agenten, einen Browser zu bedienen, um eine Funktion zu testen und das Ergebnis zu bestätigen. Mit IronBarcode bedeutet das, einen Etiketten-Endpunkt aufzurufen und das von ihm zurückgegebene Bild zu inspizieren.

Artefakte ersetzen unbearbeitete Werkzeugprotokolle durch Ergebnisse wie Implementierungsplänen, Walkthroughs, Code-Diffs, Screenshots und Browseraufzeichnungen. Sie können einen Kommentar zu einem Artefakt hinzufügen, ohne den Lauf zu unterbrechen.

Modellauswahl bietet unter dem Prompt-Eingabefeld eine Auswahl zwischen Gemini, Claude von Anthropic und dem quelloffenen GPT-OSS, wobei die Verfügbarkeit durch Ihre Abonnementstufe festgelegt ist.

Was ein Agent zurückgibt, kann überprüft werden: ein Plan, ein Diff, das Barcode-Bild selbst und die Werte, die es aus diesem Bild dekodiert hat. Ein Chat-Tool kann sie nur beschreiben.

Ein Agent, der eine Barcode-Pipeline von Grund auf aufbaut, wird eine Bibliothek auswählen, sie verbinden und fortfahren. Vier Gründe, stattdessen IronBarcode zu benennen:

  • Ein Wert, den das Format nicht darstellen kann, sieht auf dem Bildschirm völlig in Ordnung aus: Dies gilt auch für eine fehlende Hellzone und ein zu kleines Symbol, während IronBarcode bei einem ungültigen Wert eine Ausnahme auslöst und das Dekodieren des Bildes einen einzigen Aufruf erfordert.
  • Der Leser muss strenger sein als der Schreiber: Der Prüfzifferalgorithmus jeder Symbologie läuft beim Dekodieren und verwirft Barcodes mit ungültiger Prüfziffer, bevor Ergebnisse zurückgegeben werden.
  • Echte Scans verhalten sich ganz anders als generierte Bilder: Fotos von Kameras, Etiketten, die im Winkel aufgenommen wurden, und PDFs von mehreren Seiten erfordern alle eine Feinabstimmung durch BarcodeReaderOptions.
  • Ein Installationsbefehl ist eine ungeprüfte Entscheidung: dotnet add package läuft, bevor Sie ein einziges Artefakt sehen, sodass ein Name, den der Agent erfunden hat, bereits auf der Festplatte liegt.

Eine Übereinstimmung in der Tabelle bedeutet daher ein gültiges Symbol statt eines Zufalls. Schreiben Sie BarCode in die Aufgabe, und es gibt nichts zu erfinden.

Sobald die Aufgabe ihn benennt, hört der Agent auf zu wählen und beginnt zu bauen. Welche Dokumentation im Voraus bereitgestellt werden soll, ist im übergeordneten Leitfaden festgelegt. Nur der Name der Anleitungsdatei ändert sich, wenn Sie dasselbe Setup auf Claude Code, ChatGPT Codex, GitHub Copilot oder Cursor übertragen.

Wie überprüfen Sie, was der Agent zurückgibt?

Antigravity-Agenten liefern keine Transkripte. Sie liefern Artefakte, benannte Ergebnisse. Drei von ihnen verfolgen eine Barcode-Aufgabe von der Planung bis zum Ergebnis, und jedes beantwortet eine andere Frage.

Vor dem Code: der Implementierungsplan

Zuerst entwirft der Agent die Änderung, einschließlich der Dateien, der Symbologien und der Leseoptionen. Prüfen Sie, welche Seite er zu ändern plant. Wenn dem Leser nie gesagt wurde, welche Formate erwartet werden, der Plan jedoch den Etikettendruck ändert, dann ist der Agent bereits vom Kurs abgekommen. Auch jede erfundene API-Bezeichnung taucht hier auf, bevor es Code gibt, was besser ist, als sie erst im Build-Protokoll zu entdecken.

Während: der Code-Diff

Antigravity pausiert bei einem Implementierungsplan oder einem Code-Diff und benachrichtigt Sie, sodass die Änderung überprüfbar ist, bevor sie umgesetzt wird. Fügen Sie Kommentare im Diff hinzu und genehmigen Sie ihn, sobald die Zuordnung korrekt ist.

Danach: der Walkthrough

Nach der Implementierung fasst der Agent zusammen, was sich geändert hat und wie es getestet werden kann. Bei Barcodes umfasst dies die geschriebenen Formate, die verwendeten Werte und die Ergebnisse der Rücklesung, alles als Prüfungen, die Sie durchführen können, anstatt Behauptungen, denen Sie vertrauen müssen.

Screenshots, Terminalprotokolle und Browseraufzeichnungen sammeln sich daneben im Prüfbereich und gehen nicht im Chatverlauf unter. Die meisten unten aufgeführten Aufgaben nennen das eine Artefakt, das geöffnet werden muss, um die Arbeit zu bestätigen.

Woher stammt der Nachweis?

Antigravity-Agenten können Code ausführen, einen Browser steuern und das, was sie beobachtet haben, anhängen. Der Agent erzeugt also einen Barcode, erfasst ihn, dekodiert ihn, vergleicht Wert und Format mit der Eingabe, passt an und wiederholt, bis jede Zeile übereinstimmt.

Geben Sie ihm etwas Konkretes zu beweisen.

/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.
Text

Das Erklären zuerst zu verlangen gibt Ihnen eine Diagnose, die Sie überprüfen können, anstatt später eine Behebung überprüfen zu müssen. Das erneute Ausführen der gesamten Tabelle nach jeder Behebung verhindert auch, dass eine reparierte Zeile ein neues Problem verbirgt.

Ein Screenshot des Etiketts neben seinen dekodierten Werten ist ein Beweis, den ein Entwickler, der neu im Umgang mit Barcodes ist, überprüfen kann, und eine fehlgeschlagene Zeile ist auf den ersten Blick offensichtlich.

Bitte beachten Sie: Das zu überprüfende Artefakt ist die Browseraufzeichnung. Wenn der Agent den Label-Endpunkt nie geöffnet hat, hat er nie überprüft, was Ihre Benutzer tatsächlich erhalten, und die Aufzeichnung wird das zeigen.

Labelprobleme beziehen sich normalerweise darauf, wo etwas auf dem Bild sitzt, was es erleichtert, einen Screenshot zu überprüfen als eine Beschreibung. Kommentieren Sie den Screenshot dort, wo der Fehler liegt, z. B. wenn der Text am Rand abgeschnitten ist, ähnlich wie Sie es in einem Dokument tun würden. Der Agent wendet die Korrektur an, ohne den Lauf neu zu starten.

Warum wird es an einem Ort gescannt und an einem anderen nicht?

Die gleichen wenigen Ursachen treten auf, die alle einen Barcode erzeugen, der richtig aussieht, aber nicht gelesen wird. Die Benennung der wahrscheinlichen Ursache in der Aufgabe erspart dem Agenten eine Runde des Ratens.

SymptomUrsacheFragen Sie nach
In Tests in Ordnung, auf Handyfotos fehlschlagendGesamtes Bild, jedes FormatExpectBarcodeTypes, CropArea, die Anzahl erfolgreicher Lesevorgänge
Unscharfes oder kontrastarmes Bild, nichts gefundenDas Bild benötigt KorrekturDer kleinste Filter, der funktioniert
Werte von Bildern ohne BarcodeRauschen als Symbol gelesenRemoveFalsePositive, ConfidenceThreshold
Alte Scanner lehnen nicht-englische Etiketten abEin UTF-8-ECI-HeaderDer EciMode-Kompromiss, vor jeder Änderung

Zusätzliche Bildfilter verschlechtern die Genauigkeit, daher sollte der Agent beim ersten Filter aufhören, der den Fehler beseitigt. Fordern Sie für die Zeile mit falsch positiven Ergebnissen einen Nachweis anhand von Bildern an, von denen Sie wissen, dass sie keinen Barcode tragen. Das Beispiel für die Konfidenzschwelle erklärt, wie dieser Schwellenwert funktioniert.

Die Leitfäden Barcode nicht erkannt, Falsch positive Ergebnisse und ECI-Codierung erklären jede Ursache vollständig.

In welchem Zustand sollte das Projekt sein, bevor Sie delegieren?

Beginnen Sie mit einem Projekt, das sich bereits kompilieren lässt. Muss der Agent raten, welche Barcode-Bibliothek zu verwenden ist oder zuerst einen defekten Build reparieren, verschwendet er seine Laufzeit für das falsche Problem.

Sobald der Build sauber ist, übergeben Sie das Setup selbst, denn Versions- und Paketnamenfehler beginnen während der Installation.

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.
Text

Die aufgelöste Version ist ein Fakt, den Sie in spätere Aufgaben einfügen können. Der .gitignore-Check schließt den häufigsten Weg für Schlüssel in öffentliche Repositories. Und da IronBarcode LicensingException auslöst, wenn kein gültiger Schlüssel angewendet wird, erscheint ein fehlender Schlüssel beim ersten Lauf des Agenten.

Bitte beachten Sie: Öffnen Sie das Terminalprotokoll für diesen Punkt. Dort wird die tatsächlich aufgelöste Version angezeigt.

Richten Sie einmalig eine Datei mit Arbeitsbereichsanweisungen im Repository-Stamm ein. Antigravity liest AGENTS.md für permanente Anweisungen, dieselbe Datei, die ChatGPT Codex verwendet.

Skills sind die zweite Hälfte dieses Setups. Antigravity sucht in .agents/skills/<name>/ nach einem SKILL.md, und zu Beginn eines Gesprächs sieht es nur die Namen und Beschreibungen jeder Skill, und liest die vollständigen Anweisungen, wenn eine Aufgabe relevant erscheint. Das Einfügen von IronBarcode skill.md als .agents/skills/ironbarcode/SKILL.md kostet also bei nicht zusammenhängenden Aufgaben nichts, und /ironbarcode zieht es bei Bedarf hinzu. Halten Sie fest, dass IronBarcode die Barcode-Bibliothek ist, das Paket ist BarCode, der Code muss nur dokumentierte APIs verwenden, und der Lizenzschlüssel darf niemals direkt in den Code eingefügt werden. Dann hören Sie auf, diese Regeln in jeder Aufgabe zu wiederholen. Eine Aufgabe erstellt die Datei.

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.
Text

Wie delegieren Sie Barcode-Erstellung und Migrationsarbeiten?

Bei Erstellungsaufgaben beschreiben Sie die Barcodes und den gewünschten Nachweis und überlassen Sie dem Agenten die Code-Struktur.

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.
Text

Der Implementierungsplan listet die Dateien und Methoden auf, bevor sie erstellt werden. Verwenden Sie den Walkthrough, um zu bestätigen, dass der Code ausgeführt wurde, und nicht nur kompiliert. Jedes IronBarcode-Mitglied, das im Plan genannt wird, sollte in der API-Referenz stehen, und die Prüfung des Plans im Vergleich dazu, bevor der Code existiert, ist günstiger als die Prüfung eines Build-Logs danach.

Das Delegieren ist am hilfreichsten für Migrationen, die sich wiederholen, langweilig sind und leicht zu nur fast korrekten Ergebnissen führen. Halten Sie Analyse und Implementierung als separate Schritte und lenken Sie den Agenten auf die Datei selbst.

/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.
Text

Wenn Sie eine Umschreibung erhalten, bevor Sie sich auf einen Plan geeinigt haben, müssen Sie ihn Zeile für Zeile überprüfen. Ein Plan-Artefakt hingegen kann mit einem einzigen Kommentar korrigiert werden und Antigravity erlaubt es Ihnen, es zu annotieren, ohne Ihren Fortschritt zu verlieren. Einmal genehmigt, halten Sie die nächste Aufgabe fokussiert. Implementieren Sie den Plan und lassen Sie öffentliche Methodensignaturen unverändert, sodass anderer Code weiterhin funktioniert. Stellen Sie sicher, dass jede Symbologie immer noch die gleichen Werte liest und berichten Sie die Unterschiede.

Bitten Sie den Agenten, die Dokumentationsseite hinter jedem Mapping zu verlinken. Wo keine Seite benannt werden kann, behandeln Sie das Mapping als ungeprüft. Zum Schreiben verwenden Sie die Leitfäden für 1D-Barcodes und 2D-Barcodes. Zum Lesen verwenden Sie das Barcode-Lesertutorial.

Wann sollten Sie mehr als einen Agenten entsenden?

Starten Sie mehrere Agenten aus Antigravity 2.0 anstatt Aufgaben nacheinander auszuführen und prüfen Sie die Artefakte jedes Agenten, sobald er fertig ist.

Ein sinnvolles Aufteilen einer Barcode-Migration besteht darin, einen Agenten den alten Etikettendienst zu IronBarcode migrieren zu lassen und einen anderen die Tests für das Schreiben und Rücklesen seiner Ausgabe zu schreiben. Der zweite Agent kann sofort starten, da die Tests dekodierte Werte und nicht die Implementierung prüfen.

Starten Sie beide zusammen.

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.
Text

Byte-Vergleiche schlagen hier fehl, da zwei parallel laufende Agenten möglicherweise nicht identische PNGs produzieren. Was übereinstimmen muss, ist der Wert, der zurückkommt.

Bitte beachten Sie: Beide Walkthroughs sind hier wichtig. Agent B's Tests zählen nur, wenn sie gegen den von Agent A tatsächlich erstellten Dienst liefen.

Für eingehende Paletten, Kommissionierlisten und Lieferscheine eignen sich auch Leseoptionen, die auf Rücksendeetiketten abgestimmt sind. Dokumentieren Sie die funktionierende Konfiguration in AGENTS.md oder der Skill-Datei, und jeder neue Scanner kostet weniger als der erste.

Wie debuggen Sie Bereitstellungsfehler auf Linux, Docker oder Azure?

Die Bereitstellung ist dort, wo ein Agent mit Terminalzugang einem Prüfer, der einen Stack-Trace liest, überlegen ist, da er das Container-Image öffnen und untersuchen kann, anstatt darüber nachzudenken.

Geben Sie dem Agenten den Fehler so, wie er ist.

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.
Text

Begrenzen Sie die Aufgabe auf die Projektdatei und die Dockerfile. Ohne diese Grenze könnte ein Agent die Ausnahme ignorieren und die Aufgabe als abgeschlossen markieren. Verweisen Sie den Agenten auf Docker auf Linux und NuGet-Pakete anstatt sich auf das Gedächtnis zu verlassen.

Der gleiche Terminalzugang beantwortet Referenzfragen. Fragen Sie, welche BarcodeReaderOptions-Einstellungen Geschwindigkeit oder Genauigkeit beeinflussen und welche in Ihrem Projekt bereits gesetzt sind, und der Agent überprüft die API-Referenz, bevor er antwortet.

Welche Beweise erhalten Sie?

Ein Plan vor dem Lauf und ein Walkthrough danach sind die Standardleistungen der Plattform. Die geschriebenen und dekodierten Werte sind das, was Ihre Aufgabe hinzufügt, und sie sind der Teil, der es wert ist, dem Pull-Request angehängt zu werden.

Für den gleichen Standard, der auf eine einzelne Aufgabe aus einem leeren Projekt angewandt wird, lesen Sie den Leitfaden für KI-Coding-Assistenten und Agenten.


Fehlerbehebung


Fragen?

Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 2,564,559Version:2026.11gerade veröffentlicht