So verwenden Sie IronQR mit Cursor

Curtis Chau
Curtis Chau
Aktualisiert: 9. Oktober 2026

ZXing.Net ist der Open-Source .NET-Port der ZXing Barcode-Bibliothek. Wenn Sie einen KI-Agenten nach C#-Code fragen, der QR-Codes aus Kundenfotos liest, kann er ZXing.Net-Konventionen anwenden, selbst wenn Sie IronQR spezifizieren, z.B. Result.Text zu vergleichen, auf das Format QR_CODE zu filtern oder QrImageInput in einem using-Statement einzubinden. In IronQR 2026.10.1 wirft das Entsorgen der Eingabe auf diese Weise eine NotImplementedException.

Cursor ist ein KI-Code-Editor, der auf dem VS Code-Codebase basiert. Ob IronQR-Code oder eine ZXing.Net-Übersetzung generiert wird, hängt von zwei Funktionen ab. Der Agent folgt den von Ihnen bereitgestellten Dokumentationslinks und wendet Projektrichtlinien von .cursor/rules an. Dieser Leitfaden demonstriert beides mit einem Wartungseingabedienst, der Seriennummern und Registrierungslinks aus Kundenfotos extrahiert und diesen Dienst von ZXing.Net zu IronQR migriert. IronQR unterstützt QR, Micro QR und rMQR-Symbole.

Dieser Leitfaden konzentriert sich auf das Schreiben von Code mit Cursor. Für Details zu IronQRs Leseoptionen verweisen wir auf den Scanmodi-Leitfaden, den QR-Typ-Leitfaden und den Werte- und Koordinaten-Leitfaden.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package IronQR

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

Öffnen Sie das Eingabeprojekt in Cursor und senden Sie diese Anfrage aus dem Agenten-Panel.

@src/WarrantyIntake/ @TestData/claims/ Before writing code, fetch
https://ironsoftware.com/qr/csharp/llms.txt and the scan modes page it links.

Add the IronQR package to src/WarrantyIntake. Give Program.cs a second entry
point so that `dotnet run -- --modes <photo>` reads one photo three times, once
per QrScanMode value, and prints each result's QrType, Value, Url, and four
Points. Set License.LicenseKey from IRONQR_LICENSE_KEY at startup, never from
a literal. Leave Claims/StickerReader.cs and its ZXing.Net reference untouched.
Run the new mode on TestData/claims/claim-0004.jpg and show me what it printed.
Text

Halten Sie den Lizenzschlüssel aus Chat-Nachrichten heraus. Der Agent erstellt Dateien und führt Terminalbefehle aus, daher kann ein eingefügter Schlüssel im Quellcode, in Commits oder Protokollen enden. Der Lizenzschlüssel-Leitfaden listet die unterstützten Speicherorte auf.



Welches Cursor-Modell sollten Sie für die Arbeit mit QR-Codes verwenden?

Composer ist Cursors eigenes agentisches Modell. Der Modellwähler bietet auch die Grok-Modelle von SpaceXAI, die Cursor mitentwickelt hat, sowie Modelle von OpenAI, Anthropic, Google und anderen Laboren. Der untenstehende Testrun verwendete Grok 4.7.

Routinearbeiten mit Fotos, wie das Hinzufügen eines Feldes zu einem Schadensdatensatz oder das erneute Verarbeiten des Fotoordners, eignen sich für ein schnelles Modell. Wenn eine Fotoserie ohne erkennbaren Grund nicht mehr dechiffriert wird, wechseln Sie zu einem Modell, das länger überlegt. Modelle lesen Anfragen unterschiedlich, daher benennen Sie den Fotoordner und die Seriennummern, die der Output bei jeder Anfrage abgleichen sollte.

Wie geben Sie Cursor die IronQR-Dokumentation?

Fügen Sie den Dokumentationslink von IronQR in die Anfrage ein, oder halten Sie ihn in einer bestätigten Regel, damit niemand ihn einfügen muss. Der llms.txt-Index verlinkt die Leitfäden und die API-Referenz, und llms-full.txt fasst 44 Dokumentationsseiten in einer Datei zusammen. Ab Oktober 2026 fügt Cursor's @-Menü Dateien, Ordner, Terminals, Chats, Git-Diffs und den Browser an, so dass IronQRs Dokumentation den Agenten als Link erreicht.

