Wie Sie IronOCR mit Cursor verwenden

Curtis Chau
Curtis Chau
Aktualisiert: 9. Oktober 2026

Der meiste von einem KI-Agenten geschriebene IronOCR-Code sieht korrekt aus und läuft oft. Einige davon nicht. Code, der Barcodes liest, ohne die Barcode-Sammlung zu aktivieren, liefert keine Barcodes. Code, der Deutsch als Sprache festlegt, ohne das deutsche Sprachpaket zu installieren, wirft eine LanguagePackException. Das Modell schreibt aus seinen Trainingsdaten, weshalb es schnell ist und auch warum es Details wie diese falsch versteht.

Cursor ist ein KI-Code-Editor, der auf dem VS Code-Codebase basiert. Er kann Dokumentation, die Sie verlinken, lesen und Regeldateien anwenden, die in Ihr Repository eingecheckt sind, sodass seine Vorschläge der API von IronOCR und den Konventionen Ihres Teams folgen. IronOCR ist eine C#-Bibliothek, die Text, Barcodes und Tabellenstrukturen lokal liest.

Jeder Bereinigungsfilter ist sowohl eine Methode am Eingang als auch ein Wert in einem Filter-Enum, und der Name allein sagt nicht, welcher im Code benötigt wird. Das ist am wichtigsten für präzise Änderungen, wie z.B. die Wahl des Filters für schlechte Scans, das Lesen von PDFs ohne Textebenen oder das Beibehalten von Tabellenstrukturen.

Das Lesen von Handschriften und Fotos mit IronOCR wird in der Handschriftanleitung und der Foto-Leseanleitung separat behandelt.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package IronOcr

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

Senden Sie diese Anfrage innerhalb eines C#-Projekts.

@Program.cs Read https://ironsoftware.com/ocr/csharp/llms-full.txt first.

In this C# project, read TestData/skewed-scan.png twice, once untouched and once
with a single correction filter applied to the input, and print both confidence
scores exactly as IronOCR returns them so I can compare them. Read the license
key from the IRONOCR_LICENSE_KEY environment variable and never print it. Use
only members that appear in the documentation.
Text

Der Lizenzschlüssel-Leitfaden zeigt jede Methode zur Anwendung des Schlüssels.



Welches Cursor-Modell sollten Sie für OCR-Arbeiten 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.

OCR-Arbeit besteht größtenteils aus kurzen Zyklen des Hinzufügens eines Filters, des Neuaufbaus und Wiedereinlesens von Proben, und ein schnelles Modell bewältigt diese gut. Wenn eine Charge von Produktionsscans aus keinem klaren Grund falsche Felder zurückgibt, wechseln Sie zu einem langsameren Modell, das länger Überlegungen anstellt.

Wie geben Sie Cursor die IronOCR-Dokumentation?

Die vollständige Textdatei für LLMs fasst 145 Dokumentationsseiten unter einer URL zusammen. Ab Oktober 2026 verbindet das @-Menü von Cursor Dateien, Ordner, Terminals, Chats, Git-Diffs und den Browser, sodass IronOCRs Dokumentation als Link zum Agenten gelangt.

Read https://ironsoftware.com/ocr/csharp/llms-full.txt

How do I read a scanned PDF and save a searchable copy, and how do I straighten
a slightly rotated page before reading it? Show the exact class and member names
from the documentation, and link the page you took them from.
Text

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

Projektrichtlinien werden im .cursor/rules Ordner am Repository-Stamm gespeichert. Da sie mit dem Code eingetragen werden, erhält jeder Klon des Repositories ein identisches Set.

Regeln sind .mdc Dateien, geschrieben in Markdown mit YAML-Frontmatter. Auch Unterordner werden gelesen. Cursor ignoriert eine einfache Markdown-Datei in diesem Ordner, da die Datei keine Frontmatter hat, um zu sagen, wann sie anzuwenden ist. Hier ist, was eine IronOCR-Regel enthalten könnte.

