IronQR'yi ChatGPT Codex ile Nasıl Kullanılır

Curtis Chau
Curtis Chau
Güncellendi: 9 Ekim 2026

QR kod yığınları, taranmış varlık etiketlerini, yerinde çekilen telefon fotoğraflarını, faks kopyalarını, tarayıcı hatalarından gelen sıfır bayt dosyalarını ve kod içermeyen kapak sayfalarını içeren düzensiz klasörler olarak sık sık gelir. Tek tek dosyayı işleyen basit bir döngü, ilk bozuk dosyada durur ve hangi görüntülerin başarısız olduğunu veya neden başarısız olduğunu takip etmez.

ChatGPT Codex, OpenAI'nin kodlama aracıdır. Terminals, IDE'ler, ChatGPT masaüstü uygulaması ve bulutta, tümü tek bir ChatGPT oturumu altında çalıştırılır. IronQR, Iron Software'ın .NET QR kod kütüphanesidir.

Her bir istem, Codex'e görevi gerçekleştirmesini ve görüntü başına bir satır içeren bir sonuç dosyası oluşturmasını söyler. Veri toplu işleri, sonuç vermeyen dosyaları işleyebileceğinden, bu kılavuzda belirtilen tüm sayılar, istemlerde belirtildiği gibi bu sonuç dosyalarından türetilmiştir.

Hızlı Başlangıç
NuGetNuGet ile Yükle

PM > Install-Package IronQR

Yukarıdaki komutu NuGet Paket Yöneticisi Konsolunda çalıştırarak veya NuGet Paket Yöneticisinde arama yaparak IronQR'u yükleyin.

Görüntü dosyanızı içeren bir .NET konsol projesinde Codex'i başlatın ve toplu işleme gereksinimlerinizi belirtin.

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

$ironqr bahsi, Codex kod yazmadan önce IronQR'nin yeteneğini yükler.



ChatGPT Codex nedir ve .NET QR kod çalışmasında nasıl bir role sahiptir?

Codex, ona verdiğiniz izinler dahilinde çalışır. Kod çözücüyü yazar, görüntüler üzerinde çalıştırır, çıktıyı okur ve kodu düzeltir. CLI'yi Codex CLI deposu ndan npm install -g @openai/codex ile yükleyin ve terminal kullanımı için Codex CLI belgeleri ne bakın.

Zemin gerçekliği ile birikmiş bir yığın incelemeyi kısa tutar. Uydurulmuş bir eleman derlemeyi başarısız kılar ve yanlış bir çözüm satır olarak Backlog/manifest.csv ile uyumsuz görünür.

Ajans her yığını farklı şekilde yapılandırabilir, ancak kod çözücü belirli bir görüntü için verilen herhangi bir konu sayısında aynı değeri döndürmek zorundadır. Bu tutarlılık kütüphaneye aittir ve IronQR, birikmiş bir yığında ihtiyaç duyulan bölümleri kapsar.

  • Bir arama ile fotoğraflar ve taramalar: QrScanMode.Auto modu, algılama modelini çalıştırır ve model hiçbir şey bulamıyorsa, temel bir tarama ile yeniden dener. tarama modları kılavuzu onu iki tek geçişli mod ile karşılaştırır.
  • Her sonucun simge türü: QrResult.QrType, standart QR (QrEncoding.QRCode) 'ü Micro QR ve rMQR'dan ayırır, böylece bir doğrulayıcı varlık etiketleri olmayan etiketleri reddedebilir.

Bir IronQR istemini nasıl yazarsınız ve Codex'i bunun için nasıl kurarsınız?

Etkili bir IronQR toplu istemi altı şeyi belirtir. Bu birikmiş dosya için girdiler, her PNG ve JPEG Backlog/images/ de, SemaphoreSlim ile belirlenen bir --concurrency opsiyonu eşzamansızlığı ayarlıyor ve çıktı, dosya başına bir satır ile out/pipeline.csv. Bir hata veren dosya işleri atlamayı sürdürürken boş bir satır alır. Kanıt, out/sequential.csv ile satır-satır eşleşmedir ve kısıtlamalar yeni paketler olmadan ve varsayılan olarak Auto'dur.

OpenAI'nin halüsinasyon araştırması kısmı eğitmen ve değerlendirme ödüllerinin tahmin üzerine çalıştığını bulmuştur ve toplu işte tahmin genellikle kapanış özetinde bir toplamdır.

