Wie man IronWord mit ChatGPT Codex verwendet

Curtis Chau
Curtis Chau
Aktualisiert: 19. Oktober 2026

Wenn ein Unternehmen seinen Namen ändert, erhält das Rechtsabteilung einen Ordner mit unterschriebenen Verträgen zur Aktualisierung. Der alte Name wird in Fließtexten, Parteitabelle, Titel in Großbuchstaben und Kopfzeilen gefunden. Word kann den Namen auch über mehrere Formatdurchläufe speichern, zum Beispiel, wenn ein Fragment vor Jahren fett gedruckt wurde. Ein standardmäßiges Suchen-und-Ersetzen in jeder Datei behebt nur einige Fälle, während andere ohne Warnung unverändert bleiben.

ChatGPT Codex ist der Codierungsagent von OpenAI. Innerhalb eines Repositorys bearbeitet Codex Dateien, führt Befehle wie dotnet run aus und fasst dann die Änderungen zusammen. Ein Agent bedient das Terminal, IDEs, die ChatGPT-Desktop-App und Cloud-Aufgaben. IronWord, eine .NET-Bibliothek von Iron Software, öffnet vorhandene Word-Dokumente als Objektmodell von Absätzen, Durchläufen und Tabellen, die Code bearbeiten und ohne Microsoft Office speichern kann.

Codex arbeitet an einem Vertragsrückstand mit einem Ground-Truth-Manifest. Die Batch-Eingaben schreiben eine CSV mit einer Zeile pro Vertrag, sodass jede Zählung, die Codex meldet, durch eine Datei gestützt wird.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package IronWord

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

Starten Sie Codex in einem .NET-Konsolenprojekt, das den Vertragsordner enthält, und fordern Sie einen Bestand an, bevor Sie Änderungen vornehmen.

$ironword Add the IronWord 2026.10.4 NuGet package to this console project.
Then have Program.cs open every .docx in Contracts/sample/ without changing it.

For each file, write one row to out/quickstart.csv with these columns:

- file
- body count, how often "Northwind Traders" appears in the body text
- table count, the same name counted separately in every table cell
- the exception type, when the file fails to open

Print the totals by reading that CSV back.
Program.cs reads the key from IRONWORD_LICENSE_KEY itself.
Don't print the key's value, and don't list environment variables.
Nothing gets saved here, so an unset key is no reason to stop.
Build and run it with at most three repair attempts, then tell me the result.
Text


Was ist ChatGPT Codex, und wie passt es zur Arbeit mit .NET-Word-Dokumenten?

Installationsschritte finden Sie in der Codex-CLI-Dokumentation, und Releases werden im Open-Source-Repositorium veröffentlicht.

Codex kennt IronWord aus Trainingsdaten und beigefügten Dateien, und eine neue Veröffentlichung kann beide veraltet machen. Die 2026.10-Releases laden und speichern über Streams und asynchrone Aufrufe.

Wie schreibt man eine IronWord-Eingabeaufforderung und richtet Codex dafür ein?

Eine effektive Batch-Eingabeaufforderung benennt die Eingabe, jeden Ort des Namens, die Ausgabe, den Nachweis, die schreibgeschützte Wahrheit und die Einschränkungen.

OpenAIs Paper darüber, warum Sprachmodelle halluzinieren, verfolgt selbstbewusste falsche Antworten bis hin zu einem Training und einer Bewertung, die Raten belohnen, und in einem Umbenennungsjob lautet die Vermutung, dass jeder Vertrag sauber ist.

Codex sucht nach Fähigkeiten in .agents/skills in jedem Verzeichnis zwischen dem Arbeitsverzeichnis und dem Repository-Stamm. Gespeichert als .agents/skills/IronWord/SKILL.md, löst IronWords skill.md die Erwähnung $ironword aus.

Vor der Arbeit liest Codex höchstens ein AGENTS.md in jedem Verzeichnis auf dem Pfad zwischen dem Repository-Stamm und dem Arbeitsordner. Die Datei, die dem Arbeitsordner am nächsten liegt, hat Vorrang. Der Befehl /init entwirft ein Start-AGENTS.md.

Give this repository a top-level AGENTS.md with a Contract rebrand section.
List these rules in it:

- No DOCX library other than IronWord is allowed.
- IronWord's package is IronWord, and its namespaces are IronWord and IronWord.Models.
- The ironword skill in .agents/skills/ironword/ is one API reference.
- https://ironsoftware.com/word/csharp/llms.txt is the other.
- Contracts/inbox/ and Contracts/manifest.csv are read-only.
- Rebranded copies go to out/rebranded/ under their original names.
- IRONWORD_LICENSE_KEY holds the key, and its value never appears in output, logs or files.
- Checking the variable means its presence and length, nothing more.
- Any count you report is read from a CSV written in the same turn.
- The reply names that CSV.
Text

