Jak używać IronQR z ChatGPT Codex
Zaległości w kodach QR często przychodzą jako nieuporządkowane foldery zawierające zeskanowane tagi zasobów, zdjęcia telefonami z terenu, kopie faksów, pliki zero-byte z błędów skanera i strony tytułowe bez kodów. Naiwna pętla, która przetwarza jeden plik naraz, zatrzymuje się na pierwszym uszkodzonym pliku i nie śledzi, które obrazy nie powiodły się ani dlaczego.
ChatGPT Codex to agent programowania od OpenAI. Działa w terminalach, IDE, aplikacji desktopowej ChatGPT oraz w chmurze, wszystkie pod jedną rejestracją ChatGPT. IronQR to biblioteka kodów QR .NET firmy Iron Software.
Każda podpowiedź instruuje Codex, aby wykonać zadanie i wygenerować plik wynikowy zawierający jeden wiersz na obraz. Ponieważ zadania wsadowe mogą przetwarzać pliki, które nie dają żadnych wyników, wszystkie liczby odniesione w tym przewodniku pochodzą z tych plików wynikowych, jak wskazano w podpowiedziach.
Szybki startUruchomić Codex w projekcie konsoli .NET zawierającym folder obrazów i określić wymagania dotyczące przetwarzania wsadowego.
$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.
Wzmianka $ironqr ładuje umiejętności IronQR przed napisaniem przez Codex kodu.
Minimalny proces (5 kroków)
- Pobierz bibliotekę kodów QR C# z NuGet
- Zapisz umiejętności IronQR jako
.agents/skills/ironqr/SKILL.md, aby$ironqrsię rozwiązało. - Stwórz
AGENTS.mdz zasadami dekodowania QR repozytorium. - Proś o jeden tryb naraz (sekwencyjnie,
Parallel.ForEach, potemSemaphoreSlim) i porównaj każdy plik wynikowy z ostatnim. - Wyszukać każdego używanego członka Codex w dokumentacji API i sprawdzić ostateczny plik wyników w porównaniu z prawdziwym obrazem.
Czym jest ChatGPT Codex i jak wpisuje się w prace z kodami QR .NET?
Codex działa w ramach uprawnień, które mu przyznano. Pisze dekoder, uruchamia go na obrazach, odczytuje wyniki i poprawia kod. Zainstalować CLI z npm install -g @openai/codex z repozytorium Codex CLI i zobaczyć dokumentację Codex CLI do użycia w terminalu.
Zaległości z prawdziwymi danymi referencyjnymi przyspieszają przegląd. Wymyślony członek nie udaje się zbudować, a nieprawidłowe dekodowanie pojawia się jako wiersz, który nie zgadza się z Backlog/manifest.csv.
Agent może inaczej strukturzować każdą partię, ale dekoder musi zwracać tę samą wartość dla danego obrazu przy każdej liczbie wątków. Ta konsekwencja należy do biblioteki, a IronQR pokrywa części, które potrzebuje powrot.
- Zdjęcia i skany w jednym wywołaniu: tryb
QrScanMode.Autouruchamia model wykrywania i, gdy model niczego nie znajduje, ponawia próbę za pomocą podstawowego skanowania. Przewodnik po trybach skanowania porównuje go z dwoma trybami jednoprzepustowymi. - Typ symbolu na każdym wyniku:
QrResult.QrTypeseparuje standardowe QR (QrEncoding.QRCode) od Micro QR i rMQR, aby walidator mógł odrzucić etykiety, które nie są tagami zasobów.
Jak napisać podpowiedź IronQR i skonfigurować Codex do jego działania?
Skuteczna podpowiedź wsadowa IronQR zawiera sześć rzeczy. Dla tej zaległości, wejście to każdy PNG i JPEG w Backlog/images/, SemaphoreSlim o rozmiarze --concurrency ustawia współbieżność, a wyjście to out/pipeline.csv zawierające jeden wiersz na plik. Plik, który wyrzuca, dostaje wiersz, podczas gdy partia kontynuuje. Dowód to porównanie wiersz za wierszem z out/sequential.csv, a ograniczenia to brak nowych pakietów i Auto jako domyślny.
Badania OpenAI nad halucynacją wykazują, że trening i ocena nagradzają zgadywanie, a w zadaniu wsadowym zgaduje się zazwyczaj na koniec w podsumowaniu.
Codex odkrywa umiejętności w folderze .agents/skills repozytorium, a każda umiejętność to folder zawierający SKILL.md z nazwą i opisem we frontmatterze. Zapisz skill.md IronQR jako .agents/skills/ironqr/SKILL.md, a wzmianka $ironqr rozwiązuje się. Codex może również wybrać umiejętność bez wzmianki, gdy zadanie pasuje do jego opisu.
AGENTS.md zawiera zasady, od których każda sesja się rozpoczyna. Codex odczytuje najwyżej jeden taki plik z każdego katalogu między korzeniem repozytorium a folderem, w którym go uruchomiono, a głębszy plik nadpisuje wskazówki powyżej. Polecenie /init przygotowuje projekt. Poniższa podpowiedź również nazywa llms.txt jako indeks IronQR jako odniesienie 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.
Jak poprosić Codex o dodanie IronQR i dekodowanie pierwszego folderu?
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.
Paczka IronQR wprowadza IronQR.Slim dla zarządzanej API, Microsoft.ML.OnnxRuntime dla wykrywania i natywne czytniki Windows. Projekt na samym IronQR.Slim, który na Windows wymaga też IronSoftware.ReaderInternals.Windows, nadal czyta przy pomocy podstawowego skanowania, ale nie może uruchomić modelu wykrywania. Paczka to IronQR z dużą literą R, a przestrzeń nazw to IronQr, więc using IronQR dyrektywa nie udaje się skompilować. Sprawdź historię zmian IronQR, zanim przypniesz wydanie.
IronQR nie dodaje znaku wodnego do odczytów w wersji próbnej. Pierwszy nie licencjonowany odczyt wyrzuca LicensingException z komunikatem "Wymagana licencja produkcyjna", a z ReadAsync wyjątek pojawia się, gdy zadanie jest oczekiwane. W zadaniu wsadowym staje się to jednym identycznym wierszem błędu na obraz.
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.
Strona kluczy licencyjnych obejmuje klucze próbne i pliki konfiguracyjne które odczytuje również IronQR. Rodzaj wyjątku jest wewnętrzny dla zestawu IronQr, więc uchwycenie LicensingException według rodzaju nie udaje się skompilować z błędem CS0122.
Dekoder sekwencyjny następny, a jego plik wynikowy staje się odniesieniem dla każdego szybszego trybu.
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.
Jak dekodować folder równolegle z IronQR?
Przewodnik async i multithreading nazywa osobny czytnik na iterację jako bezpieczną domyślną opcję, ponieważ IronQR nie daje jawnej gwarancji bezpieczeństwa wątków dla współdzielonej instancji. Następna podpowiedź ma wbudowanego agenta eksploratora Codex, agenta obciążającego do eksploracji bazy kodu, który sprawdza to w dokumentacji przed jakimkolwiek przejściem do równoległego działania.
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.
W kalibracji, współdzielenie jednego czytnika na 32 wątki dało te same wyniki co czytnik na plik. Późniejsza wersja może się różnić, a czytnik na plik kosztuje niewiele.
Obiekt wejścia też wymaga uwagi. W wersji 2026.10.1 blok using wokół niego wyrzuca NotImplementedException przy wyjściu, nawet po pomyślnym odczycie, więc wsad zarejestruje każdy dobry obraz jako błąd. Przejrzyj każdą różnicę dla jednej.
Dla wersji równoleglej podpowiedź nazywa wbudowanego agenta robotnika, który uruchamia edycję we własnym wątku.
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.
Asynchroniczna lambda przekazana do Parallel.ForEach kompiluje się jako async void, więc pętla wraca, zanim odczyty się skończą, a plik wynikowy wychodzi za krótki. Porównanie z plikiem sekwencyjnym to wyłapuje.
Jak ograniczyć równoległe odczyty za pomocą ReadAsync?
Pętla równoległa blokuje wątek na odczyt. ReadAsync za SemaphoreSlim utrzymuje stałą liczbę odczytów w locie i pozostawia wątek wywołujący wolnym, co jest wzorcem z przewodnika async dla zadań wsadowych o wysokiej liczbie zapisów. Wymaga IQrInput i nie ma przeciążenia dla ścieżki pliku, więc każde zadanie nadal otwiera własną 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.
Model wykrywania już rozprasza jeden odczyt na kilku rdzeni, więc wyższy limit nie musi działać szybciej. Pozwolić runs.csv wybrać limit dla sprzętu, i zachować semafor dla tego, co robi niezawodnie, czyli ogranicza użycie pamięci.
Jaki tryb skanowania powinien używać wsad?
Model wykrywania odczytuje zdjęcia, które przegapia podstawowy przechod, i również odpowiada za większość czasu potrzebnego na każdy odczyt.
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.
Oba tryby odczytują każdy czysty skan i kopie faksu, a każdy przegapił inną niewielką garść zdjęć telefonów. Na zdjęciach, które odczytał tylko podstawowy przechod, model wykrywania zlokalizował kod, ale nie mógł go dekodować, więc Auto nigdy nie wpadł w tył. Powtórzenie pustych plików z QrScanMode.OnlyBasicScan odzyskało każde zdjęcie.
Jak weryfikować zdekodowane wartości i raportować błędy?
Zadanie wsadowe napotyka trzy rodzaje błędów, a każdy wygląda inaczej w kodzie.
| Wejście | Wynik | Status |
|---|---|---|
| Pusty, przycięty lub nieobrazkowy plik | Załadowanie obrazu wyrzuca, zanim IronQR się uruchomi | Nieczytelny |
| Brak kodu lub uszkodzenia poza korekcję błędów | Pusta kolekcja, nigdy null | Pusty |
| Każdy kod, odczytany w trybie tylko wykrywania | Punkty narożne, pusty Value, QrType QrEncoding.None | Pusty, nie Zdekodowany |
Trzeci wiersz jest niebezpieczny. Nasz pierwszy dekoder sekwencyjny liczyłby go jako Zdekodowany, ponieważ sprawdzał tylko, czy jakiś wynik wrócił.
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.
Liczba kontrolna jest częścią danych, więc IronQR nie może jej weryfikować. Korekcja Reed-Solomon wewnątrz odczytu, którą opisuje przewodnik po sumie kontrolnej i tolerancji na błędy, tylko potwierdza, że symbol został zdekodowany, a wynik nie posiada cechy pewności. Etykieta z niewłaściwą cyfrą kontrolną jest czysta, ale wciąż jest niepoprawna.
Przewodnik po komunikatach błędów IronQR pokazuje wzór zapisowania na plik używany w kolejnej podpowiedzi do całego powrotu.
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.
W wersji 2026.10.1, log IronQr.Logging.Logger rejestruje ścieżkę skanowania, którą każdy odczyt przeszedł, np. skanowanie wykrywania z modelem uczenia maszynowego. Ponieważ raport jest budowany tylko z pliku JSONL, błąd, którego dekoder nigdy nie zanotował, pojawia się jako liczba niespójna z plikiem wyników.
Jak zdiagnozować obraz, którego nie można zdekodować?
Codex może spojrzeć na zdjęcie. Należy załączyć plik z codex --image, gdy rozpoczyna się sesję, lub wkleić go do kompozytora.
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.
W naszej sesji wszystkie trzy tryby wróciły puste dla tego pliku, a w kalibracji model wykrywania niczego nie zlokalizował. Sam kod jest uszkodzony, więc strata jest poza tym, co korekcja błędów może odzyskać, i ani kolejny odczyt, ani ponowne zeskanowanie tej samej etykiety tego nie zmienią. Naprawa to wymiana etykiety i, jeśli drukuje się etykiety samodzielnie, wyższy poziom korekcji błędów.
Jak debugować niepoprawne wyjście partii od początku do końca?
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.
Zatwierdź diagnozę przed jakąkolwiek naprawą. Dobra diagnoza cytuje wiersz, który decyduje o sukcesie. Porównaj proponowaną naprawę z out/mode-fallback.csv również.
Jak zmienić jedno-znaczne kody na komponenty do wielokrotnego wykorzystania i testowania?
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.
Refaktoryzacja może usunąć walidator, ponowne podstawowe skanowanie lub odczyt per plik bez błędu kompilacji. Tylko pełne przetestowanie z rzeczywistymi danymi to wychwyci.
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.
Manifest naprawia status i wartość, podczas gdy czas na wykonanie zmienia się z wywołania na wywołanie.
Przechowuj powtarzające się pytania dotyczące IronQR w umiejętnościach repozytorium. OpenAI's custom prompts page marks the older ~/.codex/prompts folder deprecated in favor of skills.
$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.
W naszej sesji Codex wymienił cztery członki rezultatu i prześledził Zdekodowane od zadania przez dekoder do linii walidatora, która je zwraca.
Jak używać tych podpowiedzi w innym folderze z obrazami?
Zmienić ścieżki, a każda powyższa podpowiedź zadziała jak należy. Przewodnik po asystentach kodowania AI działa od początku do końca z jedną podpowiedzią akceptacyjną i publikuje wynik.
Co wyprodukowały zapytania w rzeczywistym uruchomieniu?
Wysłać każdą powyższą podpowiedź do Codex w kolejności, w jednym wątku, przeciwko przykładowemu repozytorium. Zawiera aplikację konsolową i zaległości 301 obrazów (czyste skany, zdjęcia telefonami, kopie faksów, uszkodzone etykiety, puste strony tytułowe, etykiety półek Micro QR, nieprawidłowe tagi oraz sześć plików, które w ogóle nie są obrazami), z manifestem oczekiwanych statusów i wartości każdego. Po sesji zrekompilować projekt w trybie Release i uruchomić testy. Zdekodować również każdą grafikę niezależnie, aby sprawdzić wyniki poniżej.
- Podstawowe ponowne skanowanie zwiększyło liczbę zdekodowanych z 256 do 264. Przed tym, każdy tryb zdekodował 256 z 301, a 16 plików różniło się między nimi.
- Czyste skanowanie zajęło średnio 360 ms w trybie Auto i 35 ms w trybie podstawowego skanowania, które wykonało zaległość w 7 s przy limicie 2.
- Dekoder sekwencyjny zanotował 256 Zdekodowanych, 39 Pustych i 6 Nieczytelnych w 71 s.
- Tryb równoległy zapisał te same 301 wierszy w 60 s przy 32 wątkach, a potok zapisał je w 55, 66 i 68 s przy limitach 2, 8 i 32.
- W szybkim rozpoczęciu 9 z 12 wierszy zdekodowano, 2 wróciły puste, a plik zero-bajtowy wyrzucił.
- Walidacja pasowała do manifestu z 240 Zdekodowanymi, 31 Pustymi, 8 WrongSymbol, 8 InvalidFormat, 8 BadCheckDigit i 6 Nieczytelnymi.
- Raport błędów zawierał 61 rekordów, po jednym na nieudany plik.
- Po refaktoryzacji, zadanie zgadzało się z manifestem na 301 z 301 wierszy, i 6 z 6 testów przeszło, znowu w trybie Release.
- Wszystkie 16 podpowiedzi wykonano z wszystkimi działającymi budowami i bez ręcznych poprawek kodu. Podpowiedzi 13 do 16 osiągnęły limit użycia planu darmowego i wznowiły w tym samym wątku po ponownym zalogowaniu do Codex.
- Przed podpowiedzią badania dodaliśmy nocne zadanie z celowo wprowadzonym błędem, jego logami i listą braków. Codex znalazł tryb tylko wykrywania na zdjęciach JPEG i kontrolę sukcesu, które akceptowały każdy wynik.
Wersja Codex, model, timing i maszyna testowa dla tego uruchomienia są w wspólnym zapisie uruchomienia.
Rozwiązywanie problemów
- Async i Multithreading jeśli równoległe działanie zapisuje mniej wierszy niż jest obrazów
- Zastosuj klucz licencyjny w IronQR jeśli każdy wiersz w pliku wyników pokazuje te same niepowodzenie licencyjne
- Odczytywanie kodów QR za pomocą trybów skanowania jeśli wyniki wracają z punktami narożnymi i bez wartości
- Kopie wyjątku w czasie działania jeśli model wykrywania zawiedzie po opublikowaniu
Pytania?
Jeśli są jakiekolwiek pytania, należy skontaktować się z support@ironsoftware.com
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.