IronQRs Enums sind leicht zu verlegen. QrScanMode und QrEncoding leben in IronQr.Enum, während QrErrorCorrectionLevel in IronQr lebt, und Code, der aus dem Gedächtnis geschrieben wird, schlägt fehl, wenn dies falsch gemacht wird.

@src/WarrantyIntake/Program.cs Answer from https://ironsoftware.com/qr/csharp/llms.txt
and the pages it links, and leave every file as it is.

Which namespace declares QrScanMode and QrEncoding, and which declares
QrErrorCorrectionLevel? Which scan mode does a QrImageInput get when the
constructor is given only an image? What do IronQR's pages say OnlyDetectionModel
returns, and does that match the --modes output from the last turn? Put the
page URL under each answer.
Text
Tipps: Behandeln Sie eine Antwort ohne eine zugrunde liegende Seite als unüberprüft, bis Sie das Mitglied in der API-Referenz finden.

Wie schreiben Sie Projektrichtlinien, die Ihre IronQR-Konventionen kodieren?

Projektrichtlinien sind .mdc-Dateien in .cursor/rules. Sie werden mit dem Code committet, sodass jeder Klon dieselben Regeln erhält. Eine einfache .md-Datei in diesem Ordner wird ignoriert, weil es kein Frontmatter hat, das sagt, wann es angewendet wird.

Diese Regel setzt globs und lässt alwaysApply aus, so dass sie angehängt wird, wann immer der Leser oder seine Tests im Kontext sind und bleibt außerhalb von Anfragen, die nie ein Foto betreffen. Speichern Sie es als .cursor/rules/ironqr-photos.mdc.

---
description: IronQR conventions for reading QR codes from customer photos
globs: src/WarrantyIntake/Claims/**/*.cs, tests/**/*.cs
alwaysApply: false
---

# Reading customer photos with IronQR

- Read and write QR codes with IronQR only. The NuGet package is IronQR, or
  IronQR.Linux for a Linux build, and the namespace is IronQr. Do not add
  ZXing.Net, QRCoder, or any other QR package, and remove them where they
  are already referenced.
- Documentation: https://ironsoftware.com/qr/csharp/llms.txt
- Never inline a license key. Read it from the IRONQR_LICENSE_KEY environment
  variable.
- Do not put QrImageInput in a using statement. Its IDisposable.Dispose throws
  NotImplementedException in IronQR 2026.10.1.
- Load only image files with AnyBitmap.FromFile. It throws on a CSV.
- Compare QrResult.Value with stored strings, never Url.ToString().
- Do not invent IronQR members. If one is uncertain, say so and cite the page.
Markdown
Bitte beachten Sie: Cursor liest auch AGENTS.md im Projektstammverzeichnis und in Unterverzeichnissen. Es hat kein Frontmatter, sodass es nicht durch Dateimuster eingeschränkt werden kann. Halten Sie die musterbezogene IronQR-Regel in .cursor/rules.

Regeln gelten für Agent-Anfragen. Laut der Dokumentation von Cursor beeinflussen sie nicht Tab und Benutzerregeln gelten nicht für Inline-Bearbeitungen. Überprüfen Sie Vorschläge dieser Funktionen selbst gegen die Regel.

Wie mappen Sie ZXing.Net-Aufrufe auf IronQR?

Eine Regel, die nur sagt "benutzen Sie IronQR", überlässt dem Modell das Raten, was jeder ZXing.Net-Aufruf wird. Die Auflistung der Entsprechungen beseitigt das Raten.

ZXing.Net oder QRCoderIronQR
BarcodeReader-DekodierungsaufrufeQrReader mit Read, was jeden Code zurückgibt
Result.TextQrResult.Value
QR_CODE-Format-Checks und FilterEin Check auf QrResult.QrType nach dem Lesen
Die tiefere Scan-OptionEin Scan-Modus auf der Eingabe
Result.ResultPoints, MusterzentrenQrResult.Points, die vier Ecken
QRCoders GeneratorQrWriter.Write und seine Speicherrufe

