Ancrage de Cursor dans la documentation d'IronBarcode

Curtis Chau
Curtis Chau
Mis à jour : 21 septembre 2026

BarcodeReaderOptions.CropArea dans IronBarcode prend un IronSoftware.Drawing.Rectangle, pas le type System.Drawing du même nom, et un modèle travaillant de mémoire se tourne vers le familier. La même habitude écrit dotnet add package IronBarcode, mais le package est BarCode et le namespace est IronBarCode.

Cursor répondait auparavant à ce problème en indexant un site de documentation derrière une mention @Docs. Cette mention n'apparaît plus dans la documentation de Cursor. Ce qui prend sa place est un lien collé dans l'invite, que l'outil web de l'agent récupère, ou une orientation portée par une règle ou une compétence. Les trois dirigent l'agent vers de vraies pages, et aucun ne dépend d'un index.

Cursor est un éditeur axé sur l'AI, et son agent fonctionne à deux portées très différentes :

  • Édition en ligne et Tab fonctionnent où se trouve votre curseur, avec Ctrl+K (Cmd+K sur un Mac) indiquant un changement en une phrase et Tab prédisant votre prochaine modification.
  • Mode agent planifie à travers les fichiers, lance la compilation, lit les erreurs et itère, tandis que le mode Plan lui fait d'abord définir l'approche avec vous.

Tab ouvre un portail vers un autre fichier lorsque le changement de suivi y atterrit, et une édition en ligne affiche son diff sur place pour que vous l'acceptiez ou le rejetiez.

Les règles atteignent le mode agent et le chat, et rien d'autre. La documentation de Cursor indique clairement que les règles n'impactent pas Cursor Tab ou d'autres fonctionnalités d'AI. Ainsi, une règle que vous avez validée n'est pas là lorsque Tab suggère une méthode.

Ancrer Cursor pour le travail sur les codes-barres nécessite deux fichiers validés et un lien collé dans l'invite. Cette préparation est la plus importante pour des changements précis, réduisant les options de lecture, ajoutant une région de recadrage, choisissant une vitesse de lecture, ou identifiant la seule correction d'image qui sauve un lot de mauvaises numérisations.

Rien ici ne concerne le calcul du score de confiance à l'intérieur du lecteur d'IronBarcode, qui a son propre exemple détaillé.

Démarrage rapide
NuGetInstaller avec NuGet

PM > Install-Package BarCode

Installez IronBarcode en exécutant la commande ci-dessus dans la console du gestionnaire de packages NuGet, ou recherchez le package dans le gestionnaire de packages NuGet.

Ouvrez un projet C# dans Cursor et donnez à l'agent une page à lire avant qu'il n'écrive.

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

Il est facile de ne se souvenir qu'approximativement des membres liés à la couleur et aux dimensions, c'est pourquoi l'invite envoie d'abord l'agent sur la page. Le guide de style des codes-barres les nomme tous les trois exactement.

Veuillez noter: Toute invite que vous collez est stockée dans la session, donc une clé de licence collée dans l'une est une clé que vous avez publiée dans l'historique de votre éditeur. Lisez-la à partir de l'environnement à la place, comme le guide de clé de licence le précise.


Quel modèle devrait exécuter votre session de codes-barres ?

Cursor est le seul outil de cette série où vous choisissez le modèle. Composer, son propre modèle agent, est ajusté pour l'utilisation d'outils, les éditions de fichiers et le travail en terminal à l'intérieur de l'éditeur, et sa variante rapide est ce que vous obtenez par défaut. Le sélecteur liste également les modèles d'avant-garde d'OpenAI, Anthropic, Google, et SpaceXAI. Tab se trouve en dehors de ce choix et fonctionne à partir de vos récentes modifications, du code environnant, et des erreurs de linter.

La majeure partie d'une session de codes-barres est bon marché et répétitive. Vous ajoutez un format, reconstruisez, décodez le jeu de tests, et peaufinez. Parfois, un lot de numérisations réelles ne se décode pas et aucune erreur n'indique pourquoi, et c'est à ce moment qu'il faut passer à un modèle qui raisonne plus longtemps avant d'éditer. Le modèle façonne également le code, alors fixez la symbologie, la taille de sortie et la condition de relecture au lieu de les laisser par défaut.