İpuçları: Bir toplu istek göndermeden önce, adını verdiği çıktı dosyasını bulun.

Codex, depo .agents/skills klasöründe yetenekler keşfeder ve her beceri, ad ve açıklama içeren bir SKILL.md içeren bir klasördür. IronQR'nin skill.md dosyasını .agents/skills/ironqr/SKILL.md olarak kaydedin ve $ironqr bahsi çözülür. Codex, bir görevin açıklamasına uyduğunda bahse gerek kalmadan yeteneği de seçebilir.

AGENTS.md her oturumun başladığı kuralları taşır. Codex, başlangıç klasörüne yakın olan depo kökü ve klasör arasındaki her dizinden en fazla bir dosyayı okur ve daha derindeki bir dosya üstündeki yönergeleri geçersiz kılar. /init komutu bir taslak hazırlar. Aşağıdaki istem IronQR'nin llms.txt dizinini bir API referansı olarak da adlandırır.

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

Codex'ten IronQR eklemesini ve birinci klasörü çözmesini nasıl istersiniz?

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

IronQR paketi, yönetilen API için IronQR.Slim, algılama için Microsoft.ML.OnnxRuntime ve Windows yerel okuyucularını getirir. Yalnızca IronQR.Slim üzerinde olan bir proje, Windows'ta IronSoftware.ReaderInternals.Windows da gerektirir, temel tarama ile hala okur ama algılama modelini çalıştıramaz. Paket IronQR olarak büyük R ile gelirken, namespace IronQr. using IronQR yönergesi derlenemez. Bir bir yayını sabitlemeden önce IronQR değişim günlüğünü kontrol edin.

IronQR, okumaların üzerine deneme filigranı eklemez. İlk lisanssız okuma, "Üretim Lisansı Gerektirir" mesajıyla LicensingException atar ve ReadAsync ile görev beklendiğinde istisna ortaya çıkar. Bir toplu işte, bu resim başına bir aynı hata satırı olur.

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

lisans anahtarları sayfası, deneme anahtarlarını ve IronQR'nin ayrıca okuduğu yapılandırma dosyalarını kapsar. İstisna türü IronQr bileşeni içinde kaldığından, LicensingException tipine göre yakalamak CS0122 hatası ile derlenmez.

Sıralı bir kod çözücü sıradadır ve sonuç dosyası daha hızlı modlar için bir referans olur.

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

IronQR ile bir klasörü eşzamanlı olarak nasıl çözersiniz?

eşzamanlı ve çoklu iş parçacığı kılavuzu, her yineleme için ayrı bir okuyucunun güvenli varsayılan olduğunu belirtir, çünkü IronQR, paylaşılan bir örnek için açık bir iş parçacığı güvenliği garantisi vermez. Sonraki istem, Codex'in yerleşik keşif acenti, kod tabanı keşfi için okuma ağırlıklı bir acenta ve herhangi bir şey paralel olmadan önce bunu belgeyle karşılaştırır.

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

Kalibrasyonda, bir okuyucuyu 32 iş parçacığı arasında paylaşmak, dosya başına bir okuyucu ile aynı sonuçları üretti. Daha sonraki bir sürüm farklı olabilir ve dosya başına bir okuyucunun maliyeti düşüktür.

Girdi nesnesi de dikkat gerektirir. 2026.10.1 sürümünde, etrafına bir using bloğu koymak, başarılı bir okuma sonrasında bile çıkışta NotImplementedException fırlatır, bu yüzden bir toplu iş her iyi görüntüyü bir hata olarak kaydederdi. Her farkı inceleyin.

Paralel versiyon için, istem yerleşik işçi ajansı, kendi iş parçacığında düzenlemeyi gerçekleştirir.

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

Async void olarak derlenen Parallel.ForEach ya geçirilen bir async lambda, döngünün okumalar bitmeden dönmesine ve sonuç dosyasının eksik çıkmasına neden olur. Sıralı dosya ile karşılaştırma bunu yakalar.

ReadAsync ile eşzamanlı okumaları nasıl sınırlandırırsınız?