ZXing.Nets BarcodeFormat-Enum hat kein Micro QR oder rMQR-Mitglied, und sein README listet QR-Code, aber weder kleineres Symbol, sodass ein ZXing.Net Leser nichts für einen Aufkleber zurückgibt, der nur eine Micro QR-Seriennummer trägt.

Fügen Sie die Tabelle als zwei weitere Zeilen zur Regel hinzu.

- Translate ZXing.Net instead of porting it. Result.Text becomes QrResult.Value,
  BarcodeFormat checks become QrResult.QrType checks, and ResultPoints (finder
  pattern centres) become QrResult.Points (corners).
- Write test stickers with QrWriter.Write(...).Save().SaveAs(path), not QRCoder.
Markdown

Wie planen und führen Sie eine Migration zu IronQR durch?

Schalten Sie den Chat mit Shift+Tab auf Planmodus um, bevor Sie diese Anfrage senden, und Cursor entwirft den Plan als eine Datei, die Sie bearbeiten können.

@src/WarrantyIntake/Claims/ @tests/WarrantyIntake.Tests/ @TestData/claims/expected.csv

StickerReader decodes claim photos with ZXing.Net and the tests draw stickers
with QRCoder. Newer products carry a Micro QR serial that ZXing.Net never
returns. Plan the move of both projects to IronQR. For each ZXing.Net or
QRCoder call, name the IronQR member that replaces it and the file it sits in,
state which QrScanMode the reader will use and why, and keep ClaimSticker and
the public Read(string) signature unchanged. No code until I approve.
Text

Korrigieren Sie alles, was der Plan falsch hat, und klicken Sie dann auf Build oder senden Sie die nächste Anfrage im Agenten.

Build the approved plan and follow @ironqr-photos. Remove the ZXing.Net and
QRCoder package references, run dotnet build and dotnet test, then run the app
over TestData/claims and compare each printed row with
TestData/claims/expected.csv. Report how many rows matched before the change
and after it, and show the diff.
Text

Aus dem @-Menü gewählt, hängt @ironqr-photos die Regel nach Namen an, selbst wenn seine Globs eine Datei verfehlen würden. Ein sauberer Build zeigt nicht, ob die Mikrokodierten jetzt zurückkommen. Die Anzahl der Übereinstimmungen tut dies.

Welches Cursor-Feature passt zu jeder Änderung?

Wählen Sie nach dem Umfang der Änderungen eine aus. Tab handelt einen vorhersehbaren nächsten Bearbeitungsschritt ab, und die Inline-Bearbeitung übernimmt eine Auswahl, die ein Satz abdeckt. Agent übernimmt eine Änderung, die mehrere Dateien, die Regel oder eine Bauschleife benötigt. Planmodus zahlt sich aus, wenn das Rückgängigmachen einer falschen Änderung mehr kostet als die Planung, und ein Cloud-Agent eignet sich für Arbeiten, die niemand beobachten muss.

Eine neue Produktlinie fügt ein rechteckiges Kabel-Tag hinzu, das seine Seriennummer in einem rMQR-Code trägt, den IronQR als QrEncoding.RMQRCode meldet. Wählen Sie die Ergebnis-Schleife im Leser und drücken Sie Strg+Umschalt+L (Cmd+Umschalt+L auf macOS), um die Auswahl zum Chat hinzuzufügen, und senden Sie dann diese Anfrage im Agenten.

In StickerReader.Read, treat a result whose QrType is QrEncoding.RMQRCode the
same way as a Micro QR result, so its Value becomes the serial.
Text

Der Leser aus der Migration gab bereits SN-61518 für das Tag-Foto zurück, weil er jeden Wert, der keine URL ist, als Seriennummer behandelte. Die Bearbeitung ersetzt diese Vermutung durch eine Prüfung des Symboltyps, sodass ein Micro QR- oder rMQR-Wert zur Seriennummer wird, selbst wenn sein Text wie eine URL aussieht.