Wie fragen Sie Codex, ob IronWord hinzugefügt und die Lizenz geprüft wird?

Print the IronWord PackageReference from ContractRebrand.csproj and the version restore resolved.
Then quote every IronSoftware entry that dotnet list package --include-transitive prints.
Leave the package references exactly as they are.
Text

IronWord 2026.10.4 verweist auf IronSoftware.Abstractions 2026.1.2, IronSoftware.Common 2026.4.2 und IronSoftware.System.Drawing 2026.11.3. Außerdem gelistete IronSoftware.Drawing.Abstractions 2026.1.2 wiederherstellen. Der Build kopiert native LayoutEngineInterop-Bibliotheken für Windows, Linux und macOS in einen Runtimes-Ordner. Die OpenXML-Konfliktseite behandelt einen Konflikt mit einem neueren DocumentFormat.OpenXml in Versionen vor 2025.7.13. Überprüfen Sie das IronWord-Änderungsprotokoll, bevor Sie festlegen.

Ohne Schlüssel sind Öffnen, Lesen und Ersetzen erfolgreich, aber jeder Überladung von Speichern, einschließlich asynchroner, wirft eine LicensingException mit der Nachricht Production License Required.

Add Startup.ApplyIronWordKey and call it first in Program.cs.
It copies the IRONWORD_LICENSE_KEY value into IronWord.License.LicenseKey.
It also reports whether License.IsLicensed is true.

Add a --dry-run switch that opens and edits in memory and never saves.
Then run the sample twice with the variable removed:

1. Run it once with --dry-run.
2. Run it once copying each file to out/licence-check/ through SaveAs.

Clear the variable inside each child process only, never for the session.
Write out/licence-check.csv with the columns run, file, call, exception type name and message.
Tell me which calls threw.
The licensing exception type isn't public, so catch Exception and record its GetType().FullName.
Stop after three repair attempts.
Text

Die Lizenzschlüssel-Seite behandelt auch Web.config, App.config und appsettings.json.

Welche Teile eines Word-Dokuments erreicht ein Textersatz?

Create Services/MentionScanner.cs.
For one DOCX it returns a count for each of these:

- "Northwind Traders" in body paragraphs
- "Northwind Traders" in table cells
- the name in upper case
- the name inside "Northwind Traders Pension Trust"
- the name in headers and footers
- the old notice address
- the Fax notices paragraph

The body and table cell counts leave out the pension trust name.
IronWord has no header or footer model.
For that column only, read word/header*.xml and word/footer*.xml with System.IO.Compression.

Then run it over Contracts/inbox/ into out/inventory.csv.
Mark files that fail to open as Unreadable.
List every file whose counts differ from manifest.csv.
In that comparison, the body count is body_mentions plus split_run_mentions.
Text

Der integrierte Explorer-Agent testet den Ersatz an echten Dateien.

