Prompty dla ChatGPT Codex, które dają kompilujący się kod IronBarcode

Curtis Chau
Curtis Chau
Zaktualizowano: 21 września 2026

IronBarcode udostępnia dwa enumy kodowania różniące się wielkością liter, BarcodeEncoding.Databar i BarcodeWriterEncoding.DataBar, a model pracujący z pamięci je myli. Kompilator wychwytuje to natychmiast i właśnie to przemawia za agentem, który sam buduje pisany przez siebie kod. ChatGPT Codex działa wewnątrz repozytorium, więc uruchamia dotnet build i samodzielnie odczytuje błąd. Więcej kosztują mniej widoczne usterki, np. czytnik, który przeszukuje wszystkie symbologie, choć każda etykieta w partii to Code 128.

Ta różnica decyduje o tym, który poziom wybrać. Codex obejmuje rodzinę GPT-5.6, a /model przełącza między Sol, Terra i Luna w sesji interaktywnej. Pętla przebudowy i ponownego skanowania na stałym zestawie testowym to tania praca, którą Luna wykonuje za 5 kredytów za milion tokenów wejściowych, wobec 100 w przypadku Sol. Terra to poziom środkowy: 50 kredytów za milion tokenów wejściowych i 300 za milion wyjściowych. To rozsądny wybór domyślny, gdy projekt obejmuje coś więcej niż zestaw testowy. Sol, flagowy model rodziny, warto zarezerwować do trudniejszej diagnostyki, np. partii zdjęć z magazynu, których nie udaje się zdekodować, a przyczyna nie zostaje zgłoszona.

IronBarcode odczytuje i zapisuje zarówno jednowymiarowe, jak i dwuwymiarowe symbole za pomocą jednego komercyjnego .NET API. Z częścią tej pracy Codex radzi sobie lepiej niż z inną. Dobrze sprawdza się w przypinaniu wersji pakietu, budowaniu generatora etykiet i skanera, odczytywaniu kodów kreskowych z plików PDF, korygowaniu obrazów odrzuconych przez czytnik oraz migracji z innej biblioteki kodów kreskowych, a każde z tych zadań zaczyna się od promptu.

Szybki start
NuGetInstalacja z NuGet

PM > Install-Package BarCode

Zainstaluj IronBarcode, wykonując powyższe polecenie w konsoli Menedżera Pakietów NuGet lub wyszukaj pakiet w Menedżerze Pakietów NuGet.

Uruchomić Codex z czystego drzewa roboczego w projekcie konsolowym. Jasno określić oczekiwany wynik, wszelkie ograniczenia oraz informacje, które mają zostać zgłoszone.

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

Poprawne rozwiązanie jest krótkie, ponieważ BarcodeReader.Read samodzielnie przechodzi przez ramki wielostronicowego pliku TIFF lub animowanego GIF-a, bez ręcznego rozdzielania ramek. Ustawienie ExpectMultipleBarcodes pomaga, gdy jedna ramka zawiera kilka symboli, ale czytnik i tak dociera do każdej ramki. Prompt jest dłuższy niż wynikowy kod, a zażądanie diffu z góry pozwala przejrzeć rzeczywiste zmiany zamiast ich opisu. Każdy wynik zawiera PageNumber liczony od 1, co zapewnia wynik strona po stronie, o który prosi prompt, a przewodnik po wielostronicowych plikach GIF i TIFF obejmuje odczyt.



Jak Codex wpisuje się w projekt kodów kreskowych .NET?

W ramach uprawnień, które mu przyznać, Codex czyta i zapisuje pliki, uruchamia polecenia powłoki i pokazuje, co zrobił. OpenAI dostarcza tego samego agenta poprzez kilka punktów wejściowych, które dzielą konto i historię. Dokumentacja Codex CLI i rozszerzenia IDE wyjaśnia, czym się różnią.

