Cursor auf die IronBarcode-Dokumentation stützen
BarcodeReaderOptions.CropArea in IronBarcode nimmt ein IronSoftware.Drawing.Rectangle, nicht den System.Drawing Typ mit demselben Namen, und ein aus dem Gedächtnis arbeitendes Modell greift nach dem Vertrauten. Die gleiche Gewohnheit schreibt dotnet add package IronBarcode, aber das Paket ist BarCode und der Namespace ist IronBarCode.
Früher löste Cursor dies durch das Indizieren einer Dokumentationswebsite über eine @Docs-Erwähnung. Diese Erwähnung erscheint nicht mehr in Cursors Dokumentation. An ihrer Stelle steht ein Link, der in den Prompt eingefügt wird, den das Web-Tool des Agenten abruft, oder eine Anweisung, die in einer Regel oder einem Skill enthalten ist. Alle drei verweisen den Agenten auf echte Seiten, und keiner von ihnen wartet auf einen Index.
Cursor ist ein Editor mit KI als zentralem Bestandteil, und sein Agent arbeitet in zwei sehr unterschiedlichen Bereichen:
- Inline-Edit und Tab arbeiten dort, wo sich Ihr Cursor befindet, mit
Ctrl+K(Cmd+Kauf einem Mac), um eine Änderung in einem Satz anzugeben und Tab, um Ihre nächste Bearbeitung vorherzusagen. - Agentenmodus plant über Dateien, führt den Build aus, liest die Fehler und iteriert, während der Planmodus zuerst die Herangehensweise mit Ihnen abstimmt.
Tab öffnet ein Portal zu einer anderen Datei, wenn die nachfolgende Änderung dort landet, und ein Inline-Edit zeigt dessen Unterschied an Ort und Stelle für Sie zur Annahme oder Ablehnung.
Regeln erreichen den Agentenmodus und den Chat, und nichts anderes. Die Dokumentation von Cursor beschreibt deutlich, dass Regeln Cursor Tab oder andere KI-Funktionen nicht beeinflussen. Eine Regel, die Sie festgelegt haben, ist also nicht vorhanden, wenn Tab eine Methode vorschlägt.
Um Cursor bei Barcode-Aufgaben auf die Dokumentation zu stützen, benötigen Sie zwei per Commit gespeicherte Dateien und einen in den Prompt eingefügten Link. Diese Vorbereitung ist bei präzisen Änderungen am wichtigsten, die Leseoptionen einschränken, einen Zuschneidebereich hinzufügen, eine Lesegeschwindigkeit auswählen oder die einzelne Bildkorrektur identifizieren, die eine Charge schlechter Scans rettet.
Nichts hier betrifft die Konfidenzbewertungen im Inneren des Lesers von IronBarcode, der sein eigenes ausgearbeitetes Beispiel besitzt.
SchnellstartÖffnen Sie ein C#-Projekt in Cursor und geben Sie dem Agenten eine Seite, die er lesen soll, bevor er schreibt.
In Program.cs, generate a Code 128 barcode for an asset tag and style it for a
printed label. Set the bar color and the background with ChangeBarCodeColor and
ChangeBackgroundColor, size it with ResizeTo, and print the value under the
bars. The license comes out of IRONBARCODE_LICENSE_KEY.
Work from https://ironsoftware.com/barcode/csharp/llms-full.txt, use only
members that appear in it, and tell me which page each styling call came from.
Die Namen der API-Member für Farbe und Größe bleiben leicht nur unvollständig im Gedächtnis, weshalb der Prompt den Agenten zuerst zur Seite sendet. Der Barcode-Stilguide benennt alle drei genau.
Minimaler Workflow in 5 Schritten
- Laden Sie die C#-Barcode-Bibliothek von NuGet herunter
- Fügen Sie den
llms-full.txt-Link von IronBarcode in jeden Prompt ein, der Barcode-Code schreibt - Speichern Sie
skill.mdvon IronBarcode als.cursor/skills/ironbarcode/SKILL.md - Speichern Sie per Commit eine Projektregel, die die BarCode-Version und Ihre Konventionen festlegt
- Erstellen Sie das Projekt, lesen Sie jeden Barcode zurück und prüfen Sie jeden API-Namen anhand der API-Referenz
Welches Modell sollte Ihre Barcodesitzung ausführen?
Cursor ist das einzige Tool in dieser Serie, bei dem Sie das Modell wählen. Composer, sein eigenes agentisches Modell, ist auf die Werkzeugbenutzung, Dateibearbeitungen und Terminalarbeiten innerhalb des Editors abgestimmt, und seine schnelle Variante ist der Standard. Der Auswähler listet auch führende Modelle von OpenAI, Anthropic, Google und SpaceXAI auf. Tab arbeitet außerhalb dieser Auswahl und arbeitet auf der Grundlage Ihrer letzten Bearbeitungen, des umgebenden Codes und von Linter-Fehlern.
Der Großteil einer Barcode-Sitzung ist kostengünstig und repetitiv. Sie fügen ein Format hinzu, kompilieren neu, dekodieren den Testsatz und justieren nach. Gelegentlich wird eine Charge echter Scans nicht dekodiert und kein Fehler gibt an, warum, und das ist der Punkt, an dem man zu einem Modell wechseln sollte, das länger überlegt, bevor es bearbeitet. Das Modell formt auch den Code, sodass man die Symbologie, die Ausgabegröße und die Erfolgskriterien beim Rücklesen festlegen sollte, anstatt sie den Standardeinstellungen zu überlassen.
Hier überschneiden sich die Serien. Führen Sie ein Claude-Modell in Cursor aus und die Notizen im Claude Code-Leitfaden gelten für dessen Ausgabe. Das Modell ist dasselbe. Nur die Oberfläche unterscheidet sich.
Wie verankern Sie Cursor in IronBarcode-Dokumentation?
Drei aufeinander aufbauende Schritte ersetzen den alten Index:
- Fügen Sie den Link ein: zeigen Sie auf
llms-full.txtanstelle des Dokumentationshubs, sodass eine URL die Anleitungen, die Beispiele und die Member-Namen vor den Agenten stellt. - Skill per Commit speichern: Speichern Sie die von IronBarcode veröffentlichte Datei
skill.mdals.cursor/skills/ironbarcode/SKILL.md, setzen Siename: ironbarcode, um dem Ordner zu entsprechen, und speichern Sie sie per Commit. - Regel per Commit speichern: Der nächste Abschnitt behandelt, was hineingeht.
Cursor lädt Agent Skills von .cursor/skills/ und .agents/skills/ im Projekthauptverzeichnis oder in einem Unterverzeichnis. Jeder Skill liegt in einem Ordner, der eine SKILL.md enthält, dessen Frontmatter name und description trägt. Der Agent lädt einen Skill, wenn eine Aufgabe relevant erscheint, und durch Eingabe von /ironbarcode wird er direkt aufgerufen. .agents/skills/ ist der neutrale Pfad für dieselbe Datei, daher laden Codex und Antigravity sie ebenfalls von dort.
Überspringen Sie alle drei und das Modell antwortet aus Trainingsdaten, die nie gegen die aktuelle Version geprüft wurden. Methodennamen gehen zuerst. BarcodeScanner.DecodeImageFile() liest sich wie ein echter Aufruf und schlägt beim Build fehl.
Mit einer Dokumentationsseite als Grundlage lassen sich Fragen durch Nachschlagen beantworten, statt Vermutungen anzustellen.
Which options narrow a read to two symbologies inside a fixed region of a
larger image? Give me the exact class and property names, and quote the lines
you took them from in https://ironsoftware.com/barcode/csharp/llms-full.txt.
Wenn der Agent keine Seite für die vorgeschlagene API zitieren kann, überprüfen Sie ihn, bevor Sie darauf aufbauen.
BarcodeReaderOptions etwas, das Sie befragen statt scrollen, und die Antwort zitiert die API-Referenz-Seite, von der es stammt.Wie schreiben Sie Projektregeln, die Ihre IronBarcode-Konventionen codieren?
Projektregeln gehen in einen Ordner namens .cursor/rules im Repository-Root. Sie stehen unter Versionskontrolle, werden mit dem Code eingereicht, sodass jeder Entwickler das gleiche Verhalten ohne Einrichtung erhält.
Jede Regel ist eine .mdc-Datei, die Markdown mit einem YAML-Frontmatter ist, die description, globs und alwaysApply setzt. Cursor durchsucht den Ordner rekursiv, sodass Unterordner funktionieren. Eine einfache .md-Datei dort wird ignoriert, weil sie kein Frontmatter hat, um sie zu aktivieren. Eine IronBarcode-Regel sieht so aus.
---
description: IronBarcode conventions for barcode reading and writing in this project
globs: ["**/Services/**/*.cs", "**/Barcodes/**/*.cs"]
alwaysApply: false
---
# IronBarcode conventions
Applies to the barcode code in this folder only.
- IronBarcode (package BarCode, namespace IronBarCode) writes and reads every
barcode here. Never reach for a second barcode package.
- Reader options are explicit: set ExpectBarcodeTypes to the formats this
feature really reads, and reuse one BarcodeReaderOptions per format set
rather than allocating per call.
- Reads on a request path are async.
- CropArea takes IronSoftware.Drawing.Rectangle, not System.Drawing.
- Verified recipes: https://ironsoftware.com/barcode/csharp/skill.md
- If you are unsure a member exists, say so and cite the page. Do not guess a
method name that sounds plausible.
Dem Modell zu sagen, dass Unsicherheit akzeptabel ist, stoppt die erfundene API, und eine Regel sagt es einmal für jede nachfolgende Sitzung.
Kopieren Sie die globs-Zeile absichtlich. Eine Regel mit alwaysApply: true wird in jede Anfrage geladen und verbraucht auch bei Aufgaben ohne Barcode-Bezug Kontext. Es auf die Ordner zu beschränken, die Barcode-Code enthalten, hält es dort, wo es hingehört.
AGENTS.md, dieselbe Datei, die ChatGPT Codex und Google Antigravity verwenden. Sie enthält kein Frontmatter und daher keine Globs, und Cursor liest sie im Projekt-Root und in Unterverzeichnissen, sodass das einzige Scoping, das es bietet, die Verschachtelung ist. Verwenden Sie .cursor/rules, wenn Sie Glob-Muster möchten, und AGENTS.md, wenn Sie eine Anleitungsdatei für mehrere Werkzeuge benötigen.Welcher Modus passt zur Änderung?
Cursor bietet mehr Möglichkeiten zur Bearbeitung als jedes andere Tool in dieser Serie. Wählen Sie nach Größe, von einer einzigen Zeile bis zum gesamten Repository:
| Modus | Verwenden Sie ihn, wenn | Barcode-Beispiel |
|---|---|---|
| Tab | Die nächste Bearbeitung ist vorhersehbar | Eine Leseoption wiederholen |
| Inline-Edit | Eine Datei, ein Satz | Das Lesen auf zwei Formate einschränken |
| Agent | Arbeit erstreckt sich über Dateien und benötigt eine Build-Schleife | Ein Label-Endpunkt und ein Scan-Endpunkt |
| Planmodus | Die Codeüberarbeitung ist zu groß, um sie nachträglich zu überprüfen | Von einer anderen Barcode-Bibliothek migrieren |
| Cloud-Agent | Es kann unbeaufsichtigt laufen | Tests durch Erzeugen und Rücklesen für alle Formate |
Was ändert eine @-Erwähnung?
Eine @-Erwähnung gibt dem Agenten das zu lesende Objekt, das eine Datei, ein Ordner, ein Terminal, ein früherer Chat, ein Git-Diff oder der Browser sein kann. Die Datei, die Barcodes liest, direkt zu referenzieren ist besser, als sie zu beschreiben, da eine Beschreibung die Details verliert, in denen der Fehler liegt.
@Services/ScanService.cs @TestData/depot/
Read https://ironsoftware.com/barcode/csharp/llms-full.txt for the options.
Half the photos in TestData/depot/ come back empty. The reader options are
where this gets fixed, not the label generator. Name the setting that was
missing, and give me a decode rate for the folder before your change and after
it.
Eine Ordner-Erwähnung eignet sich für modulübergreifende Arbeiten, und der gesamte Code ist dort, wenn Sie nicht sagen können, welche Datei wichtig ist. Das Kombinieren des Codes mit der Dokumentation deckt beide Hälften der Frage ab: Die Datei zeigt, was Ihr Code jetzt tut, und die Seite zeigt, was die Bibliothek tatsächlich bietet.
Welche Einstellung eine Charge von Fotos rettet, hängt davon ab, wie sie beschädigt sind, und keine Beschreibung ersetzt den Agenten, der direkt mit den Bildern arbeitet. Die Lesegeschwindigkeit- und Bildkorrektur-Seiten decken die individuellen Einstellungen ab.
Wie planen Sie eine Migration zu IronBarcode und führen sie durch?
Eine nicht überprüfte Neuschreibung über viele Dateien wird während einer Migration teuer, da es schwieriger ist, sie rückgängig zu machen, als sie zu schreiben. Dafür existiert der Planmodus. Drücken Sie Shift+Tab im Chat-Eingabefeld oder wählen Sie den Planmodus im Modus-Dropdown, und der Agent stellt klärende Fragen, liest die Codebasis und erstellt einen Plan, den Sie im Chat oder als Markdown bearbeiten, bevor Code erstellt wird. Pläne werden in Ihrem Benutzerverzeichnis gespeichert, und "In Arbeitsbereich speichern" verschiebt einen Plan in das Repository, damit das Team ihn überprüfen kann.
The barcode code in @Labels/ belongs to another library. Using
https://ironsoftware.com/barcode/csharp/llms-full.txt, work out what replacing
it with IronBarcode would actually involve. Which files change, what the
equivalent call is for each thing the folder does today, and where the
documentation says no clean equivalent exists.
Public method signatures are fixed. If the plan needs one to change, say so in
the plan rather than changing it.
Lesen Sie den Plan, korrigieren Sie ihn mit einem oder zwei Sätzen, und senden Sie ihn zurück, um ihn umzusetzen. Der Agentenmodus liest dann den Code, bearbeitet über Dateien hinweg, führt Befehle aus, überprüft die Ausgabe und iteriert, sodass der nächste Prompt kurz sein kann.
Carry out the plan we agreed. Compile it, clear whatever errors come up, and
satisfy yourself that every symbology the folder handles still comes back out
the same as it went in. Show me the diff at the end. BarCode is the only package
that may appear in the .csproj.
Lassen Sie diese beiden Einschränkungen fallen und Agenten gestalten das Aufrufmuster neu, während sie migrieren.
Arbeit, die keine Aufsicht benötigt, kann an einen Cloud-Agenten gehen, früher der Hintergrundagent, während Sie im Editor weiterarbeiten. Eine Testsuite zum Erzeugen und Rücklesen eignet sich dafür, da ihre Assertions dekodierte Werte statt Implementierungsdetails prüfen. Das Schreiben dieser Tests muss daher nicht auf den Abschluss der Migration warten.
@Services/
Send this to a cloud agent while I keep working on the reader options.
Cover the migrated service with xUnit. Use a [Theory] over the symbologies it
supports rather than one [Fact] per format, so adding a format later costs one
line. Each case writes a sample value and reads it back, and the assertion is on
the decoded string and the decoded format together.
Then three edge cases as their own facts: an empty image returns no results
instead of throwing, a letters-only value is refused as EAN-13, and a missing
path fails with a readable message. Image bytes are off limits as an assertion
target.
Der Ausschluss von Byte-Vergleichen ist das, was die Suite über Plattformen hinweg stabil hält.
Wo liegen die Ursachen für Leseprobleme?
Unlesbare Barcodes sind die häufigste Frage bei IronBarcode, und die Antwort liegt fast immer in den Leseoptionen statt im Label. Was Cursor hinzufügt, ist, dass Sie den Fehler nicht beschreiben müssen. Erwähnen Sie den Dienst und den Ordner mit den fehlerhaften Bildern, und der Editor arbeitet auf Grundlage beider.
Photos of returns labels read fine on a handheld scanner but come back empty
from @Services/ScanService.cs, and a few product photos carrying no barcode at
all return a value. Samples of both are in @TestData/returns/.
Explain the cause of each before changing anything, then fix both in the reader
options.
Wenn Sie zuerst auf einer Erklärung bestehen, erhalten Sie eine überprüfbare Begründung, statt eine Änderung nachträglich nachvollziehen zu müssen. Hier benötigen die beiden Symptome gegensätzliche Maßnahmen. Verpasste Lesevorgänge benötigen eine engere Formatliste, einen Zuschneidebereich und den richtigen Bildfilter, wie der Leitfaden zu nicht erkannten Barcodes erläutert. Phantomwerte benötigen RemoveFalsePositive und einen Konfidenzschwellenwert, der im Leitfaden zu falsch positiven Ergebnissen behandelt wird.
Ein Bereitstellungsfehler geht normalerweise auf die .csproj-Datei oder das Container-Image zurück, nicht auf eine C#-Datei, und ein Agent mit Terminalzugang kann beides lesen und den Build selbst ausführen.
@Dockerfile @LabelScan.csproj @Terminals
Reading works on Windows but fails in our Linux container. The failing build is
in the terminal output above, so read it there rather than asking me to paste it.
Check which BarCode package the project references and whether the image has
the native dependencies IronBarcode needs on Linux. Explain the cause, then
propose the change. Don't modify C# code unless the cause is there.
Geben Sie ausdrücklich an, dass der C#-Code nicht geändert werden soll. Bei einem fehlschlagenden Aufruf und keiner Grenze greift ein Agent zu einem try/catch und meldet das Problem als gelöst. Der Leitfaden zu Docker unter Linux listet, was das Image tatsächlich benötigt.
Was sollten Sie zuerst einrichten?
Die Skill-Datei und eine eingrenzende Regel benötigen etwa fünfzehn Minuten, und sie gelten für jede Sitzung danach. Das Einfügen des Dokumentationslinks bleibt bei jedem Prompt erforderlich, und es kostet eine Zeile.
Ändern Sie das Modell hinter dem Editor und drei Prüfungen gelten weiterhin: Der Code kompiliert, der Barcode lässt sich dekodieren, und jeder verwendete Member erscheint in der dokumentierten API von IronBarcode. Diese drei sind genau das, was der Leitfaden für KI-Coding-Assistenten und Agenten misst. Es gibt eine Seite für Claude Code, ChatGPT Codex, GitHub Copilot und Google Antigravity.
Fehlerbehebung
- Anwenden eines Lizenzschlüssels in IronBarcode, wenn ein Inline-Edit kompiliert und die Ausführung fehlschlägt.
- Barcode nicht erkannt, wenn Leseoptionen noch abgestimmt werden müssen.
- IronBarcode NuGet-Pakete, wenn die Version in Ihrer Projektregel und die Version in
.csprojnicht übereinstimmen. - IronBarcode in Docker auf Linux ausführen, wenn lokale Lesevorgänge erfolgreich sind und Container-Lesevorgänge nicht.
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.