---
description: IronOCR conventions for scan reading in this project
globs: Imports/**/*.cs, Capture/**/*.cs
alwaysApply: false
---

# IronOCR conventions

- Use IronOCR for all OCR work. The NuGet package is IronOcr on Windows and
  IronOcr.Linux on Linux and Docker. The namespace is IronOcr. Do not add
  another OCR engine or a cloud OCR service.
- Documentation: https://ironsoftware.com/ocr/csharp/llms-full.txt
- Skill file with recipes: https://ironsoftware.com/ocr/csharp/skill.md
- Target the IronOcr version pinned in Directory.Packages.props. Do not upgrade
  it as part of an unrelated change.
- Never inline a license key. Read it from configuration or the
  IRONOCR_LICENSE_KEY environment variable.
- Dispose OcrInput with a using block.
- Any language other than English needs its IronOcr.Languages package first.
  Language packs keep their own version numbers, so pin the newest one on NuGet.
- Do not invent IronOCR API names. If a member is uncertain, say so and cite
  the documentation instead of guessing.
Markdown

Wählen Sie die Globs sorgfältig aus. Eine Regel, die immer anwendbar ist, wird an jede Chatsitzung angehängt und verwendet zusätzlichen Kontext, also begrenzen Sie die IronOCR-Regel auf die Ordner, die OCR-Code enthalten.

Bitte beachten Sie: Cursor liest auch einen Wurzel-AGENTS.md. Es hat keine Frontmatter und daher keine Globs, sodass eine Wurzeldatei für das gesamte Repository gilt. Um seine Anweisungen zu beschränken, fügen Sie eine weitere im Unterverzeichnis hinzu, das es abdecken soll.

Regeln gelten für Agent-Anfragen. Laut Cursors Dokumentation beeinflussen sie Autocomplete nicht und Benutzerrichtlinien gelten nicht für Inline-Bearbeitungen. Überprüfen Sie Vorschläge dieser Funktionen selbst gegen die Regel.

Wie ordnen Sie Tesseract-Einstellungen IronOCR zu?

Ein Modell, das Tesseract-Befehlszeilen besser kennt als IronOCR-Code, könnte einen Tesseract-Flag- oder Variablennamen schreiben, wo eine IronOCR-Einstellung hingehört.

TesseractIronOCR
--psm 7Configuration.PageSegmentationMode = TesseractPageSegmentationMode.SingleLine
--oem 1Nichts einzustellen. LSTM ist die einzige Engine
-c tessedit_char_whitelist=...Configuration.WhiteListCharacters
Andere -c VariablenConfiguration.TesseractVariables
-l eng+deuAddSecondaryLanguage(OcrLanguage.German)
--tessdata-dir, TESSDATA_PREFIXUseCustomTesseractLanguageFile für eine .traineddata Datei, Installation.LanguagePackDirectory für einen Ordner von .ocrdata Dateien

Der Filter-Assistent von IronOCR benötigt die gleiche Sorgfalt. Er testet Filterkombinationen und gibt die beste als C#-Code zurück, aber dieser Code baut den Eingang aus einem Dateipfad durch einen Konstruktor, den der Compiler als veraltet markiert. Der Assistent ist auch langsam. Eine 200-DPI-Seite dauerte auf unserer Testmaschine fast neun Minuten, also führen Sie sie auf einer einzelnen Seite aus.

Zwei weitere Einträge in der Regel decken beide Fälle ab.

- Configure Tesseract through IronTesseract.Configuration properties, never raw
  tessedit_* variables or command-line flags. Use TesseractVariables only for a
  setting with no named property.
- Rewrite OcrInputFilterWizard output from new OcrInput(path) to new OcrInput()
  with LoadImage or LoadPdf before it reaches the codebase.
Markdown

Welcher Modus passt zur Änderung?

Cursor bietet fünf Möglichkeiten, eine Änderung vorzunehmen. Passen Sie die Funktion an die Größe der Arbeit an.