PowierzchniaGdzie się uruchamiaSięgnij po to, gdy
CLITerminalAgent powinien znajdować się obok dotnet build
Rozszerzenie IDEVS Code, JetBrains, XcodeMożna zobaczyć diff i obraz kodu kreskowego obok siebie
Aplikacja desktopowamacOS, WindowsDłuższe zadanie, poza terminalem
ChmuraPrzeglądarkaDelegowanie zadania i późniejsze odebranie diffu

Jeden AGENTS.md obejmuje wszystkie cztery, ponieważ jest zatwierdzony w repozytorium, a nie przypisany do konkretnej powierzchni.

Aby zainstalować CLI, należy uruchomić npm install -g @openai/codex lub w macOS brew install --cask codex. Dla macOS i Linux dostępny jest instalator samodzielny, który nie wymaga Node.js: curl -fsSL https://chatgpt.com/codex/install.sh | sh. Repozytorium CLI Codex zawiera kod źródłowy i informacje o wydaniach.

Uwaga: Przy instalacji uwzględnij zakres @openai/. Pakiet npm o nazwie codex to niezwiązany z nim generator statycznych witryn, opublikowany po raz pierwszy w 2011 r. i ostatnio zaktualizowany w 2012 r. IronBarcode ma odwrotną pułapkę, ponieważ jego pakiet NuGet to BarCode, a nie IronBarcode. Dokładne nazwy pakietów mają znaczenie, gdy agent jest tym, który wpisuje polecenie.

Codex nie zna niezawodnie aktualnego API IronBarcode. Korzysta z danych treningowych i dokumentacji, którą mu się przekaże, a wywołanie metody usuniętej w późniejszym wydaniu to typowy błąd w przypadku bibliotek zewnętrznych. OpenAI projektuje Codex tak, aby uruchamiał polecenia i sprawdzał ich wyniki, ale mimo to zaleca się przejrzenie pracy przed wydaniem. Przewodnik główny wymienia dokumentację do przekazania któremukolwiek z tych narzędzi z góry. Wystarczy zmienić nazwę pliku kontekstowego, a ta sama konfiguracja zadziała w Claude Code, GitHub Copilot, Cursor lub Google Antigravity.

Poziom zmienia nie tylko rachunek, ale też kształt kodu. Ten sam prompt uruchomiony na dwóch poziomach zwraca kod o dwóch różnych strukturach, z których obie da się obronić. Kodowanie kodów kreskowych musi działać odwrotnie: wchodzi jedna wartość, a wychodzi jeden symbol, który każdy skaner odczytuje identycznie. Dlatego należy podać symbologię, rozmiar i warunek zaliczenia, a resztę pozostawić do uznania agenta.

Wynikają z tego cztery rzeczy i wszystkie przemawiają za utrzymywaną biblioteką, a nie za kodem zbudowanym przez agenta:

  • Walidacja działa po obu stronach: nieprawidłowa wartość jest odrzucana już przy zapisie z konkretnym wyjątkiem, takim jak IronBarCodeFormatOnlyAcceptsNumericValuesEncodingException, a ConfidenceThreshold i RemoveFalsePositive odrzucają niewiarygodne dekodowania przy odczycie.
  • Najtrudniejsze są rzeczywiste skany: zdjęcia z telefonu, przekrzywione etykiety i wielostronicowe pliki PDF wymagają obszarów przycięcia, ustawień szybkości i filtrów obrazu, a wszystkie trzy znajdują się w BarcodeReaderOptions.
  • Jedno API obejmuje formaty: Code 128, GS1-128, EAN, UPC, QR, DataMatrix, PDF417, Aztec, MaxiCode i więcej współdzieli te same wywołania odczytu i zapisu, wypisane w całości w sekcji Obsługiwane formaty kodów kreskowych.
  • Ktoś wydaje poprawki: popularne darmowe projekty do obsługi kodów kreskowych przestają być utrzymywane, a za komercyjną bibliotekę ktoś odpowiada i publikuje poprawki na stronie poświęconej bezpieczeństwu i CVE.