Create a scratch console project under scratch/replace-probe/ yourself.
Add a Compile Remove line for scratch/** to ContractRebrand.csproj.

Then ask the explorer agent to use that project.
It finds which parts of a contract the document-level ReplaceText call changes.
It tests copies of the Contracts/sample/ files in memory, with these four cases:

- a name split across runs
- a table cell
- the upper-case title
- the pension trust

The header has no object in the API, so the explorer answers that one from IronWord.xml.
It changes nothing under Services/ or in Program.cs.

Write the five answers to out/replace-reach.csv.
Beside each answer, quote the ironword skill or IronWord documentation.
Where a page and the test disagree, say so.
Text

Die Kalibrierung auf 2026.10.4 ergab diese In-Memory-Ergebnisse.

OrtDokumentenebene ersetzenWas es erreicht
Körper, ein DurchlaufErsetztDer Dokumentaufruf
Körper, auf Durchläufe aufgeteiltErsetztDer Dokumentaufruf
TabellenzelleUnverändertReplaceText auf jedem TableCell
Titel in GroßbuchstabenUnverändert (Groß-/Kleinschreibung beachtenes Abgleichen)Ein zweiter Aufruf mit der Großbuchstabenform
Name des RentenvertrauensUmbenannt (einfacher Übereinstimmungsabgleich)Ein Platzhalter zuerst ersetzt und danach wiederhergestellt
Kopf- oder FußzeileNicht im ObjektmodellBerichten Sie es, dann manuell bearbeiten

Die aufgeteilte Durchlaufreihe hat einen Nebeneffekt. Ein Name, der als fettgedrucktes Nord, gefolgt von einem einfachen Winds Traders gespeichert ist, wird zu einem fetten Lauf, der Contoso Ltd. liest.

Eine Prüfung, die auf dem ExtractText des Dokuments basiert und nur Fließtexte zurückgibt, besteht einen Vertrag, dessen Parteitabelle den alten Firmennamen noch enthält. FindText verpasst eine Übereinstimmung mit aufgeteilten Durchläufen, da es nur ein Textelement abgleicht, das die gesamte Phrase enthält.

Wie ersetzen Sie Text in einem Ordner mit Dokumenten?

Have the worker agent write Services/Rebrander.cs.
It applies every rule in Contracts/README.md to Contracts/inbox/.
It builds on the explorer's findings and follows these rules:

- Replace inside each table cell as well as the body.
- Keep the pension trust intact.
- Delete the Fax notices paragraph.
- Leave header and footer parts as they are, since IronWord can't edit them.
- Report those contracts as HeaderFlagged.
- Save each copy to out/rebranded/ with SaveAs.
- Never call Save() on a document opened from inbox/.

Add a --sequential mode that rescans the saved copies with MentionScanner.
It writes out/sequential.csv with these columns:

- file
- status from the README, always one of its four
- mentions left per location
- milliseconds
- header_lost, set to yes when a copy lacks a header or footer part its original had

The header_lost column is reported on its own and never changes a status.
Tell me the status counts.
Text

In IronWord 2026.10.4 wird beim Speichern einer geladenen DOCX mit einer Tabelle jede Textbearbeitung innerhalb der Tabelle und in jedem Absatz nach der ersten Tabelle verworfen. Die Kopie auf der Festplatte behält den alten Text, es wird keine Ausnahme ausgelöst, und das In-Memory-Dokument zeigt immer noch den Ersatz. Bearbeitungen vor der ersten Tabelle bleiben erhalten, ebenso wie eine Zelle, die durch ein neues TableCell ersetzt wurde. Diese Verträge platzieren die Unterschrift nach der Parteitabelle, sodass eine In-Memory-Prüfung Kopien besteht, deren gespeicherte Unterschrift sich nie geändert hat.

Der parameterlose Save ist dokumentiert, um eine Quelle einer geladenen Datei zu überschreiben, daher sollte ein Batch ihn nicht aufrufen. Der Textentfernungs-Leitfaden zeigt die Absatzentfernung hinter der Faxregel.

Bei der Kalibrierung, das Laden einer Null-Byte-Datei löste NullReferenceException aus, und eine Textdatei, ein gekürztes Paket und ein Paket aus zufälligen Bytes lösten jeweils eine FileFormatException aus einem obfuskierten Namespace mit der Nachricht 'File contains corrupted data' aus. Ein Catch für den System.IO-Typ verpasst es. Fangen Sie Exception pro Datei und erfassen Sie den Typ.

Kopien verwenden SaveAs, das die Problembehebungsseite von IronWord für einen Kopfbereich, der nach dem Speichern verschwindet namen.

Check whether SaveAs lost a header anywhere in this backlog.
IronWord's troubleshooting page header-disappears-after-saveas reports that in one environment.

For every HeaderFlagged file, compare the inbox original with its out/rebranded/ copy.
Look at the word/header*.xml and word/footer*.xml parts.
Write out/header-check.csv with these columns:

- file
- header parts before
- header parts after
- whether each part is present with its text unchanged

If a part went missing, rebrand that contract again from its inbox original.
Write it with the Save overload that takes the out/rebranded/ path.
Don't use the parameterless Save().
If the part is still missing, record it and stop.
Tell me which files lost a part.
Text

Wie verarbeiten Sie einen Ordner mit Dokumenten parallel?

Die asynchronen Anrufe führen Datei-I/O ohne Blockierung aus, aber die Dokumentation sagt, dass das Parsen und die Serialisierung synchron bleiben und dass eine Dokumentinstanz nicht Thread-sicher ist.

Add a --parallel mode that works like this:

- It runs Task.WhenAll over the inbox.
- Each task holds a slot of a SemaphoreSlim whose size comes from --concurrency.
- Then it awaits WordDocument.LoadAsync and SaveAsAsync on its own WordDocument.

Run the mode three times:

1. At concurrency 1 into out/parallel-c1/.
2. At concurrency 4 into out/parallel-c4/.
3. At Environment.ProcessorCount into out/parallel-max/.

Write out/parallel-compare.csv with the columns file, folder and a yes or no.
The yes or no says whether the extracted body and cell text match out/rebranded/.
Log each run as a new line of out/runs.csv.
Give it the mode, concurrency, elapsed seconds and match count from out/parallel-compare.csv.
Tell me the quickest setting in runs.csv.
Text

Bei der Kalibrierung dauerte das Öffnen und Bearbeiten des Posteingangs im Speicher, einschließlich vier unlesbarer Dateien, 4,8 Sekunden sequentiell, 1,4 bei einem Limit von 4 und 1,8 bei 16, und mit SaveAsAsync dauerten 14,4, 5,5 und 4,7 Sekunden. Der Speicher ist der begrenzende Schritt.

Wie diagnostizieren Sie ein Dokument, das noch alten Text anzeigt?

Codex akzeptiert Bilder über das -i-Flag (--image) in einer neuen Sitzung oder mit codex exec resume oder als Einfügen in den Komponisten.

I attached the first page of out/rebranded/MSA-1050.docx as an image with -i.
Its header still names Northwind Traders.
Look at the image, then explain from the file itself why the batch left that text.
Tell me whether out/sequential.csv already flags this file.
Don't change any code.
Text

Eine korrekte Antwort benennt den Kopfteile-Bereich und die Kopfbereichs-markierte Zeile der Datei.

Wie debuggen Sie das fehlerhafte Chargenausgabemuster von Anfang bis Ende?

Find out why the nightly job passed contracts that legal later flagged.
The log reports 0 contracts still naming Northwind Traders.
Contracts/legal-review.csv lists contracts where legal still found the old name.
It was in the party table or an upper-case title.
The file also lists a pension trust that was renamed.

Send the explorer agent through Jobs/NightlyRebrand.cs and Logs/nightly-2026-10-07/ first.
Then write your own report in out/nightly-diagnosis.md with these parts:

- why the job's own check passed them
- the smallest fix
- the command that proves the fix

Don't run or edit any code.
Text

Die Diagnose sollte die Zeile zitieren, in der die Aufgabe einen Vertrag als sauber markiert.

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

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

- Install the Microsoft.Extensions.DependencyInjection package.
- Have its container resolve RebrandJob.
- Set it up through a RebrandOptions record with inbox, output folder, concurrency and dry run.
- Keep every README rule, the header check and the per-file CSV.
- RebrandJob.cs stays under 180 lines, with XML doc comments.

The README rules cover body and cell replacement, upper case and the pension trust guard.
They also cover the address and the fax deletion.
Run the job over the whole inbox into out/final/ and out/final.csv.
Then tell me whether every status matches manifest.csv.
Also confirm no copy keeps an old name, old address or fax paragraph.
Old names in a copy's header or in the pension trust don't count.
Text

Ein Refactoring kann eine Regel entfernen und trotzdem bauen.

Add an xUnit project at tests/ContractRebrand.Tests.
Exclude it from the main project's compile items, and join both projects in a solution file.

Write tests on real inbox files that check these:

- a split-run contract comes back with no old name
- a table contract is clean in its cells
- a pension trust mention survives
- a header contract is HeaderFlagged
- the zero-byte file is Unreadable without stopping the batch
- 20 files rebranded in parallel equal their sequential copies

Assert on extracted text and statuses, never on DOCX bytes.
Keep test copies in out/tests/work/.
Run dotnet test on the solution with a trx logger into out/tests/.
Report the totals from the trx file.
Text

Die Dokumentation zu OpenAIs benutzerdefinierten Eingabeaufforderungen wertet in ~/.codex/prompts gespeicherte Eingabeaufforderungen zugunsten von Fähigkeiten ab, wo sich wiederkehrende Fragen befinden.

$ironword Look in the installed IronWord.xml.
List the WordDocument members that load or save a document, and answer these:

- Which ones are asynchronous?
- Which one overwrites the source file a document was loaded from?

List only members you can call from a line that compiles in a probe under scratch/.
Also name any member anywhere in IronWord.xml that is documented but doesn't compile.
Check by compiling only.
Don't run Save() on any document loaded from Contracts/inbox/.
Then show the line in RebrandJob that keeps Contracts/inbox/ untouched.
Text

Wie verwenden Sie diese Eingabeaufforderungen erneut in einem anderen Dokumentrückstand?

Mit geänderten Namen, Pfaden und Regeln passen diese Eingabeaufforderungen zum nächsten Rückstand, und der IronWord AI Codierungsassistenten-Leitfaden deckt die Einrichtung für alle fünf Assistenten ab.

Was haben die Aufforderungen in einem realen Lauf erzeugt?

Die Eingabeaufforderungen liefen der Reihe nach in einer Codex-Sitzung ab. Das .NET 9 Projekt hielt 124 Verträge und ein Manifest erwarteter Status und Zählungen, und jeder Release-Build war erfolgreich. Unser Scanner hat jede gespeicherte Kopie erneut gescannt, und die Tests wurden in einem neuen Klon erneut ausgeführt.

  • Vor der Umbenennung stimmte das Inventar im Manifest bei allen 124 Dateien und markierte die 4 Nicht-DOCX-Dateien als unlesbar.
  • Nach der sequentiellen Umbenennung enthielten die 120 gespeicherten Kopien keinen der 114 alten Namen über der Parteitabelle, die 22 auf verschiedene Durchläufe aufgeteilt eingeschlossen.
  • Keiner der 13 Titel in Großbuchstaben, 38 alten Benachrichtigungsadressen oder 57 Faxabsätze blieben.
  • Alle 9 Rentenvertrauensnamen blieben intakt.
  • Der alte Name blieb in 28 Parteitabelle und 114 Signaturen, weil das Speichern diese Änderungen verwarf.
  • Die sequentielle.csv des Arbeiters gab jeder Datei den Status des Manifestes, Rebrand 104, Kopfbereich markiert 10, Keine Änderung 6 und Unlesbar 4, aber ihre eigenen Spaltenanzeige immer noch die 114 Signaturen und 28 Tabellenangaben. Die Statusaufzeichnungen erkennen, nicht ersetzen, da Codex selbst berichtete.
  • In den 10 Beispieldateien meldete der Quickstart 19 Körper- und 2 Tabellenangaben gegenüber 16 und 2 im Manifest. Ihre Körperanzahl zählte auch die 2 Zellangaben und den Rentenvertrauensnamen.
  • Ohne den Schlüssel bearbeitete der Trockenlauf alle 9 lesbaren Beispieldateien im Speicher. Der Speicherlauf warf LicensingException bei SaveAs für jede von ihnen.
  • Bei Limits von 1, 4 und 32 dauerten die parallelen Läufe 11.456, 7.825 und 5.830 Sekunden. Alle 120 lesbaren Kopien in jedem Ordner stimmten mit den sequentiellen überein.
  • Die nächtliche Diagnose verfolgte die Ergebnisse bis zur Aufgabe's Groß-/Kleinschreibungs-abgleich-fähige Prüfen und der ersetzte Abschnitt auf Dokumentenebene. Es wurden keine Zeilennummern zitiert, und der Befehlsnachweis zielte auf ein Testprojekt ab, das noch nicht existierte.
  • Das Refactoring hielt jede Regel in einer 68-zeiligen RebrandJob.cs und seine End-/Abschluss-Kopien stimmten überein mit End/Umbenannt.
  • final.csv stimmte mit den Manifest-Status überein, markierte jedoch 118 Zeilen als unvollständig, und Codex meldete, dass die Inhaltsprüfung fehlgeschlagen ist.
  • Codexs Lauf und der frische Klon bestanden jeweils 4 von 6 Tests. Der Test für aufgeteilte Durchläufe scheiterte an der Signatur, und der Tabellentest an einer Zelle der Partietabelle.
  • Die API-Antwort listete vier Lade-, sieben Speicher- und fünf asynchrone Mitglieder auf und benannte den parameterlosen Speicher als den, der die Quelle überschreibt.
  • Sie nannte korrekt vier dokumentierte Mitglieder, die nicht kompilieren. Diese waren der Konstruktor, der Bytes und einen String nimmt, FlushModelToBytes, ReplaceTextAcrossRuns in einem Absatz und SetNoChangeStatusAsUpdated.
  • Sie listete auch den nur-Bytes-Konstruktor auf, der kompiliert, und verpasste fünf andere, die in 2026.10.4 fehlschlagen: FromMarkdown, FromMarkdownFile, ExportToMarkdownFile, GetMailMergeWorkingBytes und ApplyCellStyle auf einer Tabelle.
  • Einige Schritte liefen anders als die Seite. Das Bild wurde mit python-docx aus der MSA-1050-Kopie des Durchlaufs gerendert. Der nächtliche Job, sein Protokoll und die juristische Prüfakte wurden unmittelbar vor der Untersuchungseingabeaufforderung hinzugefügt.

Der GitHub Copilot-Leitfaden testet eine gespeicherte Anweisung, indem sie ihre Tabelle über Tabellen, Zeilen und Zellen liest. Der Cursor-Leitfaden listet die Teile eines DOCX auf, die IronWord nicht liest.

Das gemeinsame Laufprotokoll listet die Codex-Version, das Modell, die Maschine und die Zeitangaben für diesen Lauf auf.


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 62,392Version:2026.11gerade veröffentlicht