Jak korzystać z IronPrint z ChatGPT Codex

Curtis Chau
Curtis Chau
Zaktualizowano: 26 października 2026

Magazyn drukuje listę wyboru dla każdego zamówienia każdej nocy. Niektóre zamówienia potrzebują jednej kopii dla zbieracza, inne potrzebują drugiej dla pakowacza i trzeciej dla pracownika odpowiedzialnego za faktury. Kiedy liczba kopii jest błędna, nic nie zawodzi. Pakowacz znajduje arkusz bez kopii partnerskiej, albo dział faktur otrzymuje dziewięć arkuszy jednego zamówienia, a dziennik wydruku wciąż zgłasza te zamówienia jako wysłane.

ChatGPT Codex, agent kodowania OpenAI, edytuje pliki w repozytorium, uruchamia dotnet run i inne polecenia, oraz raportuje, co zrobił. Działa w aplikacji desktopowej ChatGPT, środowisku IDE, terminalu i chmurze. IronPrint, biblioteka wydruku .NET od Iron Software, wysyła pliki PDF i obrazy do zainstalowanej drukarki, cicho lub przez dialog wydruku systemu operacyjnego, z ustawionymi parametrami jak rozmiar papieru, orientacja, DPI, skala szarości i liczba kopii w jednym obiekcie PrintSettings.

Codex otrzymuje zamówienia list wyboru na noc oraz manifest oczekiwanych wyników. Każda liczba kopii raportowana przez Codex pochodzi z pliku CSV, a cała partia jest planowana przed wysłaniem jakiegokolwiek zadania do drukarki.

Szybki start
NuGetInstalacja z NuGet

PM > Install-Package IronPrint

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

Uruchomić Codex wewnątrz projektu konsolowego .NET z folderem Orders.

$ironprint Install IronPrint 2026.10.1 from NuGet in this console project.
Program.cs should then plan the six orders in Orders/sample/ without sending a job.

Give each sample PDF a row in out/quickstart.csv. The columns are:

- file
- copies, from that order's row in Orders/manifest.csv
- printer, the PrinterName in appsettings.json
- found, yes or no, whether Printer.GetPrinterNames lists that printer

Read the total copies back from that CSV and show it.
Program.cs gets the key from IRONPRINT_LICENSE_KEY by itself.
Don't show the key's value anywhere, and don't list environment variables.
Keep the PrintCapture.Install line first in Program.cs.
Don't call Print, PrintAsync or ShowPrintDialog yet.
Stop after three failed builds or runs, and tell me what came out.
Text

Wspomnienie $ironprint ładuje umiejętność IronPrint do sesji.



Czym jest ChatGPT Codex i jak pasuje do pracy z drukowaniem w .NET?

Dokumentacja CLI Codex wyjaśnia instalację i użycie w terminalu, a jego kod źródłowy i wydania znajdują się na GitHub.

Codex polega na danych szkoleniowych i plikach w jego kontekście dla IronPrint, a zła nazwa członka powoduje błąd kompilacji.

IronPrint obsługuje Windows, macOS, iOS i Androida. Projekt w tym przewodniku jest skoncentrowany na net9.0-windows.

Jak napisać polecenie IronPrint i jak skonfigurować Codex na jego potrzeby?

Polecenie partii IronPrint podaje nazwę wejściową (każde zamówienie w Orders/manifest.csv), drukarkę i źródło jej nazwy (appsettings.json, sprawdzone przeciwko Printer.GetPrinterNames), ustawienia dla każdego zadania (liczba kopii z manifestu, rozmiar papieru, orientacja pionowa, skala szarości i 150 DPI), dowód (plan CSV z jednym wierszem na zamówienie), prawda (oczekiwane statusy w manifeście) i ograniczenia (dokładna nazwa drukarki i brak wywołania do ShowPrintDialog).

Codex przeszukuje katalog roboczy i każdy katalog powyżej, aż do korzenia repozytorium, w poszukiwaniu folderu .agents/skills. Każdy folder umiejętności zawiera plik SKILL.md, którego frontmatter podaje nazwę i opis. Po skopiowaniu skill.md od IronPrint do .agents/skills/IronPrint/SKILL.md, wzmianka $ironprint zostaje rozwiazana. Przykład w jednym pliku w umiejętności przypina IronPrint 2026.8.1, a Quickstart instaluje 2026.10.1.