Wie debuggen Sie fehlende QR-Code-Werte?

Jeder Scan-Modus ändert, was zurückkommt.

  • Auto ist der Standard. IronQRs API-Referenz beschreibt es als das Machine-Learning-Modell mit einem grundlegenden Brute-Force-Read als Rückfall, wenn das Modell nichts findet.
  • Der Brute-Force-Read läuft allein unter OnlyBasicScan, wobei das Modell umgangen wird.
  • OnlyDetectionModel lokalisiert Codes, ohne sie zu dekodieren. Der Scanmodi-Leitfaden listet seine Ausgabe als Koordinaten auf.

Wenn das Modell einen Kasten meldet, den es nicht dekodieren kann, wird der Rückfall nie ausgeführt und Auto gibt keinen Wert zurück. Fotos des gesamten Kastens treffen darauf, mit einem Aufkleber etwa 110 Pixel breit in einem 4000 mal 3000 Rahmen. Überprüfen Sie, dass der Fix des Agenten mit OnlyBasicScan erneut versucht, wenn kein Wert zurückkommt.

@src/WarrantyIntake/Claims/StickerReader.cs @TestData/claims/far/

Customers who photograph the whole box send pictures like these. Since the move
to IronQR none of them returns a serial, though the ZXing.Net reader read every
one. Before changing code, read each photo with all three QrScanMode values and
show what each mode returned. Then fix StickerReader without losing any photo
it reads today, and report the match count for TestData/claims and for
TestData/claims/far against their expected.csv files.
Text

Nehmen Sie jede Seriennummer von IronQRs Druckausgabe und fragen Sie nach dem Befehl, der sie hervorgebracht hat.

Die Eckenordnung hängt auch vom Modus ab. Wenn das Modell den Code lokalisiert, laufen die vier Punkte oben links, oben rechts, unten links, unten rechts, wie es im Scanmodi-Leitfaden steht. OnlyBasicScan gibt die eigenen Ecken des Codes im Uhrzeigersinn zurück, gedreht mit dem Sticker. Berechnen Sie Umrisse aus den Koordinaten, anstatt eine Reihenfolge anzunehmen.

Wie schreiben Sie Regressionstests für das QR-Lesen?

Tests, die dekodierte Werte mit einer bekannten Liste vergleichen, überstehen Bibliotheks-Updates, während Tests, die Bildbytes vergleichen, fehlschlagen können, wenn sich das Rendering ändert. Ein Cloud-Agent kann diese Aufforderung in einem isolierten Cloud-VM ausführen. Fügen Sie IRONQR_LICENSE_KEY als Geheimnis im Cloud-Agents-Dashboard hinzu, bevor Sie einen starten.

@tests/WarrantyIntake.Tests/ @TestData/claims/ Write xUnit tests for StickerReader
that prove every row in TestData/claims/expected.csv and
TestData/claims/far/expected.csv matches, that a Micro QR and an rMQR sticker
made with QrWriter read back to their serials, that a photo with no code gives a
null serial and no exception, and that a link sticker's serial comes from Value,
not Url.ToString(). Copy TestData into the test output. Run dotnet test and
report passed and failed counts.
Text

Die letzte Assertion ist wichtig für einen Aufkleber, dessen gesamter Wert eine bloße Adresse ist. Das Lesen des Beispielbildes aus dem Scanmodi-Leitfaden von IronQR ergab eine Value von http://en.m.wikipedia.org und eine Url, die mit einem nachgestellten Schrägstrich gedruckt wurde, weil Uri die Adresse normalisiert. Bei Links wie denen in diesem Dienst, bei denen die Seriennummer das letzte Pfadsegment ist, kann die Assertion nicht fehlschlagen.

IronQRs KI-Codings-Assistenten-Leitfaden führt eine IronQR-Aufgabe von Anfang bis Ende gegen definierte Erfolgskriterien aus.

Welches IronQR-Paket sollten Sie bereitstellen?