FeatureVerwenden Sie es, wennOCR-Beispiel
TabDie nächste Bearbeitung ist vorhersehbarWiederholung einer Filteroption
Inline-EditEine Datei, ein SatzEin Filter auf einem Leser
AgentMehrere Dateien und eine Build-SchleifeEin Leser und der Auftrag, der ihn druckt
PlanmodusZu groß, um danach zu überprüfenWechsel von Tesseract
Cloud AgentUnbeaufsichtigte ArbeitTests mit bekannten Seiten

Für eine Inline-Bearbeitung wählen Sie die relevanten Zeilen aus, drücken Sie Strg+K (Cmd+K auf macOS) und beschreiben Sie die Änderung. Barcodes auf einem Lieferschein sind eine Agentenänderung.

@Imports/DeliveryNotes.cs @Imports/ImportJob.cs Read https://ironsoftware.com/ocr/csharp/skill.md first.

Also return every barcode and QR code on each delivery note, and have the notes
command print each one's format and value.
Text

Barcodes werden nur gesammelt, wenn Configuration.ReadBarCodes vor dem Lesen eingestellt ist. Sie kommen mit demselben Ergebnis wie der Text zurück, also deckt ein Lesen beides ab. Die Skill-Datei zeigt diese Einstellung.

Was fügt ein @-Erwähnung einer Anfrage hinzu?

Es ist besser, auf die tatsächliche Leserdatei zu verweisen, als Zusammenfassungen zu verwenden, da Zusammenfassungen wichtige Details auslassen können.

@Imports/InvoiceReader.cs @TestData/warehouse/

InvoiceReader reads every scan in TestData/warehouse/ without an error, but about
a third of the totals have one wrong digit. Fix the input preparation, not the
parsing. Explain which setting caused it, and report how many totals match
expected.csv before and after.
Text

Wenn Sie sich nicht sicher sind, welche Dateien relevant sind, lassen Sie die Erwähnung weg und Agent durchsucht die Codebasis selbst.

Schließen Sie Beispielscans ebenfalls in Ihren Kontext ein. Das Durchlaufen der realen Dateien durch die Filter zeigt, welche Kombination sie behebt. Auf unserem Lager-Set las Deskew allein 5 von 9 Gesamtsummen und DeNoise allein 2. Die Korrektur benötigte beide in dieser Reihenfolge. Der Leitfaden zur Bildausrichtungskorrektur und der Leitfaden zur Bildqualitätskorrektur behandeln die relevanten Filter.

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

Wechseln Sie in den Planmodus und senden Sie diese Anfrage.

@Imports/ScanOcrService.cs

ScanOcrService reads scans with the Tesseract NuGet package. Plan a migration of
it to IronOCR.

List every read it performs, with the settings it uses (language, page
segmentation, preprocessing, region, output format), map each one to its IronOCR
equivalent, and name the files that change. Keep existing public method
signatures so callers don't change. If anything is ambiguous, choose and state
your assumption, and do not ask. Don't write code yet.
Text

Klicken Sie dann auf „Build“ oder senden Sie die Anfrage unten in Agent.

@Imports/ Implement the approved plan. Then run dotnet build, fix what breaks, confirm
every page in TestData/known/ still returns its expected values, and show me the
diff. Don't add new packages beyond IronOcr and any language packs the plan names.
Text

Ein Cloud Agent, früher genannt Background Agent, benötigt einen bezahlten Plan, läuft in einer Cloud-VM und benötigt ein verbundenes Repository, um an Ihrem Code zu arbeiten. Fügen Sie IRONOCR_LICENSE_KEY als ein Geheimnis im Cloud Agents-Dashboard hinzu, bevor Sie beginnen. Beginnen Sie die Tests, nachdem die Migration zusammengeführt wurde.