Przed rozpoczęciem jakiejkolwiek pracy Codex ładuje pliki AGENTS.md na ścieżce od korzenia repozytorium do folderu roboczego. Odczytuje nie więcej niż jeden na katalog, a gdy dwa się pokrywają, plik bliżej folderu roboczego ma pierwszeństwo. Uruchomienie /init tworzy początkowy szkic.

Maszyna testowa nie ma drukarki, która ukończyłaby zadanie bez dialogu, a dialog zatrzymuje tryb bez nadzoru. Repozytorium testowe zawiera więc małą klasę przechwytywania, która przechwytuje zadanie wysyłane przez IronPrint do Windows i zapisuje je do pliku XPS, dzięki czemu żadne zadanie nie jest wstrzymywane. Projekt z działającą drukarką pomija jej

Write a root-level AGENTS.md containing a section called Nightly picking lists.
These are its rules:

- IronPrint is the only printing library. Its package and namespace are both IronPrint.
- The target framework stays net9.0-windows.
- For the API, check the ironprint skill in .agents/skills/ironprint/.
- The installed IronPrint.xml settles any doubt about a member.
- Orders/ is read-only.
- The printer name comes from appsettings.json and has to appear in Printer.GetPrinterNames.
- The first line of Program.cs installs PrintCapture. It stays first, and Capture/ stays as it is.
- Print and PrintAsync run only from Program.cs, after that line.
- Tests never call them, and code that runs never calls ShowPrintDialog.
- The key lives in IRONPRINT_LICENSE_KEY. No output, log or file ever contains its value.
- A count in a reply has to come from a CSV that the same turn wrote.
- Name that CSV in the reply.

Show me the file once it's written.
Text

Jak poprosić Codex o dodanie IronPrint i sprawdzenie licencji?

Show me the IronPrint PackageReference in PickingBatch.csproj and the version that restore picked.
Then quote each IronSoftware package from the output of dotnet list package --include-transitive.
Don't touch any package reference.
Text

Na nuget.org IronPrint 2026.10.1 zawiera trzy zależności, IronSoftware.Common 2026.4.2, IronSoftware.Abstractions 2026.1.2 i IronSoftware.System.Drawing 2026.8.2. Podczas naszego uruchomienia, przywracanie również dodało IronSoftware.Drawing.Abstractions 2026.1.2. Każda kompilacja kopiuje natywne pliki runtime IronPrint do folderu wyjściowego. Przejrzyj changelog IronPrint przed przypisaniem do wydania.

Printer.GetPrinterNames, Printer.GetPrinterTrays i nowy PrintSettings wszystkie sukcesy bez klucza, więc lista drukarek nie dowodzi niczego na temat licencjonowania. Wywołanie drukowania bez klucza wyrzuca wyjątek licencjonowania przed stworzeniem jakiegokolwiek zadania, a jego komunikat brzmi Production License Required. Synchronous Print owija to wewnątrz AggregateException, podczas gdy PrintAsync rzuca to bezpośrednio. Kod poza IronPrint 2026.10.1 nie może odnosić się do typu wyjątku licencyjnego. Handler przechwytuje więc Exception i porównuje nazwę typu.

Create Startup.ApplyIronPrintKey and make it the call right after PrintCapture in Program.cs.
It copies IRONPRINT_LICENSE_KEY into License.LicenseKey and reports License.IsLicensed.

Next, show me what IronPrint does with no key.
Run the program twice as child processes with the variable cleared for that child only:

1. A --licence-check run that lists the printers and builds a PrintSettings for PL-1023.
2. A --licence-check --send run that also calls Printer.Print once on Orders/sample/PL-1023.pdf.

Both runs use the printer from appsettings.json.
Log every call in out/licence-check.csv.
Its columns are run, call, result, exception type, inner type and message.
Give up after three repair attempts.
Text

IronPrint pozostawia IRONPRINT_LICENSE_KEY nieodczytany, więc program kopiuje jego wartość do License.LicenseKey. Klucz można również umieścić w appsettings.json, Web.config lub App.config, jak opisuje strona kluczy licencyjnych.

Jak IronPrint drukuje kilka kopii jednego dokumentu?

Przewodnik po kopiach ustawia NumberOfCopies raz i wysyła jedno zadanie, zamiast wywoływać Print w pętli. Sonda kalibracyjna wysłała trzy kopie dwustronicowej listy wyboru, a IronPrint stworzył jedno zadanie z dwóch stron z liczbą kopii 3 w bilecie drukowania. Sterownik drukarki tworzy dodatkowe kopie. Microsoft Print to PDF przekonwertował ten bilet na jeden sześciostronicowy plik, posortowany jako strony 1, 2, 1, 2, 1, 2.