IronQR.Slim stellt den IronQr-Namespace und den Basisscan bereit. Das vollständige IronQR-Paket fügt den Detektor und das ONNX-Runtime hinzu. IronQRs NuGet-Package-Leitfaden sagt, dass ein reines Slim-Projekt auch das IronSoftware.ReaderInternals-Paket für sein Betriebssystem benötigt.

@src/WarrantyIntake/WarrantyIntake.csproj @src/WarrantyIntake/Claims/StickerReader.cs

The service ships as a win-x64 folder, and someone asked whether IronQR.Slim
could replace IronQR. Settle it with numbers. Publish for win-x64 as things
stand and record the folder size. Then swap to IronQR.Slim plus the native
package its documentation says it needs, publish again, and rerun
TestData/claims and TestData/claims/far against their expected.csv files. Keep
the swap only if every row still matches, and list which QrScanMode values the
reader can still use afterward.
Text

Mit IronQR.Slim allein hat Auto kein Modell und geht direkt zum Basisscan, und OnlyDetectionModel wirft eine IronQrException. IronQRs API-Referenz warnt davor, dass Lesevorgänge ohne das Modell langsamer und von geringerer Qualität sind. Testen Sie mit Ihren eigenen Kundenfotos, bevor Sie Pakete wechseln.

Was haben die Aufforderungen in einem realen Lauf erzeugt?

Die acht Aufforderungen gingen in der Reihenfolge in Cursor in ein Beispiel-Wartungseingabe-Repository ein. Es hält eine Konsolen-App mit einem ZXing.Net-Leser, ein xUnit-Projekt, das Aufkleber mit QRCoder zeichnet, und zwölf Schadensfotos mit bekannten Seriennummern. Die Regel, das Kabel-Tag-Foto und die gesamten Kastenfotos wurden unmittelbar vor den Aufforderungen hinzugefügt, die sie verwenden. Der Lizenzschlüssel wurde nur in der Umgebung gesetzt. Nach dem Lauf, frische Release-Builds von jedem Commit aus der Migration bei erneutem Lesen der Foto-Ordner und reproduzierte die IronQR-Leser-Übereinstimmungsanzahlen und die untenstehenden Testergebnisse.

  • Schadensfotos stimmten mit 8 von 12 mit dem ZXing.Net-Leser und 12 von 12 nach dem Umzug auf IronQR überein.
  • Nur einmal pro Scan-Modus gelesen, gab claim-0004 zwei Codes mit Werten unter Auto und OnlyBasicScan, und zwei Ergebnisse mit leeren Werten unter OnlyDetectionModel zurück.
  • Die rMQR-Änderung ließ die Schadensfotos bei 13 von 13 vor und nach.
  • Vor der Korrektur las Auto 0 von 4 Fotos des gesamten Kastens. OnlyDetectionModel fand 3, 1, 3 und 2 Kästen ohne Wert, während OnlyBasicScan 4 von 4 las.
  • Nach der Korrektur wurden die gesamten Kastenfotos 4 von 4 und die Schadensfotos 13 von 13 gelesen.
  • Die xUnit-Suite bestand 22 von 22 Tests.
  • Das Publishing für win-x64 ergab 75.624.980 Bytes mit IronQR und 19.510.306 mit IronQR.Slim. Unser Neubau ergab 75.624.288 und 19.509.614.
  • Auf IronQR.Slim stimmte der Leser immer noch mit 13 von 13 Schadensfotos und 4 von 4 Fotos des gesamten Kastens überein.
  • Jeder Release-Build hatte 0 Fehler und benötigte keine manuellen Bearbeitungen.
  • Nicht jeder Schritt lief wie hier geschrieben. Aufforderungen wurden manuell gesendet, Erwähnungen wurden als Text eingefügt, und Agent fand die Regeldatei, indem er nach ihrem Namen suchte. Der Plan wurde genehmigt, indem die nächste Aufforderung geschickt wurde, ohne dass Build jemals geklickt wurde, und die Cloud-Agent-Aufforderung lief lokal im Agent-Modus.

Der Protokolleintrag hält die Paketversionen, das Modell, die Zeiten und die Testmaschine für jeden Leitfaden.


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 82,442Version:2026.11gerade veröffentlicht