Samodzielnie napisany enkoder bez oporów narysuje wartość, której jego format formalnie nie dopuszcza, a każda biblioteka zdekoduje czysty wygenerowany obraz. To Verify odróżnia jedno od drugiego: dekoduje wygenerowany obraz i porównuje go z zapisaną wartością.

Co sprawia, że prompt dla IronBarcode jest skuteczny?

Konkretne odpowiedzi na sześć pytań. Nieprecyzyjne prompty dają ogólny kod napisany pod bibliotekę, która nie istnieje, a konkretne prompty dają kod, który można przejrzeć w pół minuty.

KomponentSłabySilny
FrameworkStwórz kod kreskowyC#, .NET 9
LokalizacjaNieokreślonaServices/LabelService.cs
WersjaNieokreślonaWersja BarCode w pliku .csproj
Symbologiakod kreskowyCode 128, numer śledzenia
WynikŁadny kod kreskowyPNG 400x120, wartość poniżej, odczytuje się identycznie
LimityBrakBrak nowych pakietów. Asynchroniczne odczyty. Zapytaj, jeśli nie wiesz.

Modele językowe mają tendencję do udzielania odpowiedzi zamiast przyznawania się do niepewności. Powiedz agentowi, że zgłoszenie niepewności jest akceptowalnym wynikiem, a wymyśli mniej API. Daj mu wyraźną zgodę na zatrzymanie się zamiast zgadywania.

Porady: Użyj kolumny „Silny” jako listy kontrolnej. Przy sześciu odpowiedziach w jednym prompcie większość wymyślonych API w ogóle się nie pojawi.

Zatwierdzony AGENTS.md opłaca się w całym projekcie, ponieważ Codex ładuje go jako stałe instrukcje na początku każdej sesji. Plik główny jest czytany jako pierwszy, a zagnieżdżone pliki po nim, a najbliższy plik wygrywa, więc drugi AGENTS.md w folderze z kodami kreskowymi zaostrza zasady dla tego folderu bez dotykania reszty repozytorium. /init generuje plik startowy, jeśli go nie ma.

W pliku należy odwołać się do dokumentacji IronBarcode przeznaczonej do odczytu maszynowego. Plik llms.txt wyszczególnia każdą stronę dokumentacji z podsumowaniem, a skill.md zawiera pakiety dla poszczególnych platform, zasady licencjonowania, gotowe przepisy oraz nazwy wyjątków, których należy się spodziewać, gdy coś się nie powiedzie.

Codex przeszukuje .agents/skills w każdym katalogu od katalogu roboczego aż do katalogu głównego repozytorium, więc skill.md ma własne miejsce jako .agents/skills/ironbarcode/SKILL.md. Codex dopasowuje zadanie do pola description we frontmatter, a $ironbarcode pozwala to wymusić, gdy przepisy mają być w kontekście od pierwszej tury. Ten sam folder działa w Antigravity, które również odczytuje tę ścieżkę. Poprosić o oba pliki oraz o plik zagnieżdżony:

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

Jak poprosić Codex o dodanie IronBarcode i napisanie pierwszego kodu kreskowego?

Pozwól agentowi najpierw zająć się konfiguracją. To tam pojawiają się pierwsze błędy w wersji i nazwie pakietu.

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

Spodziewaj się jednolinijkowego diffu i informacji o zainstalowanej wersji. Ten numer warto podawać w kolejnych promptach, a przy okazji ujawnia on agenta, który dodał inny pakiet z barcode w nazwie. Aby zamiast tego przypiąć konkretne wydanie, sprawdź dziennik zmian IronBarcode.

IronBarcode nie ma trybu znaku wodnego. Po upływie okresu karencji w środowisku deweloperskim wywołanie bez licencji od razu kończy się wyjątkiem LicensingException. Ustaw klucz na początku, przed każdym innym wywołaniem IronBarcode, i pozwól Codexowi go dodać.

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

