Wie man IronPrint mit ChatGPT Codex verwendet

Curtis Chau
Curtis Chau
Aktualisiert: 26. Oktober 2026

Ein Lagerhaus druckt jede Nacht eine Kommissionierliste für jede Bestellung. Einige Bestellungen benötigen eine Kopie für den Picker, andere benötigen eine zweite für den Verpacker und eine dritte für den Rechnungsbearbeiter. Wenn die Kopienanzahl falsch ist, schlägt nichts fehl. Der Verpacker findet ein Blatt ohne Partnerkopie, oder die Rechnungsstelle erhält neun Blätter einer Bestellung, und das Druckprotokoll meldet diese Bestellungen immer noch als gesendet.

ChatGPT Codex, OpenAIs Codierungsagent, bearbeitet die Dateien eines Repositorys, führt dotnet run und andere Befehle aus und berichtet, was es getan hat. Es funktioniert in der ChatGPT-Desktop-App, einer IDE, einem Terminal und in der Cloud. IronPrint, Iron Software's .NET-Druckbibliothek, sendet PDF- und Bilddateien an einen installierten Drucker, lautlos oder über das Druckdialogfeld des Betriebssystems, mit Papiergröße, Ausrichtung, DPI, Graustufen und der Anzahl der Kopien, die in einem PrintSettings-Objekt festgelegt sind.

Codex erhält eine Nacht Kommissionierlistenbestellungen und ein Manifest der erwarteten Ergebnisse. Jede Kopienanzahl, die Codex meldet, stammt aus einer CSV-Datei, und die gesamte Charge wird geplant, bevor ein Auftrag an einen Drucker gesendet wird.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package IronPrint

Installieren Sie IronPrint, indem Sie den obigen Befehl in der NuGet Packet Manager-Konsole ausführen, oder suchen Sie das Paket im NuGet Paket Manager.

Führen Sie Codex in einem .NET-Konsolenprojekt mit einem Auftragsordner aus.

$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

Die Erwähnung von $ironprint lädt die Fähigkeit von IronPrint in die Sitzung.



Was ist ChatGPT Codex und wie passt es in die .NET-Druckarbeit?

Die CLI-Dokumentation von Codex erklärt die Installation und die Nutzung im Terminal, und der Quellcode und die Releases sind auf GitHub verfügbar.

Codex verlässt sich auf Trainingsdaten und auf die Dateien in seinem Kontext für IronPrint, und ein falscher Mitgliedsname lässt den Build fehlschlagen.

IronPrint unterstützt Windows, macOS, iOS und Android. Das Projekt in diesem Leitfaden zielt auf net9.0-windows ab.

Wie schreibt man ein IronPrint-Prompt und richtet Codex dafür ein?

Ein IronPrint-Batch-Prompt benennt den Eingang (jede Bestellung in Orders/manifest.csv), den Drucker und die Quelle seines Namens (appsettings.json, überprüft gegen Printer.GetPrinterNames), die Einstellungen für jeden Auftrag (die Kopienanzahl aus dem Manifest, Papiergröße, Hochformat, Graustufen und 150 DPI), das Probedokument (ein Plan-CSV mit einer Zeile pro Bestellung), die Bodenwahrheit (die erwarteten Status im Manifest) und die Einschränkungen (ein genauer Druckername und kein Aufruf von ShowPrintDialog).

Codex durchsucht das Arbeitsverzeichnis und jedes darüber liegende Verzeichnis bis zur Repository-Wurzel nach einem .agents/skills-Ordner. Jeder Skills-Ordner enthält eine SKILL.md-Datei, deren Frontmatter einen Namen und eine Beschreibung gibt. Mit der skill.md von IronPrint, kopiert nach .agents/skills/IronPrint/SKILL.md, wird die Erwähnung $ironprint aufgelöst. Das Einzeldatei-Beispiel in der Fähigkeit fixiert IronPrint 2026.8.1, und das Quickstart installiert 2026.10.1.

Vor jeder Arbeit lädt Codex die AGENTS.md-Dateien auf dem Pfad vom Repository-Wurzelverzeichnis zum Arbeitsordner. Es liest nicht mehr als eine pro Verzeichnis, und wenn zwei im Konflikt stehen, hat die Datei näher am Arbeitsordner Vorrang. Das Ausführen von /init erzeugt einen Anfangsentwurf.

Die Testmaschine hat keinen Drucker, der einen Auftrag ohne Dialog abschließt, und ein Dialog stoppt einen unbeaufsichtigten Run. Das Testrepository enthält daher eine kleine Abfangklasse, die den Auftrag abfängt, den IronPrint an Windows sendet, und ihn in eine XPS-Datei schreibt, sodass kein Auftrag gespult wird. Ein Projekt mit einem funktionierenden Drucker lässt ihn aus.

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

Wie fordert man Codex auf, IronPrint hinzuzufügen und die Lizenz zu überprüfen?

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

