Comment utiliser IronOCR avec Cursor
La plupart du code IronOCR écrit par un agent IA semble correct et fonctionne souvent. Certaines parties ne fonctionnent pas. Un code qui lit les codes-barres sans activer la collecte de codes-barres ne renvoie aucun code-barres. Un code qui définit l'allemand comme langue sans installer le pack de langue allemand déclenche une LanguagePackException. Le modèle écrit à partir de ses données d'entraînement, c'est pourquoi il est rapide et aussi pourquoi il se trompe sur des détails comme celui-ci.
Cursor est un éditeur de code IA basé sur le code de VS Code. Il peut lire la documentation que vous liez et appliquer des fichiers de règles commis à votre référentiel, de sorte que ses suggestions suivent l'API IronOCR et les conventions de votre équipe. IronOCR est une bibliothèque C# qui lit le texte, les codes-barres et les structures de tables localement.
Chaque filtre de nettoyage est à la fois une méthode sur l'entrée et une valeur dans un énumérateur de filtre, et le nom seul ne dit pas lequel le code a besoin. Cela est particulièrement important pour les modifications précises, comme choisir le filtre pour les mauvaises numérisations, lire les PDFs sans calques de texte ou préserver les structures de table.
Lire l'écriture manuscrite et les photographies avec IronOCR est abordé séparément dans le guide de l'écriture manuscrite et le guide de la lecture des photos.
Démarrage rapideDans un projet C#, envoyez cette requête.
@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.
Le guide de la clé de licence montre chaque manière d'appliquer la clé.
Flux de travail minimal (5 étapes)
- Téléchargez la bibliothèque C# OCR depuis NuGet
- Commettez une règle au niveau du dossier qui contient le lien de la documentation IronOCR
- Nommez le package IronOCR dans la même règle et gardez sa version dans
Directory.Packages.props - Dirigez chaque requête vers le code pertinent et les numérisations d'exemple
- Compilez et comparez les valeurs extraites avec celles des pages connues
Quel modèle Cursor devriez-vous utiliser pour le travail OCR ?
Composer est le propre modèle agentique de Cursor. Le sélecteur de modèle offre également les modèles Grok de SpaceXAI, que Cursor a co-développés, ainsi que des modèles d'OpenAI, Anthropic, Google et d'autres laboratoires. Le test réalisé ci-dessous a utilisé Grok 4.7.
Le travail OCR consiste principalement en de courts cycles d'ajout d'un filtre, de reconstruction et de relecture d'échantillons, et un modèle rapide y parvient bien. Lorsque un lot de numérisations en production renvoie des champs incorrects sans raison apparente, passez à un modèle plus lent qui raisonne plus longtemps.
Comment donner à Cursor la documentation IronOCR ?
Le fichier texte complet pour les LLM résume 145 pages de documentation en une seule URL. En octobre 2026, le menu @ de Cursor joint des fichiers, dossiers, terminaux, chats, diffusions Git et le navigateur, donc la documentation IronOCR atteint l'agent en tant que lien.
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.
Comment rédiger des règles de projet qui codifient vos conventions IronOCR ?
Les règles de projet sont stockées dans le dossier .cursor/rules à la racine du référentiel. Parce qu'elles sont engagées avec le code, chaque clone du référentiel reçoit un ensemble identique.
Les règles sont des fichiers .mdc, écrits en Markdown avec en-tête YAML. Les sous-dossiers sont également lus. Cursor ignore un fichier Markdown simple dans ce dossier, car le fichier n'a pas d'en-tête pour dire quand l'appliquer. Voici ce qu'une règle IronOCR pourrait contenir.
---
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.
Sélectionnez les globes avec soin. Une règle qui s'applique toujours se rattache à chaque session de chat et utilise un contexte supplémentaire, donc définissez la règle IronOCR aux dossiers qui contiennent le code OCR.
AGENTS.md. Il n'a pas d'en-tête et donc pas de globes, donc un fichier racine s'applique à l'ensemble du référentiel. Pour définir sa portée, ajoutez-en un autre dans le sous-répertoire qu'il doit couvrir.Les règles s'appliquent aux demandes Agent. Selon la documentation de Cursor, ils n'affectent pas l'autocomplétion Tab, et les règles utilisateur ne s'appliquent pas aux modifications en ligne. Vérifiez vous-même les suggestions de ces fonctionnalités par rapport à la règle.
Comment cartographier les paramètres Tesseract vers IronOCR ?
Un modèle qui connaît mieux les lignes de commande Tesseract que le code IronOCR peut écrire un drapeau ou un nom de variable Tesseract à la place d'un paramètre IronOCR.
| Tesseract | IronOCR |
|---|---|
--psm 7 | Configuration.PageSegmentationMode = TesseractPageSegmentationMode.SingleLine |
--oem 1 | Rien à définir. LSTM est le seul moteur |
-c tessedit_char_whitelist=... | Configuration.WhiteListCharacters |
Autres variables -c | Configuration.TesseractVariables |
-l eng+deu | AddSecondaryLanguage(OcrLanguage.German) |
--tessdata-dir, TESSDATA_PREFIX | UseCustomTesseractLanguageFile pour un fichier .traineddata, Installation.LanguagePackDirectory pour un dossier de fichiers .ocrdata |
L'assistant de filtre d'IronOCR nécessite la même attention. Il teste les combinaisons de filtres et renvoie le meilleur en tant que code C#, mais ce code construit l'entrée à partir d'un chemin de fichier via un constructeur que le compilateur signale comme obsolète. L'assistant est également lent. Une page de 200 DPI a pris près de neuf minutes sur notre machine de test, donc exécutez-le sur une seule page.
Deux entrées supplémentaires dans la règle couvrent les deux cas.
- 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.
Quel mode convient au changement ?
Cursor propose cinq moyens de modifier un changement. Accordez la fonctionnalité à la taille du travail.
| Fonction | Utilisez-le quand | Exemple OCR |
|---|---|---|
| Onglet | La prochaine édition est prévisible | Répétant une option de filtre |
| Édition en ligne | Un fichier, une phrase | Un filtre sur un lecteur |
| Agent | Plusieurs fichiers et une boucle de construction | Un lecteur et le travail qui l'imprime |
| Mode Plan | Trop grand pour être examiné après coup | Migration hors Tesseract |
| Agent Cloud | Travail sans surveillance | Tests de pages connues |
Pour une modification en ligne, sélectionnez les lignes pertinentes, appuyez sur Ctrl+K (Cmd+K sur macOS), et décrivez le changement. Les codes-barres sur une note de livraison sont un changement d'agent.
@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.
Les codes-barres ne sont collectés que lorsque Configuration.ReadBarCodes est défini avant la lecture. Ils reviennent sur le même résultat que le texte, donc une lecture couvre les deux. Le fichier de compétence montre ce réglage.
Que contribue une mention @ à une requête ?
Il est préférable de référencer le fichier de lecteur réel plutôt que d'utiliser des résumés, car les résumés peuvent omettre des détails importants.
@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.
Si vous n'êtes pas sûr des fichiers pertinents, omettez la mention et l'agent recherchera lui-même dans la base de code.
Incluez également des numérisations d'échantillons dans votre contexte. Exécuter les fichiers réels à travers les filtres montre quelle combinaison les corrige. Sur notre ensemble d'entrepôt, Deskew seul a lu 5 des 9 totaux et DeNoise seul 2. La correction nécessitait les deux, dans cet ordre. Le guide de correction d'orientation d'image et le guide de correction de qualité d'image couvrent les filtres pertinents.
Comment planifier et exécuter une migration vers IronOCR ?
Passez en mode Plan et envoyez cette requête.
@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.
Cliquez ensuite sur Build ou envoyez la requête ci-dessous dans 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.
Un agent cloud, précédemment appelé agent de fond, nécessite un plan payant, fonctionne dans une VM cloud et a besoin d'un référentiel connecté pour travailler sur votre code. Ajoutez IRONOCR_LICENSE_KEY en tant que secret dans le tableau de bord des agents cloud avant de commencer. Commencez les tests après que la migration est fusionnée.
@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.
Le guide des assistants de codage IA exécute une tâche complète avec des critères de validation définis.
Comment déboguer des valeurs OCR incorrectes ou manquantes ?
@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.
Si une exception de conteneur est dans un terminal Cursor, ajoutez @Terminals à la requête ci-dessous également.
@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.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Les neuf invites ont été envoyées à Cursor dans l'ordre, contre une application d'importations d'exemples. C'est un projet console avec une gestion centralisée des packages, des lecteurs de factures et de notes de livraison IronOCR, un service de scan sur l'enveloppe Tesseract, et des scans avec des valeurs connues. La clé de licence était définie uniquement dans l'environnement de l'éditeur. Après l'exécution, de nouvelles versions Release de chaque commit ont relu chaque dossier de test et reproduit les chiffres ci-dessous.
- Les totaux des factures d'entrepôt sont passés de 6 sur 9 avant la correction à 9 sur 9 après.
- Aucun code-barres de note de livraison n'est revenu avant la correction. Après cela, toutes les 8 notes sur 8 avaient leurs codes et aucun supplémentaire.
- Sur la branche des retours de marchandises, les totaux des factures sont passés de 4 sur 6 à 6 sur 6 et les codes-barres des notes de 0 à 6 sur 6.
- La numérisation biaisée a été lue à 87,79 de confiance sans changement et à 96,41 après
Deskew. - Après la migration, les pages connues ont encore lu 10 sur 10 et les totaux allemands 3 sur 3, comme avant.
- La suite xUnit a passé 20 des 20 tests.
- Chaque construction Release comportait 0 erreurs et n'avait besoin d'aucune modification manuelle. La migration a défini l'obsolète
EngineMode, ce qui a laissé deux avertissements CS0618. - La réponse du conteneur a nommé
IronOcr.Linux, les packages apt du guide Docker et la clé manquante, et n'a changé aucun fichier C#. - Certaines étapes ont été exécutées différemment de cette page. Les invites ont été envoyées manuellement dans l'application de bureau, le plan a été approuvé en envoyant l'invite suivante sans jamais cliquer sur Build, et l'invite de l'agent cloud a été exécutée localement. La huitième invite a d'abord été envoyée par erreur dans le chat précédent et a été réinitialisée et renvoyée. Sans Docker sur la machine, l'invite du conteneur a été jugée sur son explication et sa proposition.
Le rapport d'exécution liste les versions, le calendrier et la machine de test pour ce guide ainsi que les autres.
Dépannage
- Appliquer une clé de licence dans IronOCR si le code généré déclenche une exception de licence
- Lire les codes-barres avec IronOCR si une lecture renvoie du texte mais aucun code-barres
- Améliorer la précision OCR si les valeurs lues ne correspondent pas à la numérisation
- IronOCR sur Docker si les lectures fonctionnent localement et échouent dans un conteneur Linux
Des questions ?
Si vous avez des questions, contactez support@ironsoftware.com
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.