C'est là que la série se chevauche. Exécutez un modèle Claude dans Cursor et les notes dans le guide Claude Code s'appliquent à sa sortie. Le modèle est le même. Seule l'interface diffère.

Comment ancrer Cursor dans la documentation d'IronBarcode ?

Trois actions remplacent l'ancien index et se complètent :

  • Collez le lien : pointez sur llms-full.txt plutôt que sur le hub de documentation, donc une URL met les guides, les exemples et les noms des membres devant l'agent.
  • Validez la compétence : enregistrez skill.md publié d'IronBarcode sous .cursor/skills/ironbarcode/SKILL.md, définissez name: ironbarcode pour correspondre au dossier, et validez-le.
  • Validez la règle : la prochaine section couvre ce qu'elle contient.

Cursor charge les compétences Agent de .cursor/skills/ et .agents/skills/, à la racine du projet ou dans un sous-répertoire, chaque compétence étant un dossier contenant un SKILL.md dont les métadonnées contiennent name et description. L'agent en tire un lorsque la tâche semble pertinente, et taper /ironbarcode l'appelle directement. .agents/skills/ est le chemin neutre pour le même fichier, donc Codex et Antigravity le chargent également de là.

Ignorez les trois et le modèle répond à partir de données d'entraînement qui n'ont jamais été vérifiées par rapport à la version actuelle. Les noms de méthodes sont les premiers touchés. BarcodeScanner.DecodeImageFile() se lit comme un appel réel et échoue à la compilation.

Avec une page de référence, les questions qui auraient été des suppositions deviennent des recherches.

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

Si l'agent ne peut pas citer une page pour l'API qu'il a suggérée, vérifiez avant de construire dessus.

Conseils: Cela fonctionne pour toute classe inconnue. Avec le fichier en contexte, BarcodeReaderOptions est quelque chose que vous interrogez plutôt que de faire défiler, et la réponse cite la page de référence de l'API d'où elle provient.

Comment écrire des règles de projet qui encodent vos conventions IronBarcode ?

Les règles de projet vont dans un dossier .cursor/rules à la racine du dépôt. Elles sont sous contrôle de version, validées avec le code, de sorte que chaque développeur obtient le même comportement sans aucune configuration.

Chaque règle est un fichier .mdc, qui est du markdown avec métadonnées YAML qui définit description, globs, et alwaysApply. Cursor recherche le dossier de manière récursive, donc les sous-dossiers fonctionnent. Un fichier .md simple là est ignoré, car il n'a pas de métadonnées pour l'activer. Une règle IronBarcode ressemble à ceci.

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

Dire au modèle que l'incertitude est acceptable est ce qui arrête l'API inventée, et une règle le dit une fois pour chaque session qui suit.

Copiez la ligne globs exprès. Une règle avec alwaysApply: true charge dans chaque demande et dépense du contexte sur un travail qui n'a pas de codes-barres dedans. La limiter aux dossiers qui contiennent du code de codes-barres la garde où elle doit être.

Veuillez noter: Cursor lit également un AGENTS.md simple, le même fichier utilisé par ChatGPT Codex et Google Antigravity. Il ne transporte pas de métadonnées et donc pas de motifs glob, et Cursor le lit à la racine du projet et dans les sous-répertoires, donc l'imbrication est le seul périmètre qu'il offre. Utilisez .cursor/rules lorsque vous voulez des motifs glob, et AGENTS.md lorsque vous voulez un fichier d'instructions pour plusieurs outils.

Quel mode convient au changement ?

Cursor offre plus de moyens d'éditer que tout autre outil de cette série. Choisissez par taille, d'une seule ligne à l'ensemble du dépôt :

ModeUtilisez-le quandExemple de code-barres
TabLa prochaine édition est prévisibleRépéter une option de lecteur
Édition en ligneUn fichier, une phraseRéduire une lecture à deux formats
AgentLe travail s'étend sur plusieurs fichiers et nécessite une boucle de compilationUn point de terminaison d'étiquette et un point de terminaison de numérisation
Mode PlanLa réécriture est trop grande pour être revue par la suiteMigration depuis une autre bibliothèque de codes-barres
Agent cloudIl peut fonctionner sans surveillanceTests aller-retour pour chaque format

Qu'est-ce qu'une mention @ change ?