Dokumentacja kluczy licencyjnych IronBarcode obejmuje klucze testowe i wszystkie inne opcje licencjonowania, włączając Web.config i appsettings.json.

Następnie zbuduj usługę etykietowania i skaner. W rzeczywistych systemach, kody kreskowe są tworzone w jednym miejscu, a czytane w innym.

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

Przed zaakceptowaniem diffu sprawdź każdą użytą składową w dokumentacji API. Poprawny kod zapisu opiera się na BarcodeWriter.CreateBarcode, ResizeTo, AddBarcodeValueTextBelowBarcode, SetMargins i ToPngBinaryData, a poprawny kod odczytu na BarcodeReaderOptions i BarcodeReader.ReadAsync, gdzie ExpectBarcodeTypes nazywa symbologie, aby czytnik przestał przeszukiwać każdy format. Dla obrazów z aparatów lub skanerów, a nie z tej usługi, przewodnik po korekcie obrazu wyjaśnia filtry ratujące słabe skany.

Jak przeprowadzić migrację istniejącej implementacji kodów kreskowych do IronBarcode?

Praca migracyjna jest powtarzalna i mechaniczna, a w tym agenci są dobrzy. Skieruj prompt na rzeczywisty kod zamiast go streszczać.

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

Implementacja 400-liniowa wymaga przeglądu linia po linii, podczas gdy błąd w tabeli mapowania kosztuje jedną poprawkę i ani jednej linii odrzuconego kodu.

Uwaga: Planowanie na początku dodaje jedną wymianę z agentem, ale oszczędza Ci przeglądania diffu, którego nigdy nie zatwierdziłeś.

Gdy zatwierdzisz plan, kolejny prompt pozostaje ściśle ukierunkowany.

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

Zaznaczyć w prompcie, że sygnatury metod publicznych nie mogą się zmienić. Bez tej instrukcji agent często przeprojektowuje sposób, w jaki wywołujący korzystają z usługi, co zamienia migrację w refaktoryzację. Generowanie każdej symbologii w obu implementacjach i porównywanie dekodowanych wartości daje test regresji, a to kosztuje jeden dodatkowy cykl budowy i uruchomienia.

Jak za pomocą promptów naprawić skany, których nie da się odczytać?

Nieudany odczyt to problem wizualny, a agent nie widzi obrazu z kamery. Prompt musi opisać problem, a najlepiej zawierać obrazy.

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

Podanie symptomu i nazwanie jednego pliku do edycji utrzymuje naprawę w ryzach. Liczba przed i po zastępuje niejasne poczucie poprawy liczbą. Naprawa to zazwyczaj jedna z trzech rzeczy: Speed podniesiony do Detailed, CropArea narysowane wokół etykiety, lub pojedynczy filtr obrazu wybrany do rzeczywistego defektu. Nakładanie wielu filtrów naraz pogarsza dokładność, zamiast ją poprawiać. Szczegóły znajdują się na stronach o szybkości odczytu i obszarze przycięcia.

Fałszywe pozytywy to odwrotny problem. Traktuj je w ten sam sposób.

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

Link do dokumentacji pełni jednocześnie funkcję kontroli. Agent, który nie potrafi wskazać rzeczywistej strony dla wybranego API, ostrzega, zanim zrobi to kompilacja. Opcje czytnika są łatwe do wymyślenia, więc trzymać przewodnik po fałszywych pozytywach w pobliżu.

Jak debugować niepowodzenie kodu kreskowego od początku do końca?

Każdy wcześniejszy prompt obejmuje jedno zadanie. Codex robi więcej, gdy przekaże mu się objaw i pozwoli mu na samodzielne zbadanie, zdiagnozowanie, naprawienie i przetestowanie.

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