Paralel bir döngü okuma başına bir iş parçacığı engeller. ReadAsync, sabit bir okuma sayısını sürerken SemaphoreSlim'ın arkasında bırakır ve çağrı iş parçacığını serbest bırakır, yüksek hacimli partiler için async kılavuzun verdiği desendir. Bir IQrInput alır ve bir dosya yolu için yük aşırı olması yoktur, bu yüzden her görev kendi bitmap'ini hala açar.

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

Algılama modeli zaten bir okuma üzerinden birkaç çekirdeğe yayılmıştır, dolayısıyla daha yüksek bir sınırlamanın daha hızlı çalışması gerekmeyebilir. Donanımınıza göre sınırı runs.csv belirlemesine izin verin ve neyi güvenilir bir şekilde yaptığı için bu kodu koruyun, bu bellek kullanımını sınırlamaktır.

Toplu bir iş hangi tarama modunu kullanmalıdır?

Algılama modeli, temel geçişin kaçırdığı fotoğrafları okur ve aynı zamanda her okumada en fazla zamanı alır.

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

Her iki mod da her temiz tarama ve faks kopyasını okur ve her biri farklı birkaç telefon fotoğrafını kaçırdı. Sadece temel geçişin okuduğu fotoğraflarda, algılama modeli kodu buldu ama çözemedi, bu yüzden Auto asla geri dönmedi. QrScanMode.OnlyBasicScan ile boş dosyaları tekrar denemek, her fotoğrafı geri kazandı.

Kod çözülen değerleri nasıl doğrular ve hataları nasıl rapor edersiniz?

Bir veri yığını, kodda farklı görünen üç tür hatayla karşılaşır.

GirişSonuçDurumu
Boş, kesilmiş veya resim olmayan dosyaGörüntü yükü, IronQR çalışmadan önce hata atarOkunamayan
Kod yok veya hata düzeltmenin ötesinde hasarHer zaman boş, asla null olmayan bir koleksiyonBoş
Algılama modunda okunan herhangi bir kodKöşe noktaları, boş bir Value, QrEncoding.None'nın QrTypeBoş, Çözülen Değil

Üçüncü satır tehlikeli olanıdır. İlk sıradaki kod çözücümüz, herhangi bir sonucun geri dönüp dönmediğini kontrol ettiği için bunu Çözülen olarak sayardı.

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

Bir kontrol rakamı verinizin bir parçasıdır, bu yüzden IronQR bunu doğrulamaz. Okumadaki Reed-Solomon düzeltmesi, sağlama toplamı ve hata toleransı kılavuzu nda açıklandığı gibi, yalnızca simgenin çözüldüğünü kanıtlar ve bir sonuç güven oyu taşımaz. Yanlış bir kontrol rakamına sahip bir etiket temiz taranır ama hala geçersizdir.

IronQR'nin hata mesajları kılavuzu, bir sonraki istemde tüm yığına uygulanan dosya başına günlükleme modelini gösterir.

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

2026.10.1 sürümünde, IronQr.Logging.Logger günlüğü, her okuyucunun aldığı tarama yolunu kaydeder, örneğin makine öğrenimi modeli ile bir algılama taraması. Raporda yalnızca JSONL olduğu için, kod çözücü tarafından güncellenmeyen hata, sonuç dosyası ile uyuşmayan bir sayı olarak görünür.

Kodlama başarısız olan bir görüntüyü nasıl teşhis edersiniz?

Codex bir resme bakabilir. Oturuma başlarken dosyayı codex --image ile ekleyin veya besteciye yapıştırın.

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

Bizim çalışmamızda, bu dosya için üç mod da boş geri döndü ve kalibrasyonda algılama modeli bulmak için hiçbir şey bulamadı. Kodun kendisi hasarlı, bu yüzden kaybın hata düzeltimi ile toparlayabileceği seviyenin ötesinde, başka bir okuma ya da aynı etiketin yeniden taranması bunu değiştirmez. Çözüm, bir yedek etiket ve eğer etiketleri kendiniz basıyorsanız, daha yüksek bir hata düzeltme seviyesi dir.

Yanlış toplu çıktı sonuna kadar nasıl hata ayıklarsınız?

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

Herhangi bir düzeltme öncesinde teşhisi onaylayın. İyi bir çözüm, başarıyı belirleyen satırı alıntılar. Önerilen düzeltmeyi out/mode-fallback.csv ile de karşılaştırın.

Geçici kodu yeniden kullanılabilir, test edilmiş bileşenlere nasıl dönüştürürsünüz?

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