Auf nuget.org listet IronPrint 2026.10.1 drei Abhängigkeiten auf: IronSoftware.Common 2026.4.2, IronSoftware.Abstractions 2026.1.2 und IronSoftware.System.Drawing 2026.8.2. In unserem Lauf fügte restore auch IronSoftware.Drawing.Abstractions 2026.1.2 hinzu. Jeder Build kopiert die nativen Laufzeitdateien von IronPrint in den Ausgabeordner. Überprüfen Sie das IronPrint-Changelog, bevor Sie eine Veröffentlichung fixieren.

Printer.GetPrinterNames, Printer.GetPrinterTrays und ein neues PrintSettings alle funktionieren ohne Schlüssel, sodass eine Druckerliste nichts über die Lizenzierung beweist. Ein Druckaufruf ohne Schlüssel wirft eine Lizenzierungsausnahme, bevor ein Auftrag erstellt wird, und seine Nachricht lautet Produktionslizenz erforderlich. Das synchrone Print umhüllt es in einen AggregateException, während PrintAsync es direkt wirft. Code außerhalb von IronPrint 2026.10.1 kann nicht auf den Typ der Lizenzierungsausnahme verweisen. Ein Handler fängt daher Exception ab und vergleicht den Typnamen.

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 lässt IRONPRINT_LICENSE_KEY ungelesen, sodass das Programm seinen Wert in License.LicenseKey kopiert. Ein Schlüssel kann auch in appsettings.json, Web.config oder App.config gehen, wie die Lizenzschlüssel-Seite beschreibt.

Wie druckt IronPrint mehrere Kopien eines Dokuments?

Die Kopienanleitung setzt NumberOfCopies einmal und sendet einen Auftrag, anstatt Print in einer Schleife aufzurufen. Eine Kalibrierungssonde sendete drei Kopien einer zweiseitigen Kommissionierliste, und IronPrint erstellte einen Auftrag von zwei Seiten mit einer Kopienanzahl von 3 in seinem Druckticket. Der Druckertreiber erstellt die zusätzlichen Kopien. Microsoft Print to PDF konvertierte dieses Ticket in eine sechseitige Datei, collatiert als Seiten 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 ist standardmäßig auf 1 gesetzt, und die Eigenschaft akzeptiert 0, -1 und 1000. Die Kopienanleitung besagt, dass 0 oder ein negativer Wert auf eine einzelne Kopie zurückfällt. Der Druckaufruf lehnte 0 und -1 in der Kalibrierung ab, mit einem ArgumentOutOfRangeException, dessen Nachricht lautet Der Wert muss positiv sein, und kein Auftrag wurde erstellt. Die Charge lehnt daher diese Aufträge ab, bevor irgendwelche Einstellungen erstellt werden. Die XML-Anmerkungen fügen hinzu, dass einige Plattformen den Wert ignorieren und eine Kopie drucken.

Jede Seite wird als Bild mit dem DPI des Auftrags an den Drucker gesendet. In der Sonde war eine A4-Seite bei 150 DPI 1240 x 1753 Pixel. Mit Grayscale gesetzt, war die Ausgabefarbe des Drucktickets Monochrom.

Wie plant man eine nächtliche Charge von Druckaufträgen?

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 meldet eine beschädigte Datei nur, wenn ein Druckaufruf sie liest. Eine leere Datei schlug in der Kalibrierung mit einem Ausnahmetyp aus einem verschleierten Namensraum fehl, dessen Nachricht auf eine IronPDF-Fehlerbehebungsseite verweist, und eine Textdatei mit dem Namen .pdf schlug fehl mit InvalidDataException. Ein Check des PDF-Headers im Plan hält beide von der Auftragsliste fern.

Wie bestätigen Sie, was jeder Druckauftrag enthält?

PL-1028.pdf, eine der sechs Beispielbestellungen, ist eine zweiseitige A4-Kommissionierliste mit einem Fach und einer Menge für jede SKU, und das Manifest gibt ihr drei Kopien.

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

Ausgabe

Das untenstehende PDF ist der Auftrag, den IronPrint im Testrun für PL-1028 erstellt hat, Seite für Seite konvertiert aus der abgefangenen XPS-Datei.

Kommissionierliste PL-1028 wie IronPrint den Auftrag erstellt hat, in eine Datei statt in einen Drucker abgefangen. Der Auftrag enthält zwei A4-Hochformatseiten bei 150 DPI in Graustufen, und sein Druckticket fordert drei Kopien an.

Was passiert, wenn der Druckername nicht übereinstimmt?

Die Druckernamen-Anleitung besagt, dass ein Name genau mit dem des Betriebssystems übereinstimmen muss, einschließlich Groß- und Kleinschreibung, und dass ein Nichtübereinstimmen "stillschweigend fehlschlägt oder einen Fehler auslöst". Die Kalibrierungsaufträge verursachten keine Ausnahme. Ein Auftrag für Warehouse Laser 01, eine Warteschlange, die nicht existiert, und ein Auftrag für adobe pdf in Kleinbuchstaben wurden beide an Microsoft Print to PDF weitergeleitet, das die Testmaschine als Standarddrucker verwendet.

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

Wie diagnostiziert man ein Blatt, das falsch gedruckt wurde?

Das -i-Flag (--image) fügt einem Bild zum ersten Prompt einer Sitzung oder dem Prompt, der sie fortsetzt, hinzu, und der interaktive Komponist akzeptiert ein eingefügtes Bild.

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