Une mention @ donne à l'agent la chose à lire, qui peut être un fichier, un dossier, un terminal, une discussion antérieure, un diff Git, ou le navigateur. Se référer au fichier qui lit les codes-barres est mieux que de le décrire, car une description perd le détail où se trouve le bug.

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

Une mention de dossier convient au travail à l'échelle du module, et l'ensemble de la base de code est là quand vous ne pouvez pas dire quel fichier est important. Associer le code à la documentation couvre les deux moitiés de la question : le fichier montre ce que votre code fait maintenant, et la page montre ce que la bibliothèque fournit réellement.

Le paramètre qui sauve un lot de photos dépend de la façon dont elles sont endommagées, et aucune description ne remplace les tests de l'agent sur les images. Les pages de vitesse de lecture et de correction d'image couvrent les paramètres individuels.

Comment planifier et lancer une migration vers IronBarcode ?

Une réécriture non revue à travers de nombreux fichiers devient coûteuse lors d'une migration, car la défaire est plus difficile que de l'écrire. Le mode Plan est là pour cela. Appuyez sur Shift+Tab depuis l'entrée du chat, ou choisissez-le dans le menu déroulant du mode, et l'agent pose des questions de clarification, lit la base de code, et produit un plan que vous éditez dans le chat ou en markdown avant que tout code n'apparaisse. Les plans sont enregistrés dans votre répertoire personnel, et 'Enregistrer dans l'espace de travail' déplace l'un d'eux dans le dépôt pour que l'équipe puisse le réviser.

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

Lisez le plan, corrigez-le en une phrase ou deux, et renvoyez-le pour mise en œuvre. Le mode agent lit alors le code, modifie les différents fichiers, exécute les commandes, vérifie la sortie, et itère, donc la prochaine invite peut être courte.

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

Supprimez ces deux limites et les agents repensent le modèle d'appel pendant qu'ils migrent.

Les travaux qui ne nécessitent pas de supervision peuvent être confiés à un agent cloud, anciennement l'agent de fond, pendant que vous conservez l'éditeur. Une suite de tests aller-retour convient à cela, car ses assertions sont des valeurs décodées plutôt que des détails d'implémentation, donc leur écriture n'attend pas la migration.

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

Éliminer les comparaisons d'octets est ce qui maintient la suite stable sur toutes les plateformes.

Où se trouvent les problèmes de lecture ?

Les codes-barres illisibles sont la question IronBarcode la plus fréquente, et la réponse réside presque toujours dans les options du lecteur plutôt que dans l'étiquette. Ce que Cursor ajoute, c'est que vous n'avez pas besoin de décrire l'échec. Mentionnez le service et le dossier d'images échouées, et l'éditeur travaille à partir des deux.

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

Insister d'abord sur l'explication vous laisse avec un argument à vérifier au lieu d'un changement à rétro-concevoir. Ici les deux symptômes nécessitent des corrections opposées. Les échecs de lecture nécessitent une liste de formats plus étroite, une zone de recadrage, et le bon filtre d'image, ce que le guide Code-barres non reconnu aborde. Les valeurs fantômes nécessitent RemoveFalsePositive et un seuil de confiance, couverts dans le guide des faux positifs.

Un échec de déploiement remonte généralement au .csproj ou à l'image du conteneur, plutôt qu'à un fichier C#, et un agent ayant accès au terminal peut lire les deux et exécuter la compilation lui-même.

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

Dites explicitement que le C# ne doit pas être touché. Étant donné un appel échoué et aucune limite, un agent optera pour un try/catch et signalera le problème comme résolu. Le guide Docker sur Linux liste ce dont l'image a réellement besoin.

Que devriez-vous configurer en premier ?

Le fichier de compétence et une règle limitée prennent environ quinze minutes, et ils s'appliquent à chaque session après cela. Coller le lien de documentation reste une habitude par invite, et cela coûte une ligne.

Changez le modèle derrière l'éditeur et trois vérifications restent valides : le code compile, le code-barres est décodé, et chaque membre que vous avez utilisé apparaît dans l'API documentée d'IronBarcode. Ces trois-là sont exactement ce que mesure le guide des assistants de codage AI et des agents. Il y a une page pour Claude Code, ChatGPT Codex, GitHub Copilot et Google Antigravity.


Dépannage


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.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 2,564,559Version :2026.11tout juste publié