Bir yeniden düzenleme doğrulayıcıyı, temel tarama yeniden denemesini veya dosya başına okuyucuyu bir derleme hatası olmadan düşürebilir. Sadece gerçek verilere karşı tam bir yeniden yürütme bunu yakalayabilir.

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

Manifest durum ve değeri düzeltir, zamanlamalar çalıştırmadan çalıştırmaya değişir.

Tekrarlayan IronQR sorularını depo yeteneğinde tutun. OpenAI'nin özel istemler sayfası, eski ~/.codex/prompts klasörünü yetenekler lehine kullanım dışı bırakıldı olarak işaretler.

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

Çalışmamızda, Codex bir sonucun dört üyesini listeledi ve işi kod çözücüden onu döndüren doğrulayıcı satırına kadar izledi.

Bu istemleri başka bir görüntü klasöründe nasıl yeniden kullanırsınız?

Yolları değiştirin ve yukarıdaki her istem yazıldığı gibi çalışır. AI kodlama yardımcıları kılavuzu baştan sona tek bir kabul istemi çalıştırır ve sonuçları yayınlar.

Gerçek bir çalıştırmada istemler ne üretti?

Yukarıdaki her isteği örnek bir depoya karşı, sırayla, bir iş parçacığında Codex'e gönderdik. 301 görüntü içeren bir konsol uygulaması ve birikmiş dosya tutar (temiz taramalar, telefon fotoğrafları, faks kopyaları, hasarlı etiketler, boş kapak sayfaları, Mikro QR raf etiketleri, geçersiz etiketler ve hiç resim olmayan altı dosya), her birinin beklenen durum ve değeri ile birlikte bir manifesto ile. Oturumdan sonra projeyi Yeniden Oluştur modunda yeniden derledik ve testleri çalıştırdık. Sonuçları kontrol etmek için her görüntüyü bağımsız olarak da çözdük.

  • Temel tarama yeniden denemesi Dekodeden 256'dan 264'e yükseldi. Öncesinde, her mod 301'in 256'sını çözüyor ve iki mod arasında 16 dosya farklıydı.
  • Temiz bir tarama, Auto altında medyan 360 ms ve temel tarama altında 35 ms sürdü ve tamamının limiti 2 iken 7 s içinde tamamladı.
  • Sıralı kod çözücü 256 Dekodlanmış, 39 Boş ve 6 Okunamayan 71 s sürede kaydetti.
  • Paralel mod, 32 iş parçacığında 60 s'de aynı 301 satırı yazdı ve boru hattı, 2, 8 ve 32 limitler ile 55, 66 ve 68 sn'de yazdı.
  • Hızlı başlangıçta, 12 satırdan 9'u çözüldü, 2 boş döndü ve 1 sıfır bayt dosya hata verdi.
  • Doğrulama, manifestoyu 240 Çözümlenmiş, 31 Boş, 8 Yanlış Sembol, 8 Geçersiz Format, 8 Kötü Kontrol Rakamı ve 6 Okunamayan ile eşleştirdi.
  • Başarısızlık raporu, başarısız olan dosya başına bir tane olmak üzere 61 kayıt içeriyordu.
  • Yeniden düzenlemeden sonra, 64 satırlık iş 301 üzerinde 301 satır ile manifestoya eşleşti ve 6 testin 6'sı geçti, yine Release modunda.
  • 16 istemin hepsi, her yapı geçerken ve manuel kod düzenlemesi olmadan çalıştı. İstem 13'ten 16'ya ücretsiz plan kullanım sınırlamasına ulaşıldı ve Codex tekrar oturum açtıkdan sonra aynı iş parçacığında devam etti.
  • Soruşturmadan önce, kod, fotoğraf JPEG'lerinde yalnızca algılama modu ve herhangi bir sonucu kabul eden bir başarı kontrolü buldu. Geceleri, planlanmış bir hata, günlüğü ve boşluklar listesi ile bir iş ekledik.

Codex'in sürümü, model, zamanlama ve test makinesi bu çalışma için paylaşılan çalıştırma kaydında yer alıyor.


Hata Ayıklama


Sorular?

Herhangi bir sorunuz varsa, support@ironsoftware.com adresinden bize ulaşın

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

Daha Fazla Oku

Başlamaya Hazır mısınız?

NuGet İndirmeleri 82,442Sürüm:2026.11yeni çıktı