Demander à ChatGPT Codex du code IronBarcode qui compile
IronBarcode fournit deux énumérations d'encodage dont la casse diffère, BarcodeEncoding.Databar et BarcodeWriterEncoding.DataBar, et un modèle travaillant à partir de la mémoire les confond. Un compilateur détecte cela immédiatement, ce qui constitue l'argument pour un agent qui compile le code qu'il écrit. ChatGPT Codex fonctionne à l'intérieur du dépôt, donc il exécute dotnet build et lit l'erreur lui-même. Les fautes plus discrètes coûtent plus cher, comme un lecteur configuré pour rechercher toutes les symbologies quand chaque étiquette du lot est en Code 128.
Cette différence détermine quel niveau exécuter. Codex couvre la famille GPT-5.6, et /model bascule entre Sol, Terra et Luna lors d'une session interactive. Une boucle de compilation et de relecture sur un jeu de test fixe est un travail peu coûteux que Luna gère à 5 crédits par million de jetons d'entrée, contre 100 pour Sol. Terra est le niveau intermédiaire à 50 crédits par million de jetons d'entrée et 300 par million de jetons de sortie, et c'est un choix raisonnable une fois qu'un projet dépasse un jeu de test. Réservez Sol, le fleuron de la famille, pour des travaux de diagnostic plus difficiles, comme un lot de photos d'entrepôt qui ne parvient pas à se décoder sans rapporter de cause.
IronBarcode lit et écrit à la fois des symboles 1D et 2D via une API commerciale .NET. Codex gère mieux certains de ces travaux que d'autres. Il est bon pour épingler la version du package, créer un générateur et un lecteur d'étiquettes, lire des codes-barres dans des PDF, corriger des images qu'un lecteur rejette, et migrer d'une autre bibliothèque de codes-barres, et chacune de ces tâches commence par une invite.
Démarrage rapideDémarrez Codex à partir d'un arbre de travail propre dans un projet de console. Énoncez clairement le résultat souhaité, les contraintes éventuelles, et les informations que vous souhaitez voir rapportées.
$ironbarcode Add the BarCode package, then update Program.cs to read a scanned
multi-page TIFF and report every barcode it finds, page by page. Each line of output
should give the page number, the decoded value and the format. Use the license
key from IRONBARCODE_LICENSE_KEY.
Constraints: Use only documented IronBarcode APIs. Do not modify or use any
other packages.
Build the project, resolve any errors, and provide the diff alongside the
output from a sample file.
Une solution correcte est courte, car BarcodeReader.Read parcourt les images d'un TIFF à plusieurs pages ou d'un GIF animé de manière autonome, sans séparation manuelle des images. Définir ExpectMultipleBarcodes aide lorsqu'une seule image contient plusieurs symboles, mais le lecteur atteint de toute façon chaque image. L'invite est plus longue que le code résultant, et demander le diff à l'avance vous permet de vérifier les changements réels plutôt qu'une description. Chaque résultat comporte une valeur PageNumber indexée à partir de 1, qui fournit la sortie page par page demandée par l'invite, et le guide GIF et TIFF à plusieurs pages couvre la lecture.
Flux de travail minimal en 5 étapes
- Télécharger la bibliothèque de codes-barres C# depuis NuGet
- Validez un fichier
AGENTS.mdspécifiant IronBarcode comme bibliothèque de codes-barres du projet. - Démarrez Codex à partir d'un arbre de travail propre et incluez la symbologie, les fichiers, et le résultat de relecture attendu dans l'invite.
- Laissez Codex modifier les fichiers et exécuter
dotnet build, puis examinez le diff avant d'accepter tout changement. - Finalisez le cycle aller-retour et vérifiez chaque nom d'API IronBarcode par rapport à la référence API.
Comment Codex s'intègre-t-il dans un projet de code-barres .NET?
Dans les permissions que vous lui donnez, Codex lit et écrit des fichiers, exécute des commandes shell, et montre ce qu'il a fait. OpenAI distribue le même agent à travers plusieurs points d'entrée qui partagent votre compte et votre historique. Les documentations du CLI Codex et de l’extension IDE expliquent leurs différences.
| Surface | Où il fonctionne | À utiliser lorsque |
|---|---|---|
| CLI | Terminal | L'agent devrait être placé à côté de dotnet build |
| Extension IDE | VS Code, JetBrains, Xcode | Vous voulez le diff et l'image du code-barres côte à côte |
| Application de bureau | macOS, Windows | Une tâche plus longue, hors du terminal |
| Cloud | Navigateur | Délégation, et récupération du diff plus tard |
Un AGENTS.md couvre les quatre, car il est versionné dans le dépôt plutôt qu'attaché à une surface.
Pour installer le CLI, exécutez npm install -g @openai/codex ou, sur macOS, brew install --cask codex. Pour macOS et Linux, un installateur autonome est disponible qui ne nécessite pas Node.js : curl -fsSL https://chatgpt.com/codex/install.sh |sh. Le dépôt du CLI Codex contient le code source et les notes de version.
@openai/ lors de l'installation. Le paquet npm nommé codex est un générateur de site statique sans rapport, publié pour la première fois en 2011 et mis à jour pour la dernière fois en 2012. IronBarcode a le piège opposé, car son paquet NuGet est BarCode, pas IronBarcode. Les noms de paquets exacts sont importants lorsqu'un agent tape la commande.Codex ne connaît pas de manière fiable l'API actuelle d'IronBarcode. Il utilise ses données d'entraînement et la documentation que vous lui fournissez, et appeler une méthode qu'une version ultérieure a supprimée est un échec courant avec les bibliothèques tierces. OpenAI construit Codex pour exécuter des commandes et vérifier sa sortie, mais recommande tout de même de revoir le travail avant sa publication. Le guide parent liste la documentation à fournir à l'avance à tous ces outils. Échangez le nom de fichier de contexte et le même paramétrage s'étend à Claude Code, GitHub Copilot, Cursor, ou Google Antigravity.
Le niveau change la forme du code ainsi que la facture. Une invite exécutée sur deux niveaux revient structurée de deux manières différentes, toutes deux défendables. L'encodage de code-barres doit être à l'opposé, car une valeur entre et un symbole sort que chaque scanner lit de manière identique. Donc, indiquez la symbologie, la taille, et le critère de réussite, et laissez le reste varier.
Quatre choses en découlent, et elles plaident toutes pour une bibliothèque maintenue plutôt qu'une construite par un agent :
- La validation fonctionne des deux côtés : une valeur invalide est refusée à l'écriture avec une exception nommée comme
IronBarCodeFormatOnlyAcceptsNumericValuesEncodingException, tandis queConfidenceThresholdetRemoveFalsePositiverejettent les décodages non fiables au retour. - Les véritables scans sont la partie difficile : les photos de téléphone, les étiquettes inclinées, et les PDF multipages nécessitent des régions de recadrage, des préréglages de vitesse, et des filtres d'image, ceux-ci se trouvent tous sur
BarcodeReaderOptions. - Une API couvre les formats : Code 128, GS1-128, EAN, UPC, QR, DataMatrix, PDF417, Aztec, MaxiCode, etc. partagent les mêmes appels de lecture et d'écriture, listés en entier sous Formats de codes-barres supportés.
- Quelqu'un le corrige : les projets populaires de codes-barres gratuits restent non maintenus tandis qu'une bibliothèque commerciale a quelqu'un de responsable, avec des correctifs publiés sur une page CVE de sécurité.
Un encodeur fait maison dessinera facilement une valeur que son format ne peut pas contenir selon ses spécifications, et toute bibliothèque décode une image générée propre. Verify est ce qui sépare les deux, décodant une image générée et la comparant avec la valeur que vous avez écrite.
Qu'est-ce qui rend une invite IronBarcode efficace?
Réponses spécifiques à six questions. Des invites vagues génèrent un code générique destiné à une bibliothèque qui n'existe pas, et des invites spécifiques génèrent un code que vous pouvez examiner en une demi-minute.
| Composant | Faible | Fort |
|---|---|---|
| Framework | Créer un code-barres | C#, .NET 9 |
| Emplacement | Non précisé | Services/LabelService.cs |
| Version | Non précisé | La version BarCode dans le .csproj |
| Symbologie | Un code-barres | Code 128, le numéro de suivi |
| Résultat | Un joli code-barres | PNG 400x120, valeur en dessous, redonne la même valeur à la lecture |
| Limites | Aucune | Pas de nouveaux paquets. Lectures asynchrones. Demandez en cas de doute. |
Les modèles de langage ont tendance à produire une réponse plutôt que de concéder l'incertitude. Indiquez à l'agent que signaler l'incertitude est un résultat acceptable, et il invente moins d'APIs. Donnez-lui la permission explicite de s'arrêter au lieu de deviner.
Un fichier AGENTS.md versionné bénéficie à tout le projet, car Codex le charge comme instructions permanentes au début de chaque session. Le fichier racine est lu en premier et les fichiers imbriqués ensuite, et le fichier le plus proche l'emporte, donc un second AGENTS.md à l'intérieur d'un dossier de codes-barres resserre les règles pour ce dossier sans toucher au reste du dépôt. /init génère un fichier de démarrage si vous n'en avez pas.
Référencez la documentation lisible par machine d'IronBarcode dans le fichier. Le fichier llms.txt liste chaque page de documentation avec un résumé, et skill.md présente les packages par plate-forme, les règles de licence, les exemples détaillés, et les noms d'exceptions à attendre lorsqu'une erreur se produit.
Codex scanne .agents/skills dans chaque répertoire de votre répertoire de travail jusqu'à la racine du dépôt, donc skill.md trouve sa place dans .agents/skills/ironbarcode/SKILL.md. Codex associe une tâche au champ description du frontmatter, et vous pouvez le forcer avec $ironbarcode lorsque vous souhaitez les recettes dans le contexte dès le premier échange. Le même dossier fonctionne dans Antigravity, qui lit également ce chemin. Demandez les deux fichiers ainsi que le fichier imbriqué :
Run /init if AGENTS.md does not exist yet. Then add a Barcodes section to the
root AGENTS.md: IronBarcode (NuGet package BarCode, namespace IronBarCode) is
the only barcode library in this repository, and no competing package may be
added. https://ironsoftware.com/barcode/csharp/llms.txt gets read before any
barcode code gets written, and a member that does not appear there does not get
called. https://ironsoftware.com/barcode/csharp/skill.md belongs in
.agents/skills/ironbarcode/SKILL.md. The license key is read from the
IRONBARCODE_LICENSE_KEY environment variable and is never inlined.
Then add a second AGENTS.md under Services/ that narrows this to the reader
options this folder relies on, so the nested file wins there. Show me both files
as a diff before you commit anything.
Comment demandez-vous à Codex d'ajouter IronBarcode et d'écrire un premier code-barres?
Laissez l'agent gérer la configuration d'abord. Les erreurs de version et de nom de paquet commencent là.
This project needs IronBarcode. Pull in the BarCode package, then show me the
resulting PackageReference line from the .csproj and tell me which version was
installed. Do not change any other package references.
Vous devez obtenir un diff d'une ligne et la version qu'il a installée. Ce numéro vaut la peine d'être cité dans les invites ultérieures, et il démasque un agent qui a ajouté un autre paquet avec barcode dans son nom. Pour épingler une version spécifique à la place, consultez le journal des modifications IronBarcode.
IronBarcode n'a pas de mode de filigrane. Passé la période de grâce de développement, un appel non licencié échoue carrément avec LicensingException. Définissez la clé au démarrage, avant tout autre appel IronBarcode, et laissez Codex l'ajouter.
Wire up licensing. Nothing else in IronBarcode may run ahead of it, so it goes
wherever this project does its startup work, pulling the value out of
IRONBARCODE_LICENSE_KEY rather than carrying a key in source.
Prove it took by checking IronBarCode.License.IsLicensed, and tell me which file
you put the call in.
La documentation Clés de licence IronBarcode couvre les clés d'essai et toutes les autres options de licence, y compris Web.config et appsettings.json.
Ensuite, construisez un service d'étiquette et un scanner. Dans les systèmes réels, les codes-barres sont créés à un endroit et lus ailleurs.
Two files, one job. Shipping labels go out as Code 128 PNGs at 400 by 120
with the tracking number printed under the bars, and something on the receiving
end has to turn that image back into the tracking number.
Put the writer in Services/ShippingLabelBarcode.cs and the reader in
Services/TrackingScanner.cs. The read is async and returns null rather than
throwing when the image holds nothing.
Compile, clear the errors, and report back with the changed files and whichever
BarCode version the restore resolved to.
Vérifiez chaque membre dans le diff par rapport à la référence API avant de l'accepter. Un encodeur correct repose sur BarcodeWriter.CreateBarcode, ResizeTo, AddBarcodeValueTextBelowBarcode, SetMargins, et ToPngBinaryData, et un lecteur correct sur BarcodeReaderOptions et BarcodeReader.ReadAsync, avec ExpectBarcodeTypes nommant la symbologie afin que le lecteur cesse de chercher chaque format. Pour les images provenant de caméras ou de scanners plutôt que de ce service, le guide de correction d'image explique les filtres qui sauvent les scans faibles.
Comment migrez-vous une implémentation de code-barres existante vers IronBarcode?
Le travail de migration est répétitif et mécanique, ce que les agents font bien. Orientez l'invite vers le code réel plutôt que de le résumer.
Hand this to the explorer agent, because nothing here should be written yet.
Labels/LegacyBarcodeService.cs currently writes and reads barcodes with another
library.
1. List every symbology it writes and reads, with the options it sets
(size, margins, text, check digits, error correction).
2. Map each call to its IronBarcode equivalent, citing the documentation page.
3. Do not write any code yet. Wait for my approval on the plan.
Une implémentation de 400 lignes nécessite un examen ligne par ligne, tandis qu'une erreur dans une table de correspondance ne coûte qu'une seule correction et qu'aucun code n'est éliminé.
Une fois que vous approuvez le plan, l'invite suivante reste étroitement ciblée.
Put the worker agent on the approved plan. Rewrite LegacyBarcodeService.cs to
use IronBarcode, keeping the existing public method signatures so callers do
not change.
Before removing the old library, generate every symbology the service
supports with both implementations and confirm IronBarcode reads back the
same values. Leave the old library in Git history only. Build and report the diff.
Indiquez dans l'invite que les signatures des méthodes publiques ne doivent pas changer. Sans cette instruction, un agent redessine souvent la façon dont les appelants utilisent le service, ce qui transforme une migration en refactorisation. Générer chaque symbologie avec les deux implémentations et comparer les valeurs décodées vous donne un test de régression, et cela coûte un cycle supplémentaire de compilation et d'exécution.
Comment corriger les échecs de lecture à l’aide d’invites ?
Une lecture échouée est un problème visuel, et l'agent n'a pas de vue sur la caméra. Votre invite doit décrire le problème, ou mieux encore, inclure les images.
TrackingScanner finds nothing in TestData/warehouse/, yet a warehouse operator
can point a handheld at the same printed label and get a read. The photos are
shot at an angle and a few are soft. I have attached one of the failing photos
with `codex -i`, so look at it rather than reasoning from the file names.
Read TrackingScanner.cs and a sample of the images. Explain the likely cause
before changing anything, then adjust BarcodeReaderOptions only (speed, crop
area, image filters). Do not change ShippingLabelBarcode.cs. Report how many
images read before and after.
Énoncer le symptôme et nommer le seul fichier à modifier limite la portée de la correction. Un décompte avant et après remplace une vague impression d'amélioration par un nombre. La correction est généralement l'une des trois : Speed réglée sur Detailed, une CropArea dessinée autour de l'étiquette, ou un seul filtre d'image choisi pour le défaut réel. Empiler les filtres réduit la précision au lieu de l’améliorer. Les détails sont sur les pages vitesse de lecture et région de recadrage.
Les faux positifs sont le problème inverse. Traitez-les de la même manière.
ScanService occasionally returns a value from product photos that contain no
barcode. Set RemoveFalsePositive and a ConfidenceThreshold on the reader options,
then link me to the documentation page you used.
Le lien de documentation sert également de vérification. Un agent qui ne peut pas citer une véritable page pour l'API qu'il a choisie vous a averti avant que la compilation ne le fasse. Les options de lecture sont faciles à inventer, alors gardez le guide des faux positifs à proximité.
Comment déboguer une défaillance de code-barres de bout en bout?
Chaque invite précédente couvre une tâche. Codex fait plus lorsque vous lui confiez un symptôme et que vous le laissez inspecter, diagnostiquer, réparer, et tester par lui-même.
Switch to Sol with /model before you start, because this one has resisted the
cheaper tiers. DataMatrix labels with non-English product names are refused by
some of our older handheld scanners, while labels with plain ASCII names read
fine on the same devices, and every label reads correctly with IronBarcode
itself.
Investigate:
1. Read LabelService.cs and find how the DataMatrix codes are created.
2. Identify why the non-English labels fail on those scanners only.
3. Explain the cause before changing anything.
4. Then propose the minimal fix, and what it costs, before applying it.
Demander d'abord la cause vous donne un diagnostic à juger, plutôt qu'une modification à décoder ensuite. Ici, la cause probable est l'en-tête ECI UTF-8. IronBarcode écrit cet en-tête uniquement lorsque le texte contient des caractères non-ASCII, et les scanners construits avant l'existence d'ECI rejettent un symbole qui en comporte un. Désactiver l'en-tête casse le texte UTF-8 sur les scanners qui supportent ECI, donc le compromis est réel. La version 2026.9.2 a ajouté EciMode pour le contrôler, comme décrit dans le guide d'encodage ECI.
Traitez les messages d'erreur de la même manière. Une trace de pile complète est l’élément le plus utile que vous puissiez donner à un agent.
TrackingScanner.ReadTrackingNumberAsync throws inside our Linux container. The
identical call succeeds on a Windows developer machine.
[PASTE FULL EXCEPTION AND STACK TRACE HERE]
Send the explorer subagent over the .csproj and the Dockerfile before changing
anything, and tell me which BarCode package we actually reference and what the
image is missing, quoting the line from each file that shows it.
Then give me the fix as a diff limited to those two files. Application code is
out of scope for this one.
Les échecs à l'intérieur des conteneurs proviennent généralement du package de la plate-forme ou d'une dépendance native manquante. Ces correctifs appartiennent au fichier projet et au Dockerfile, pas à C#. Demandez à Codex de lire Exécuter IronBarcode dans Docker sur Linux pour obtenir des conseils actuels de déploiement avant qu'il ne change quoi que ce soit.
Comment transformer un code ponctuel en composants réutilisables et testés?
Lorsque la génération et la relecture fonctionnent, généralisez ensuite le code. Les agents gèrent cela bien parce que le modèle existe déjà dans le fichier.
Refactor ShippingLabelBarcode and TrackingScanner into a BarcodeService
registered with dependency injection. It should write any of Code 128, QR,
and DataMatrix, and read with options narrowed to the formats requested.
Reuse one BarcodeReaderOptions instance per format set rather than building
one per call. Add XML doc comments. Keep it under 80 lines.
L'instruction pour réutiliser les options appartient à AGENTS.md. Dans un service de numérisation chargé, construire un nouvel objet d'options par requête est une allocation que vous payez à chaque numérisation.
Les tests viennent ensuite. Un code-barres se décodera soit avec la valeur que vous avez écrite soit non, ce qui simplifie les assertions.
This is a rebuild-and-rerun loop rather than a reasoning problem, so drop to
Luna with /model first. Cover BarcodeService with xUnit tests, then run them and
tell me the pass count.
Four behaviors need covering. A sample value survives a write and a read on
every format the service supports. EAN-13 rejects a value containing letters.
An image holding no barcode comes back empty instead of throwing. A path that
does not exist throws something a caller can read.
Never assert on image bytes. Decoded value and format are the only outputs
worth pinning.
Éviter les comparaisons d'octets dès le départ empêche les tests non fiables. Les encodeurs peuvent produire des octets d'image légèrement différents selon les versions et les plateformes, même si le code-barres reste inchangé. Au lieu de cela, testez la valeur et le format décodés.
Codex est également utile pour lire la documentation elle-même. Lorsque vous nommez une classe inconnue, il localise la partie pertinente de la référence API plutôt que de vous laisser défiler toute la page.
$ironbarcode Read the IronBarcode API reference for BarcodeReaderOptions and
list every option that affects reading speed or accuracy, then show which ones
this project already sets.
Quel modèle d'invite convient à quelle tâche?
Chaque invite ci-dessus nomme quelque chose de concret et demande en retour quelque chose de vérifiable.
| Tâches | Nom dans l'invite | Demander en retour |
|---|---|---|
| Package | BarCode, la version, rien d'autre | La ligne PackageReference |
| Clé de licence | IRONBARCODE_LICENSE_KEY, chemin de démarrage | License.IsLicensed vrai |
| Encodeur et lecteur | Symbologie, les deux chemins, taille de l'image | Deux fichiers qui compilent |
| Migration | Fichier hérité, signatures à conserver | Une table de correspondance, avant le code |
| Scans échoués | Dossier d'images, options de lecture seulement | Nombre de lectures avant et après |
| Faux positifs | RemoveFalsePositive, ConfidenceThreshold | La page qu'il a citée |
| Échec du conteneur | Trace de pile, plate-forme, deux fichiers | Un diff, .csproj et Dockerfile |
| Refactorisation | Formats, structure d’injection de dépendances, nombre maximal de lignes | Une instance d'options par format |
| Tests | Quatre comportements, sans assertions d'octets | Le nombre de tests réussis |
Comment réutiliser ces invites pour le prochain projet?
Chaque modèle passe à un nouveau projet avec uniquement les noms de fichiers modifiés, c'est pourquoi les règles appartiennent au contrôle de version et non à l'historique de chat.
Pour mesurer une session plutôt que lui faire confiance, le guide des assistants et agents de codage AI confie une tâche à un agent et évalue ce qui revient.
Dépannage
- Appliquer une clé de licence dans IronBarcode lorsque le diff semble correct et que l'exécution échoue toujours.
- Code-barres non reconnu lorsque le scanner écrit par Codex ne renvoie rien pour les images qui devraient se lire.
- Éviter les faux positifs dans la numérisation de code-barres lorsque les valeurs reviennent de photos ne contenant aucun code-barres.
- Exécuter IronBarcode dans Docker sur Linux lorsque le même code passe sur Windows et échoue dans le conteneur.
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.