Comment utiliser IronQR avec ChatGPT Codex
Les arriérés de codes QR arrivent souvent sous forme de dossiers désorganisés contenant des étiquettes d'actifs scannées, des photos de téléphone sur site, des copies de fax, des fichiers de taille nulle provenant d'erreurs de numérisation et des feuilles de couverture sans codes. Une boucle naïve qui traite un fichier à la fois s'arrête au premier fichier corrompu et ne suit pas les images échouées ou les raisons de l'échec.
ChatGPT Codex est l'agent de codage d'OpenAI. Il fonctionne dans les terminaux, les IDE, l'application de bureau ChatGPT et le cloud, le tout sous une seule connexion ChatGPT. IronQR est la bibliothèque de codes QR .NET d'Iron Software.
Chaque invite demande à Codex d'effectuer la tâche et de générer un fichier de résultats contenant une ligne par image. Comme les travaux par lots peuvent traiter des fichiers qui ne donnent aucun résultat, tous les décomptes référencés dans ce guide sont dérivés de ces fichiers de résultats, comme indiqué dans les invites.
Démarrage rapideDémarrez Codex dans un projet console .NET contenant votre dossier d'images et spécifiez les exigences de traitement par lots.
$ironqr Add the IronQR package to this console project, then make Program.cs
decode every file in Backlog/sample/ with QrReader.ReadAsync. Write
out/quickstart.csv with one row per file (name, decoded value or empty, QR
type, exception type if the file threw) and print the decoded, empty, and
threw counts by reading that CSV back. Load the key out of the
IRONQR_LICENSE_KEY variable. Call Dispose() on each QrImageInput yourself
instead of a using block, which throws in IronQR 2026.10.1. Run dotnet build
and dotnet run and fix whatever fails.
La mention $ironqr charge la compétence d'IronQR avant que Codex n'écrive du code.
Flux de travail minimal (5 étapes)
- Télécharger la bibliothèque de code QR C# depuis NuGet
- Enregistrez la compétence d'IronQR sous
.agents/skills/ironqr/SKILL.mdpour que$ironqrse résolve - Validez un
AGENTS.mdavec les règles de décodage QR du référentiel - Demandez un mode à la fois (séquentiel,
Parallel.ForEach, puisSemaphoreSlim) et comparez chaque fichier de résultats avec le précédent - Recherchez chaque membre utilisé par Codex dans la référence API et vérifiez le fichier de résultats final par rapport à vos données de référence
Qu'est-ce que ChatGPT Codex, et comment s'intègre-t-il dans le travail de codes QR .NET ?
Codex fonctionne dans les permissions que vous lui accordez. Il écrit le décodeur, l'exécute sur les images, lit la sortie et corrige le code. Installez l'interface de ligne de commande avec npm install -g @openai/codex depuis le référentiel CLI de Codex, et consultez la documentation CLI de Codex pour l'utilisation en terminal.
Un arriéré avec des données de référence rend la révision courte. Un membre inventé échoue à la construction, et un mauvais décodage se montre comme une ligne en désaccord avec Backlog/manifest.csv.
L'agent peut structurer chaque lot différemment, mais le décodeur doit retourner la même valeur pour une image donnée, quel que soit le nombre de threads. Cette cohérence appartient à la bibliothèque, et IronQR couvre les parties nécessaires à un arriéré.
- Photos et scans en un appel : le mode
QrScanMode.Autoexécute le modèle de détection et, lorsque le modèle ne trouve rien, réessaie avec un scan de base. Le guide des modes de numérisation le compare avec les deux modes de passage unique. - Le type de symbole sur chaque résultat :
QrResult.QrTypesépare le QR standard (QrEncoding.QRCode) du Micro QR et du rMQR, permettant ainsi à un validateur de rejeter les étiquettes qui ne sont pas des étiquettes d'actifs.
Comment rédigez-vous une invite IronQR et configurez-vous Codex pour celle-ci ?
Une invite de lot IronQR efficace énonce six choses. Pour cet arriéré, l'entrée est chaque PNG et JPEG dans Backlog/images/, un SemaphoreSlim dimensionné par une option --concurrency définit la concurrence, et la sortie est out/pipeline.csv avec une ligne par fichier. Un fichier qui lève une exception obtient une ligne tandis que le lot continue. La preuve est une correspondance ligne par ligne avec out/sequential.csv, et les contraintes sont pas de nouveaux packages et Auto comme valeur par défaut.
La recherche d'OpenAI sur l'hallucination montre que la formation et l'évaluation récompensent la supposition, et dans un travail par lots, la supposition est généralement un total dans le résumé de clôture.
Codex découvre des compétences dans le dossier .agents/skills du référentiel, et chaque compétence est un dossier contenant un SKILL.md avec un nom et une description dans sa frontmatter. Enregistrez le skill.md d'IronQR sous .agents/skills/ironqr/SKILL.md et la mention $ironqr se résout. Codex peut également choisir la compétence sans la mention lorsqu'une tâche correspond à sa description.
AGENTS.md contient les règles avec lesquelles chaque session commence. Codex lit au maximum un tel fichier par répertoire entre la racine du référentiel et le dossier où il a été démarré, et un fichier plus profond annule les conseils au-dessus de lui. La commande /init en rédige un. L'invite ci-dessous nomme également l'llms.txt d'IronQR comme référence API.
Create the repository's AGENTS.md with a section titled QR decoding. It
should say that IronQR (package IronQR, namespace IronQr) is the only QR
library here, that the ironqr skill in .agents/skills/ironqr/ and IronQR's
llms.txt documentation index are the API references, that the key is read
from IRONQR_LICENSE_KEY and never printed or written to a file, that
QrImageInput is disposed with an explicit Dispose() call and never a using
block, that Backlog/manifest.csv is ground truth and read-only, and that any
count, rate, or timing you report must come from a per-image results file
written in the same turn, named in your reply.
Comment demander à Codex d'ajouter IronQR et de décoder un premier dossier ?
Show me the IronQR PackageReference in AssetBacklog.csproj and the installed
version. Then run dotnet list package --include-transitive and quote the lines
for IronQR.Slim and Microsoft.ML.OnnxRuntime, since the detection model
depends on them. Change no package references.
Le paquet IronQR inclut IronQR.Slim pour l'API gérée, Microsoft.ML.OnnxRuntime pour la détection, et les lecteurs natifs Windows. Un projet uniquement sur IronQR.Slim, qui sur Windows a également besoin de IronSoftware.ReaderInternals.Windows, lit toujours avec le scan de base mais ne peut pas exécuter le modèle de détection. Le paquet est IronQR avec un R majuscule tandis que le namespace est IronQr, donc une directive using IronQR ne compile pas. Vérifiez le changelog IronQR avant de bloquer une version.
IronQR n'ajoute pas de filigrane d'essai aux lectures. Une première lecture sans licence lève LicensingException avec le message 'Production License Required', et avec ReadAsync, l'exception apparaît lorsque la tâche est attendue. Dans un lot, cela devient une ligne d'échec identique par image.
Move the license setup into a Startup.ApplyIronQrKey method called first in
Program.cs. If IRONQR_LICENSE_KEY is unset or License.IsLicensed is false,
exit with code 2 and one clear line on stderr before any image is opened,
because IronQR throws on the first read instead of degrading. Run the program
once as is and once with the variable removed for that single command, and
report both exit codes and what IsLicensed returned.
La page des clés de licence couvre les clés d'essai et les fichiers de configuration qu'IronQR lit également. Le type d'exception est interne à l'assemblée IronQr, donc attraper LicensingException par type ne compile pas et génère l'erreur CS0122.
Un décodeur séquentiel vient ensuite, et son fichier de résultats devient la référence pour chaque mode plus rapide.
Create Services/BacklogDecoder.cs with DecodeAsync(string path) returning an
ImageOutcome record: file, status (Decoded, Empty, Unreadable), values, QR
types, exception type and message, and milliseconds. Open the file with
AnyBitmap.FromFile, read with QrScanMode.Auto, and never let one file stop
the batch. Add a --sequential mode that runs it over Backlog/images/ one file
at a time, writes out/sequential.csv, and starts out/runs.csv with the mode
and wall time. Report the status counts and the wall time from those files.
Comment décoder un dossier en parallèle avec IronQR ?
Le guide asynchrone et multithreading recommande un lecteur distinct par itération comme défaut sûr, car IronQR ne fournit aucune garantie explicite de sécurité de thread pour une instance partagée. L'invite suivante comprend l'agent explorateur intégré de Codex, un agent principalement axé sur la lecture pour l'exploration du code, qui vérifie cela avec la documentation avant tout traitement parallèle.
Ask the explorer agent to answer this without editing anything. Before the
decoder goes parallel, list every QrReader, QrImageInput, and AnyBitmap that
BacklogDecoder creates or keeps, say which could be shared across threads,
and back each answer with a quote from
https://ironsoftware.com/qr/csharp/how-to/async-multithreading/ or the
ironqr skill. Flag anything the documentation leaves unstated.
Lors de la calibration, partager un lecteur sur 32 threads a produit les mêmes résultats qu'un lecteur par fichier. Une version ultérieure peut différer, et un lecteur par fichier coûte peu.
L'objet d'entrée nécessite également de l'attention. Dans la version 2026.10.1, un bloc using autour de lui lève NotImplementedException à la sortie, même après une lecture réussie, donc un lot enregistrerait chaque bonne image comme un échec. Examinez chaque différence pour en trouver un.
Pour la version parallèle, l'invite nomme l'agent intégré de travailleur, qui exécute la modification dans son propre thread.
Have the worker agent add a --parallel mode with Parallel.ForEach,
MaxDegreeOfParallelism from a --threads option (default
Environment.ProcessorCount), and a new QrReader per file. Use the synchronous
Read inside the loop body, since Parallel.ForEach does not await an async
lambda. Write out/parallel.csv sorted by file name, then compare its status
and value columns with out/sequential.csv and fix any row that differs
before you finish. Append mode, thread count, and wall time to out/runs.csv.
Une lambda asynchrone passée à Parallel.ForEach compile en async void, donc la boucle revient avant la fin des lectures et le fichier de résultats est incomplet. La comparaison avec le fichier séquentiel le détecte.
Comment limiter les lectures simultanées avec ReadAsync ?
Une boucle parallèle bloque un thread par lecture. ReadAsync derrière SemaphoreSlim maintient un nombre fixe de lectures en vol et laisse le thread appelant libre, le modèle que le guide asynchrone propose pour les lots à grand volume. Il prend un IQrInput et n'a pas de surcharge pour un chemin de fichier, donc chaque tâche ouvre toujours son propre bitmap.
Add a --pipeline mode: Task.WhenAll over every file, each task waiting on a
SemaphoreSlim sized by --concurrency and awaiting ReadAsync. Run it at
concurrency 2, 8, and Environment.ProcessorCount, writing
out/pipeline-c<N>.csv for each and appending to out/runs.csv. Confirm each
file matches out/sequential.csv row for row, then tell me which setting was
fastest according to runs.csv.
Le modèle de détection répartit déjà une lecture sur plusieurs cœurs, donc une limite plus élevée ne nécessite pas de fonctionner plus rapidement. Laissez runs.csv choisir la limite pour votre matériel, et gardez le sémaphore pour ce qu'il fait de manière fiable, c'est-à-dire limiter l'utilisation de la mémoire.
Quel mode de numérisation un lot doit-il utiliser ?
Le modèle de détection lit des photos que le passage de base rate, et il explique également la majeure partie du temps que prend chaque lecture.
Measure what the machine learning detector costs on this backlog. Run the
pipeline at the fastest concurrency from runs.csv, first under
QrScanMode.Auto and then under QrScanMode.OnlyBasicScan, writing
out/mode-auto.csv and out/mode-basic.csv with per-image milliseconds. Join
both with the category column of Backlog/manifest.csv and report decoded
count and median milliseconds per category for each mode. If either mode
reads files the other misses, keep Auto as the default and build a single
OnlyBasicScan retry of its Empty files into the decoder for every later run.
Rerun to out/mode-fallback.csv and count the recoveries.
Les deux modes lisent chaque scan propre et copie de fax, et chacun en a raté une poignée différente de photos de téléphone. Sur les photos que seul le passage de base a lues, le modèle de détection a localisé le code mais n'a pas pu le décoder, donc Auto ne s'est jamais rabattu. Réessayez les fichiers vides avec QrScanMode.OnlyBasicScan et récupérez chaque photo.
Comment validez-vous les valeurs décodées et signalez-vous les échecs ?
Un lot rencontre trois types d'échec, et chacun se présente différemment dans le code.
| Entrée | Résultat | Statut |
|---|---|---|
| Vide, tronqué ou fichier non-image | Le chargement de l'image lève une exception avant qu'IronQR ne s'exécute | Illisible |
| Aucun code, ou des dommages au-delà de la correction d'erreur | Une collection vide, jamais nulle | Vide |
| Tout code, lu en mode détection uniquement | Points d'angle, un Value vide, un QrType de QrEncoding.None | Vide, non décodé |
La troisième ligne est la dangereuse. Notre premier décodeur séquentiel l'aurait compté comme décodé, car il ne vérifiait que si un résultat revenait.
Backlog/README.md defines a valid asset tag. Add Services/TagValidator.cs and
apply it after each read: a decode only counts when the symbol is a standard
QR code (QrEncoding.QRCode), the value matches the documented pattern, and
the Luhn check digit holds. Give the others the statuses WrongSymbol,
InvalidFormat, or BadCheckDigit. Rerun the pipeline to out/validated.csv and
list every file whose status disagrees with expected_status in the manifest.
Un chiffre de contrôle fait partie de vos données, donc IronQR ne peut pas le valider. La correction Reed-Solomon à l'intérieur de la lecture, que le guide de la somme de contrôle et de la tolérance aux pannes décrit, ne prouve que le symbole décodé, et un résultat ne comporte aucune propriété de confiance. Une étiquette avec un mauvais chiffre de contrôle est scannée proprement mais reste invalide.
Le guide des messages d'erreur d'IronQR montre le modèle de journalisation par fichier que l'invite suivante applique à l'ensemble de l'arriéré.
Every file that is not Decoded needs a recorded reason. Write one JSON line
per file to out/decode-log.jsonl (file, status, exception type, message,
milliseconds), send IronQR's own log to out/ironqr-debug.log through
IronQr.Logging.Logger, and generate out/failures.md from the JSONL only: one
section per status other than Decoded, a count, and every file name. Then
check the section counts against out/validated.csv.
Dans la version 2026.10.1, le journal IronQr.Logging.Logger enregistre le chemin de numérisation emprunté par chaque lecture, tel qu'un scan de détection avec le modèle d'apprentissage automatique. Parce que le rapport est construit uniquement à partir du JSONL, un échec que le décodeur n'a jamais enregistré apparaît comme un décompte en désaccord avec le fichier de résultats.
Comment diagnostiquez-vous une image qui ne se décode pas ?
Codex peut examiner une image. Joignez le fichier avec codex --image lorsque vous démarrez la session, ou collez-le dans le compositeur.
I attached IMG_0018.png from Backlog/images/ with codex --image. The pipeline
marks it Empty. Look at the picture and tell me whether it is a damaged code,
a page with no code, or a capture problem a rescan would fix. Then test your
answer: read it with all three QrScanMode values and write
out/retry-IMG_0018.csv. Do not change the pipeline.
Dans notre exécution, tous les trois modes sont revenus vides pour ce fichier, et lors de la calibration, le modèle de détection n'a rien trouvé à localiser. Le code lui-même est endommagé, donc la perte dépasse la récupération de la correction d'erreur, et ni une autre lecture ni une nouvelle numérisation de la même étiquette ne changeront cela. La solution est un remplacement de l'étiquette et, si vous imprimez les étiquettes vous-même, un niveau supérieur de correction d'erreurs.
Comment déboguer la sortie incorrecte d'un lot de bout en bout?
Send the explorer agent into Jobs/NightlyImport.cs and Logs/nightly-2026-10-06/
before anything is edited. That run reported six unreadable files and no other
failure, yet Backlog/archive-index-gaps.csv lists assets the archive never
received. Find what the missing assets have in common, explain why the job
counted them as successes, and propose the smallest fix together with the
command that would prove it. Put the findings in out/nightly-diagnosis.md and
change no code.
Approuvez le diagnostic avant toute correction. Un bon diagnostic cite la ligne qui décide du succès. Vérifiez la correction proposée avec out/mode-fallback.csv également.
Comment transformer un code ponctuel en composants réutilisables et testés?
Put the worker agent on folding the modes into a BacklogJob class. Add the
Microsoft.Extensions.DependencyInjection package, register the job with it,
and configure it with a BacklogOptions record (input folder, concurrency,
scan mode, output folder). Keep the validator, the basic-scan retry, and the
logging in it, stay under 160 lines, and add XML doc comments. Before
finishing, run it over Backlog/images/ into out/final.csv and confirm every
row agrees with the manifest's expected_status and expected_value.
Un refactoring peut supprimer le validateur, la reprise de scan basique ou le lecteur par fichier sans erreur de construction. Seule une reprise complète contre la vérité de référence le détecte.
Add an xUnit project, AssetBacklog.Tests, and cover BacklogJob with tests
that read real files from Backlog/images/: a clean scan decodes to its
manifest value, the zero-byte file comes back Unreadable without throwing, a
damaged image is Empty, a Micro QR label is WrongSymbol, a bad check digit is
BadCheckDigit, and a parallel run over 40 files matches a sequential one.
Assert on status and value. Run dotnet test and report the totals it prints.
Le manifeste corrige le statut et la valeur, tandis que les temps changent d'une exécution à l'autre.
Conservez les questions récurrentes d'IronQR dans la compétence du référentiel. La page prompts personnalisés d'OpenAI marque le dossier plus ancien de ~/.codex/prompts comme obsolète au profit des compétences.
$ironqr Using the IronQR API reference, list every member of QrResult and say
whether IronQR reports a confidence or checksum score for a read. Then point
to the line in BacklogJob that decides a file is Decoded.
Dans notre exécution, Codex a listé les quatre membres d'un résultat et a tracé Décodé du travail via le décodeur jusqu'à la ligne de validation qui le renvoie.
Comment réutilisez-vous ces invites sur un autre dossier d'image ?
Changez les chemins, et chaque invite ci-dessus s'exécute telle qu'elle est écrite. Le guide des assistants de codage AI exécute une seule invite d'acceptation de bout en bout et publie le résultat.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Nous avons envoyé chaque invite ci-dessus à Codex dans l'ordre, dans un même fil, contre un référentiel d'exemple. Il contient une application console et un arriéré de 301 images (scans propres, photos de téléphone, copies de fax, étiquettes endommagées, feuilles de couverture vierges, étiquettes de rayon Micro QR, étiquettes invalides, et six fichiers qui ne sont pas des images du tout), avec un manifeste de l'état et de la valeur attendus de chacune. Après la session, nous avons reconstruit le projet en version Release et avons exécuté les tests. Nous avons également décodé chaque image indépendamment pour vérifier les résultats ci-dessous.
- La reprise du scan basique a augmenté Décodé de 256 à 264. Avant cela, chaque mode avait décodé 256 sur 301, et 16 fichiers différaient entre les deux.
- Un scan propre a pris un médian de 360 ms sous Auto et 35 ms sous le scan basique, qui a exécuté tout l'arriéré en 7 s à la limite de 2.
- Le décodeur séquentiel a enregistré 256 Décodés, 39 Vides et 6 Illisibles en 71 s.
- Le mode parallèle a écrit les mêmes 301 lignes en 60 s à 32 threads, et le pipeline les a écrites en 55, 66 et 68 s aux limites de 2, 8 et 32.
- Dans le démarrage rapide, 9 des 12 lignes ont été décodées, 2 sont revenues vides et 1 fichier de taille nulle a généré une exception.
- La validation a correspondu au manifeste avec 240 Décodés, 31 Vides, 8 WrongSymbol, 8 InvalidFormat, 8 BadCheckDigit et 6 Illisibles.
- Le rapport d'échec contenait 61 enregistrements, un par fichier échoué.
- Après le refactoring, le travail de 64 lignes a correspondu au manifeste sur 301 sur 301 lignes, et 6 des 6 tests ont été réussis, à nouveau en version Release.
- Les 16 invites ont été exécutées avec chaque construction réussie et aucune édition de code manuelle. Les invites 13 à 16 ont atteint la limite d'utilisation du plan gratuit et ont repris dans le même fil après que Codex s'est reconnecté.
- Avant l'invite d'enquête, nous avons ajouté un travail nocturne avec une erreur plantée, ses journaux et une liste de lacunes. Codex a trouvé le mode détection uniquement sur les JPEG de photos et une vérification de succès qui accepte tout résultat.
La version, le modèle, le timing et la machine de test de Codex pour cette exécution sont dans le registre de la course partagé.
Dépannage
- Async et Multithreading si une exécution parallèle écrit moins de lignes qu'il n'y a d'images
- Appliquer une clé de licence dans IronQR si chaque ligne du fichier de résultats montre le même échec de licence
- Lire les codes QR avec les modes de scan si les résultats reviennent avec des points d'angle et sans valeurs
- Exception de copie de runtime si le modèle de détection échoue à se charger après une publication
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.