Make a throwaway console project in scratch/copies-probe/ on your own.
Exclude scratch/** from PickingBatch.csproj with a Compile Remove item.
Run it yourself to find what NumberOfCopies holds on a new PrintSettings.
It also tries 0, -1 and 1000 and records what reads back.

Then the explorer agent answers these from IronPrint.xml and the ironprint skill:

- What the XML says happens when a driver can't make several copies.
- What GetPrinterTrays returns for each installed printer.
- Whether PrintSettings.DefaultSettings is static or belongs to an instance.

Nobody sends a job, and Services/ and Program.cs stay as they are.
Write all the answers to out/copies-probe.csv.
Beside each answer, quote IronPrint.xml, the ironprint skill or the probe output.
Where a page and the probe disagree, say so.
Text

NumberOfCopies domyślnie do 1, a właściwość akceptuje 0, -1 i 1000. Przewodnik po kopiach stwierdza, że 0 lub wartość ujemna wraca do jednej kopii. Wywołanie drukowania odrzuciło 0 i -1 w kalibracji, z ArgumentOutOfRangeException, którego komunikat to Value must be positive, i żadne zadanie nie zostało stworzone. Partia więc odrzuca te zamówienia przed zbudowaniem jakichkolwiek ustawień. Uwagi XML dodają, że niektóre platformy ignorują wartość i drukują jedną kopię.

Każda strona trafia do drukarki jako obraz w DPI zadania. W sondzie, strona A4 przy 150 DPI miała 1240 na 1753 piksele. Z ustawionym Grayscale, kolor wyjściowy biletu drukowania był Monochrome.

Jak zaplanować nocną partię zadań drukowania?

Have the worker agent write Services/PickingPrinter.cs.
It applies Orders/README.md to every row of Orders/manifest.csv and follows these rules:

- A --printer option overrides the name in appsettings.json.
- An --inbox option picks the PDF folder. Orders/inbox/ is the default.
- Check the printer name against Printer.GetPrinterNames before reading any order.
- Match the name exactly, case included.
- An unknown name stops the run with a message that lists the installed printers.
- Build a new PrintSettings for each Ready order.
- NumberOfCopies comes from the copies column, and PaperSize from the paper column.
- Every order gets portrait, grayscale and 150 DPI.
- An empty file, or one without a %PDF header, is Unreadable.

Add a --plan mode that sends nothing and writes out/print-plan.csv with these columns:

- order_id and file
- status, always one of the README's four
- NumberOfCopies, PaperSize, PaperOrientation, Dpi and Grayscale as the job would send them
- printer

Add a --send mode that awaits PrintAsync once per Ready order, in manifest order.
It writes out/send-log.csv with order_id, file and NumberOfCopies, and no plan file.
Don't run --send yet.
Run --plan over Orders/inbox/ and report the status counts from print-plan.csv.
Text

IronPrint zgłasza uszkodzony plik tylko wtedy, gdy wywołanie drukowania go odczytuje. Pusty plik zawiódł w kalibracji z typem wyjątku z zaciemnionej przestrzeni nazw, którego komunikat linkuje do strony rozwiązania problemów IronPDF, a plik tekstowy o nazwie .pdf zawiódł z InvalidDataException. Kontrola nagłówka PDF w planie utrzymuje oba poza listą zadań.

Jak potwierdzić, co każde zadanie drukowania zawiera?

PL-1028.pdf, jeden z sześciu przykładowych zamówień, to dwustronicowa lista wyboru A4 z pojemnikiem i ilością dla każdego SKU, a manifest daje jej trzy kopie.

Now run --send with --inbox Orders/sample/.
Orders whose PDF isn't in that folder count as Missing and aren't sent.
PrintCapture writes each job to out/captured/ and adds a row to out/captured/jobs.csv.

Match send-log.csv to jobs.csv in sending order.
Then write out/sample-send.csv with one row per sent order and these columns:

- order_id and the NumberOfCopies it was sent with
- copies, pages, media and color from its jobs.csv row

Tell me whether each order went out as a single job carrying its copy count.
Text

Wynik

Poniższy PDF to zadanie, które IronPrint zbudował dla PL-1028 w teście, przekonwertowane strona po stronie z przechwyconego pliku XPS.

Lista wyboru PL-1028, jak zbudował zadanie IronPrint, przechwycona do pliku zamiast drukarki. Zadanie zawiera dwie strony A4 w orientacji pionowej przy 150 DPI w skali szarości, a bilet drukowania żąda trzech kopii.

Co się dzieje, gdy nazwa drukarki nie pasuje?

Przewodnik po nazwie drukarki stwierdza, że nazwa musi dokładnie odpowiadać nazwie systemu operacyjnego, włącznie z wielkością liter, a niedopasowanie "zawiedzie cicho lub wywoła błąd". Prace kalibracyjne nie zgłosiły wyjątków. Zadanie dla Warehouse Laser 01, kolejki, która nie istnieje, i zadanie dla adobe pdf w małych literach zostały skierowane do Microsoft Print to PDF, którą maszyna testowa używa jako domyślnej drukarki.

IronPrint sends a job with an unknown printer name to the Windows default printer.
Show me that PickingPrinter refuses before that can happen.

Run --plan two times, passing each of these names with --printer:

1. "Warehouse Laser 01", a queue this machine doesn't have.
2. "adobe pdf", the installed name in the wrong case.

Neither run may change out/print-plan.csv.
Write out/printer-check.csv with the columns run, printer, exit code, message and plan rows written.
Tell me which printers the message listed.
Text

Jak zdiagnozować arkusz, który drukował się niepoprawnie?

Flaga -i (--image) dołącza obraz do pierwszego pytania sesji lub do pytania, które ją wznawia, a interaktywny kompozytor akceptuje wklejony obraz.

I attached a scan of a picking list with -i.
The packer found it alone, without the copies that should have come with it.
Read the order number from the image.
Look that order up in out/print-plan.csv and Orders/manifest.csv.
Tell me the copy count and paper size that the plan sends.
Also say whether the page in the image fits that paper.
Don't change any code.
Text

Jak debugować niepoprawne wyjście partii od początku do końca?

Find out why last night's run printed the wrong number of picking lists.
Logs/nightly-2026-10-14/print.log reports these five orders as sent.
Orders/warehouse-complaint.csv lists what the warehouse counted by hand for them.

Have the explorer agent read Jobs/NightlyPrint.cs and that log before you write anything.
Your findings go in out/nightly-diagnosis.md, covering:

- the cause behind each count in the complaint file
- the smallest fix
- a --plan command that proves the fix without sending a job

Don't run or edit any code.
Then tell me what you found.
Text

Przeczytaj diagnozę przed zezwoleniem na edytowanie. Dobra diagnoza wyjaśnia także, dlaczego dziennik zgłasza sukces, gdyż dziennik rejestruje każde wywołanie, a nie wydrukowane arkusze.

Jak zmienić jedno-znaczne kody na komponenty do wielokrotnego wykorzystania i testowania?

Put the worker agent on a PrintQueueService class, built like this:

- Install Microsoft.Extensions.DependencyInjection and resolve the service from its container.
- Configure it with a PrintOptions record holding printer, DPI, grayscale and plan-only.
- Keep the README rules and the printer check from PickingPrinter.
- PrintQueueService.cs stays under 150 lines, with XML doc comments.
- Nothing calls Jobs/NightlyPrint.cs.

Run it plan-only over Orders/inbox/ into out/final-plan.csv.
Then compare every status and copy count with manifest.csv and list any difference.
Text

Refaktoryzacja może zgubić kontrolę drukarki i wciąż się kompilować.

Add an xUnit project at tests/PickingBatch.Tests.
Keep it out of the main project's compile items, and put both projects in one solution.

Write tests on the real Orders/ files that check these:

- a 3-copy order gets NumberOfCopies 3 in a single PrintSettings
- a Letter order gets PaperSize.Letter, and an A4 order gets PaperSize.A4
- an order with copies 0 is Rejected and gets no settings
- the empty file and the text file are both Unreadable
- an unknown printer name is refused with a message naming the installed printers

Assert on settings objects and statuses.
Run the tests with dotnet test and a trx logger writing to out/tests/.
Report how many passed and how many failed, reading the trx file.
Text

Asercje obiektów ustawień zapobiegają wysyłaniu zadań przez suite, chociaż dokładna kontrola nazwy nadal wymaga zainstalowanej skonfigurowanej drukarki.

$ironprint Look in the installed IronPrint.xml.
List every Printer member that sends a job or opens a dialog, then tell me:

- Which ones take a byte array instead of a path?
- Which ones show the operating system's print dialog?
- Which ones are asynchronous?

Back each member with one compiling line in a probe project under scratch/.
Build that probe with dotnet build only, and never run it.
It's the one place a ShowPrintDialog call may appear.
Then show me the line in PrintQueueService that stops plan-only mode from sending a job.
Text

Jak ponownie wykorzystać te polecenia w innym zadaniu drukowania?

Z nowymi nazwami plików, nazwami drukarek i regułami kopiowania, te same polecenia obsługują etykiety wysyłkowe lub faktury. Przewodnik po asystentach kodowych IronPrint AI obejmuje konfigurację wspólną dla każdego asystenta.

Co wyprodukowały zapytania w rzeczywistym uruchomieniu?

Codex otrzymał powyższe polecenia w kolejności, w jednej sesji. Projekt .NET 9 zawierał 40 zamówień, ich listy wyboru i manifest z oczekiwanym statusem i liczbą kopii dla każdego zamówienia. Oddzielne skrypty ponownie sprawdziły każdy plik wyjściowy.

  • Przed partią manifest zawierał 35 gotowych zamówień, 2 zamówienia z zerową ilością kopii, 1 brakujący plik i 2 nieczytelne pliki.
  • Plan odpowiadał manifestowi dla wszystkich 40 zamówień.
  • Każde gotowe zamówienie w planie miało liczbę kopii z manifestu i rozmiar papieru, w orientacji pionowej przy 150 DPI w skali szarości.
  • Wysłanie sześciu przykładowych zamówień dało jedno przechwycone zadanie dla każdego z nich.
  • Liczby kopii w sześciu biletach drukowania wynosiły 1, 2, 2, 1, 3 i 3, równe manifestowi.
  • Sześć zadań zawierało 11 stron, które liczby kopii podniosły do 20 arkuszy.
  • Zamówienie Lettera zostało przechwycone jako strony 215,9 x 279,4 mm, a zamówienia A4 jako strony 210 x 297 mm.
  • Każda strona z sześciu przechwyconych zadań była obrazem o 150 DPI bez kolorowych pikseli, więc czerwony pas priorytetowy był szary.
  • Bez klucza program wymieniał cztery drukarki i budował ustawienia, a wywołanie drukowania nie powiodło się z Production License Required.
  • Obie niepoprawne nazwy drukarek zatrzymały plan przed zapisaniem jakiegokolwiek wiersza, a wiadomość wymieniała cztery zainstalowane drukarki.
  • Ze skanu Codex zidentyfikował zamówienie PL-1024 i zgłosił trzy kopie na A4 z planu.
  • Nocna diagnoza przypisała 9, 4 i 18 arkuszy do pętli, która wywoływała Print raz na kopię z pełną liczbą kopii już ustawioną.
  • Ślad dla zamówień z zerową liczbą kopii przypisano do złącza, które podniosło 0 do 1.
  • Zrefaktoryzowany PrintQueueService miał 51 linii, a jego plan pasował do manifestu pod względem każdego statusu i liczby kopii.
  • Wszystkie 7 testów przeszło w sesji Codex i ponownie w świeżej klonie.
  • Codex wymienił ośmiu członków drukarki, którzy wysyłają zadanie lub otwierają dialog, i zbudował sondę dla nich bez wykonywania jej.
  • Niektóre kroki uruchomiono inaczej niż na stronie. Quickstart zatrzymał się po trzech nieudanych próbach bez pisania CSV. Jedna próba sprawdzenia licencji została uruchomiona z kluczem wciąż ustawionym, a klasa przechwytywania przechwyciła wywołanie drukowania. Eksplorator odpowiedział na pytanie dotyczące tacy z XML, zamiast zapytania do każdej drukarki. Codex zgłosił, że kontrola tylko planu była w Program.cs, a nie w PrintQueueService.

Przewodnik po Google Antigravity tworzy stronę ASP.NET Core, która oczekuje na to samo asynchroniczne wywołanie drukowania. W przewodniku Claude Code, każdy typ dokumentu trafia do swojej własnej drukarki, a subagent sprawdza kontrolę nazwy drukarki. Dla wersji Codex, modelu, maszyny testowej i czasu trwania tego uruchomienia można zobaczyć wspólne raportowanie uruchomienia.


Rozwiązywanie problemów


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.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 52,106Wersja:2026.11właśnie wydane