@Imports/ @TestData/ Write xUnit tests for the migrated OCR service in a
tests/Imports.Tests project that Imports.csproj does not compile. Every page in
TestData/known/ returns its expected invoice number and total, a page without a
total returns null, DeliveryNotes returns the codes in TestData/notes/expected.csv,
and a read with OcrLanguage.French, whose language pack is not installed,
produces a clear error. The tests read the license key from IRONOCR_LICENSE_KEY
and never print it. Assert on extracted fields, never on full page text. Run
dotnet test and fix what fails.
Text

Der Leitfaden für KI-Coding-Assistenten führt eine vollständige Aufgabe mit definierten Kriterien für das Bestehen aus.

Wie debuggen Sie falsche oder fehlende OCR-Werte?

@Imports/InvoiceReader.cs @Imports/DeliveryNotes.cs @TestData/returns/

Returned-goods invoices come back with a wrong digit in the total, and delivery
notes return no barcodes even though every note has one. Explain the cause of
each before changing anything, then fix both.
Text

Wenn die Ausnahme eines Containers in einem Cursor-Terminal auftritt, fügen Sie auch @Terminals zur folgenden Anfrage hinzu.

@Dockerfile @Imports.csproj Read https://ironsoftware.com/ocr/csharp/skill.md first.

Reads work on Windows but fail when this app runs in our Linux container. Check
which IronOCR package the project references, whether the container image has
the native dependencies IronOCR needs, and whether the license key reaches the
container. Explain the cause, then propose the change. Don't modify C# code
unless the cause is there.
Text

Was haben die Aufforderungen in einem realen Lauf erzeugt?

Die neun Aufforderungen wurden der Reihe nach an Cursor gegen eine Beispielimport-App gesendet. Es ist ein Konsolenprojekt mit zentralem Paketmanagement, IronOCR-Rechnungs- und Lieferscheinslesern, einem Scan-Dienst auf dem Tesseract-Wrapper und Scans mit bekannten Werten. Der Lizenzschlüssel wurde nur in der Umgebung des Editors festgelegt. Nach dem Lauf lasen frische Release-Builds jedes Commits erneut jeden Testordner und reproduzierten die unten stehenden Zahlen.

  • Die Gesamtsummen der Lagerrechnungen stiegen von 6 von 9 vor der Korrektur auf 9 von 9 danach.
  • Keine Lieferschein-Barcodes kamen vor der Korrektur zurück. Danach hatten alle 8 von 8 Anmerkungen ihre Codes und keine zusätzlichen.
  • Auf dem Zweig der zurückgegebenen Waren stiegen die Gesamtsummen der Rechnungen von 4 von 6 auf 6 von 6 und die Barcodes der Scheine von keinem auf 6 von 6.
  • Der verzerrte Scan wurde mit 87,79 Vertrauen unverändert gelesen und mit 96,41 nach Deskew.
  • Nach der Migration lasen die bekannten Seiten immer noch 10 von 10 und die deutschen Gesamtsummen 3 von 3, wie zuvor.
  • Die xUnit-Suite bestand 20 von 20 Tests.
  • Jeder Release-Build hatte 0 Fehler und benötigte keine manuellen Bearbeitungen. Die Migration stellte den veralteten EngineMode ein, was zwei CS0618-Warnungen hinterließ.
  • Die Containerantwort nannte IronOcr.Linux, die apt-Pakete des Docker-Leitfadens und den fehlenden Schlüssel, und änderte keine C#-Datei.
  • Einige Schritte liefen anders als auf dieser Seite. Aufforderungen wurden manuell in der Desktop-App gesendet, der Plan wurde durch Senden der nächsten Aufforderung genehmigt, ohne dass „Build“ jemals geklickt wurde, und die Cloud-Agent-Aufforderung lief lokal. Aufforderung acht ging zunächst versehentlich an den früheren Chat und wurde zurückgesetzt und erneut gesendet. Ohne Docker auf der Maschine wurde die Container-Aufforderung anhand ihrer Erklärung und des Vorschlags bewertet.

Das Laufprotokoll listet die Versionen, die Zeitpläne und die Testmaschine für diesen Leitfaden neben den anderen auf.


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 6,394,824Version:2026.11gerade veröffentlicht