Pytając najpierw o przyczynę, otrzymuje się diagnozę do oceny, a nie zmianę, którą trzeba potem rozszyfrowywać. W tym przypadku prawdopodobną przyczyną jest nagłówek UTF-8 ECI. IronBarcode zapisuje ten nagłówek tylko wtedy, gdy tekst zawiera znaki spoza ASCII, a skanery zbudowane przed istnieniem ECI odrzucają symbol, który go posiada. Wyłączenie nagłówka łamie tekst UTF-8 na skanerach, które wspierają ECI, więc kompromis jest rzeczywisty. W wersji 2026.9.2 dodano EciMode, który pozwala nim sterować, jak opisuje przewodnik po kodowaniu ECI.

Traktować wiadomości o błędach w ten sam sposób. Pełny ślad stosu to najbardziej przydatne dane wejściowe, jakie można dać agentowi.

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

Niepowodzenia w kontenerach zwykle pochodzą z pakietu platformy lub braku natywnej zależności. Te poprawki należą do pliku projektu i Dockerfile, nie do C#. Pozwól Codexowi przeczytać Uruchamianie IronBarcode w Dockerze na Linuxie dla aktualnych wskazówek dotyczących wdrażania, zanim cokolwiek zmieni.

Jak przekształcić jednorazowy kod w przetestowane komponenty wielokrotnego użytku?

Gdy pełny cykl zapisu i odczytu działa, następnym krokiem jest jego uogólnienie. Agenci dobrze sobie z tym radzą, ponieważ wzorzec już istnieje w pliku.

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

Instrukcja ponownego wykorzystywania opcji należy do AGENTS.md. W mocno obciążonej usłudze skanowania tworzenie nowego obiektu opcji dla każdego żądania to alokacja, za którą płacisz przy każdym skanie.

Następnie testy. Kod kreskowy albo dekoduje się z powrotem do wartości, którą zapisano, albo nie, co pozwala na proste asercje.

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

Unikanie porównań bajtów od samego początku zapobiega niewiarygodnym testom. Enkoder może wygenerować nieco różne bajty obrazów w różnych wersjach i platformach, nawet jeśli kod kreskowy pozostaje niezmieniony. Zamiast tego, przetestuj dekodowaną wartość i format.

Codex jest również przydatny do samodzielnego przeczytania dokumentacji. Gdy poda się nazwę nieznanej klasy, Codex odnajduje odpowiednią część dokumentacji API, zamiast zostawić użytkownika do przewijania całej strony.

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

Jaki wzorzec promptu pasuje do jakiego zadania?

Każdy powyższy prompt wskazuje coś konkretnego i prosi w zamian o coś, co da się zweryfikować.

ZadanieCo podać w prompcieCzego zażądać w odpowiedzi
PakietBarCode, wersja, nic więcejLinia PackageReference
Klucz licencyjnyIRONBARCODE_LICENSE_KEY, ścieżka startowaLicense.IsLicensed równe true
Zapis i odczytSymbologia, obie ścieżki, rozmiar obrazuDwa pliki, które się kompilują
MigracjaPlik legacy, sygnatury do zachowaniaTabela mapowania, przed kodem
Nieudane skanyFolder zdjęć, tylko opcje czytnikaLiczba odczytów przed i po
Fałszywe pozytywyRemoveFalsePositive, ConfidenceThresholdStrona, którą zacytował
Niepowodzenie konteneraŚlad stosu, platforma, dwa plikiDiff, .csproj i Dockerfile
RefaktoryzacjaFormaty, kształt DI, limit liniiJedna instancja opcji na format
TestyCztery zachowania, brak asercji bajtówLiczba przejść

Jak ponownie wykorzystać te prompty w następnym projekcie?

Każdy wzorzec przenosi się do nowego projektu, z jedynie zmienionymi nazwami plików, dlatego zasady należy umieścić w kontroli wersji, a nie w historii czatu.

Aby zmierzyć sesję zamiast jej ufać, przewodnik po asystentach kodujących i agentach AI przekazuje jedno zadanie agentowi i ocenia, co wraca.


Rozwiązywanie problemów


Pytania?

W przypadku jakichkolwiek pytań, 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.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 2,564,559Wersja:2026.11właśnie wydane