Wie debuggen Sie das fehlerhafte Chargenausgabemuster von Anfang bis Ende?

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

Lesen Sie die Diagnose, bevor Sie eine Bearbeitung zulassen. Eine prägnante Diagnose erklärt auch, warum das Protokoll Erfolg meldet, da das Protokoll jeden Aufruf und nicht die gedruckten Blätter aufzeichnet.

Wie wandeln Sie einmalige Codes in wiederverwendbare, getestete Komponenten um?

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

Ein Refactoring kann den Drucker-Check verlieren und dennoch kompilieren.

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

Behauptungen über Einstellungsobjekte hindern die Suite daran, Jobs zu senden, obwohl die genaue Namensüberprüfung immer noch den installierten Drucker benötigt.

$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

Wie verwenden Sie diese Prompts für eine andere Druckcharge wieder?

Mit neuen Dateinamen, Druckernamen und Kopiervorschriften bearbeiten dieselben Prompts Versandetiketten oder Rechnungen. Die IronPrint AI-Coding-Assistenten-Anleitung deckt die Einrichtung ab, die von jedem Assistenten geteilt wird.

Was haben die Aufforderungen in einem realen Lauf erzeugt?

Codex erhielt die obigen Prompts in der Reihenfolge, in einer einzigen Sitzung. Das .NET 9 Projekt hielt 40 Bestellungen, ihre Kommissionierlisten und ein Manifest mit dem erwarteten Status und der Kopienanzahl jeder Bestellung bereit. Separate Skripte überprüften jede Ausgabedatei erneut.

  • Vor der Charge listete das Manifest 35 Bereitschaftsbestellungen auf, 2 Bestellungen mit null Kopien, 1 fehlende Datei und 2 nicht lesbare Dateien.
  • Der Plan stimmte für alle 40 Bestellungen mit dem Manifest überein.
  • Jede Bereitschaftsbestellung im Plan hatte ihre Kopienanzahl und Papiergröße im Manifest, in Hochformat bei 150 DPI in Graustufen.
  • Das Senden der sechs Beispielbestellungen ergab einen abgefangenen Auftrag für jede.
  • Die Kopienanzahlen in den sechs Drucktickets waren 1, 2, 2, 1, 3 und 3, entsprechend dem Manifest.
  • Die sechs Jobs enthielten 11 Seiten, die die Kopienanzahlen auf 20 Blätter erhöhten.
  • Die Briefbestellung wurde als 215,9 x 279,4 mm-Seiten und die A4-Bestellungen als 210 x 297 mm-Seiten abgefangen.
  • Jede Seite der sechs abgefangenen Jobs war ein 150 DPI-Bild ohne farbige Pixel, sodass das rote Prioritätsband grau war.
  • Ohne Schlüssel listete das Programm die vier Drucker auf und erstellte die Einstellungen, und der Druckaufruf schlug mit Produktionslizenz erforderlich fehl.
  • Beide falschen Druckernamen stoppten den Plan, bevor eine Zeile geschrieben wurde, und die Nachricht listete die vier installierten Drucker auf.
  • Aus dem Scan identifizierte Codex Bestellung PL-1024 und meldete drei Kopien auf A4 aus dem Plan.
  • Die nächtliche Diagnose führte die 9, 4 und 18 Blätter auf eine Schleife zurück, die Print einmal pro Kopie aufrief, wobei die gesamte Kopienanzahl bereits eingestellt war.
  • Sie verfolgte das Blatt für die Nullkopienbestellung bis zu einer Klammer, die 0 auf 1 erhob.
  • Der umstrukturierte PrintQueueService hatte 51 Zeilen, und sein Plan stimmte für jeden Status und jede Kopienanzahl mit dem Manifest überein.
  • Alle 7 Tests wurden in der Codex-Sitzung und erneut in einem frischen Klon bestanden.
  • Codex listete die acht Druckermitglieder auf, die einen Auftrag senden oder einen Dialog öffnen, und baute eine Sonde für sie, ohne sie auszuführen.
  • Einige Schritte liefen anders als die Seite. Das Quickstart stoppte nach drei gescheiterten Versuchen, ohne seine CSV zu schreiben. Ein Lizenzprüfungstest lief, während der Schlüssel noch eingestellt war, und die Abfangklasse schnitt seinen Druckaufruf ab. Der Explorer beantwortete die Fachfrage aus dem XML, anstatt jeden Drucker abzufragen. Codex berichtete, dass der Nur-Plan-Check in Program.cs war, nicht in PrintQueueService.

Der Google-Antigravity-Leitfaden erstellt eine ASP.NET Core-Seite, die denselben asynchronen Druckaufruf erwartet. Im Claude Code Leitfaden geht jeder Dokumenttyp an seinen eigenen Drucker und ein Subagent überprüft den Druckernamen-Check. Für die Codex-Version, das Modell, die Testmaschine und den Zeitpunkt dieses Runs siehe das gemeinsame Laufprotokoll.


Fehlerbehebung


Fragen?

Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 52,106Version:2026.11gerade veröffentlicht