Comment utiliser IronWord avec ChatGPT Codex
Lorsqu'une entreprise change de nom, l'équipe juridique reçoit un dossier de contrats signés à mettre à jour. L'ancien nom est trouvé dans les paragraphes du corps de texte, les tableaux de parties, les titres en majuscules et les entêtes de page. Word peut également stocker le nom à travers plusieurs exécutions de formatage, par exemple lorsqu'un fragment a été mis en gras il y a des années. Une recherche et remplacement standard sur chaque fichier ne corrige que certains cas, tandis que d'autres restent inchangés sans alerte.
ChatGPT Codex est l'agent de codage d'OpenAI. Dans un dépôt, il modifie les fichiers, exécute des commandes telles que dotnet run, puis résume les changements. Un agent sert le terminal, les IDE, l'application de bureau ChatGPT et les tâches cloud. IronWord, une bibliothèque .NET de Iron Software, ouvre des documents Word existants comme un modèle d'objet de paragraphes, d'exécutions et de tableaux que le code peut modifier et enregistrer sans Microsoft Office.
Codex travaille sur un arriéré de contrats avec un manifeste de vérité basée. Les invites de lot écrivent un CSV avec une ligne par contrat, de sorte que chaque compte rendu par Codex est soutenu par un fichier.
Démarrage rapideDémarrez Codex dans un projet de console .NET contenant le dossier de contrat, et demandez un inventaire avant toute modification.
$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.
Flux de travail minimal (5 étapes)
- Téléchargez la bibliothèque C# Word depuis NuGet
- Enregistrez la compétence d'IronWord sous .agents/skills/ironword/SKILL.md pour que la mention
$ironwordsoit résolue. - Validez un AGENTS.md qui marque les originaux comme en lecture seule et nécessite un CSV pour chaque compte.
- Inventoriez chaque emplacement d'abord, puis remplacez le texte dans le corps et les titres en majuscules et remplacez chaque cellule de tableau modifiée par une nouvelle.
- Rescannez les copies enregistrées et comparez le fichier de résultats avec le manifeste avant d'accepter un statut.
Qu'est-ce que ChatGPT Codex et comment s'intègre-t-il dans le travail de documents Word .NET ?
Les étapes d'installation se trouvent dans la documentation de l'interface de ligne de commande Codex et les versions sont publiées dans le dépôt open-source.
Codex connait IronWord grâce aux données d'entraînement et aux fichiers fournis, et une nouvelle version peut rendre les deux obsolètes. Les versions 2026.10 chargent et enregistrent via des flux et des appels asynchrones.
Comment écrire une invite IronWord et configurer Codex pour cela ?
Une invite de lot efficace nomme l'entrée, chaque emplacement du nom, la sortie, la preuve, la vérité de base en lecture seule et les contraintes.
L'article d'OpenAI sur pourquoi les modèles linguistiques hallucinent retrace les réponses incorrectes confiantes à un entrainement et une évaluation qui récompensent les suppositions, et dans un travail de renommage, la supposition est que chaque contrat est propre.
Codex recherche des compétences dans .agents/skills dans chaque répertoire entre le répertoire de travail et la racine du dépôt. Enregistré sous .agents/skills/IronWord/SKILL.md, la compétence md d'IronWord résout la mention $ironword.
Avant tout travail, Codex lit au maximum un AGENTS.md dans chaque répertoire sur le chemin entre la racine du dépôt et le dossier de travail. Le fichier le plus proche du dossier de travail prévaut. La commande /init rédige un AGENTS.md de départ.
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.
Comment demander à Codex d'ajouter IronWord et de vérifier la licence ?
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.
IronWord 2026.10.4 fait référence à IronSoftware.Abstractions 2026.1.2, IronSoftware.Common 2026.4.2 et IronSoftware.System.Drawing 2026.11.3. Restaurez aussi Listed IronSoftware.Drawing.Abstractions 2026.1.2. La construction copie les bibliothèques natives LayoutEngineInterop pour Windows, Linux et macOS dans un dossier runtimes. La page de conflit OpenXML couvre un conflit avec un DocumentFormat.OpenXml plus récent dans les versions avant 2025.7.13. Vérifiez le journal des modifications d'IronWord avant d'épingler.
Sans clé, l'ouverture, la lecture et le remplacement réussissent, mais chaque surcharge de sauvegarde, y compris les asynchrones, lance une LicensingException avec le message 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.
La page des clés de licence couvre également Web.config, App.config et appsettings.json.
Quelles parties d'un document Word un remplacement de texte atteint-il ?
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.
L'agent explorateur intégré teste le remplacement sur des fichiers réels.
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.
L'étalonnage sur 2026.10.4 a donné ces résultats en mémoire.
| Emplacement | Remplacement au niveau du document | Ce qui l'atteint |
|---|---|---|
| Corps, une exécution | Remplacé | L'appel du document |
| Corps, réparti sur plusieurs exécutions | Remplacé | L'appel du document |
| Cellule de tableau | Inchangé | ReplaceText sur chaque TableCell |
| Titre en majuscules | Inchangé (correspondance sensible à la casse) | Un second appel avec la forme en majuscules |
| Nom du fonds de pension | Renommé (correspondance de sous-chaîne simple) | Un espace réservé substitué d'abord et restauré ensuite |
| En-tête ou pied de page | Pas dans le modèle d'objet | Signalez-le, puis modifiez manuellement |
La ligne d'exécution fractionnée a un effet secondaire. Un nom stocké comme un Nord en gras suivi d'un Vent plain Traders devient une exécution en gras qui lit Contoso Ltd.
Une vérification construite sur ExtractText du document, qui retourne uniquement les paragraphes du corps de texte, passe un contrat dont le tableau des parties nomme encore l'ancienne entreprise. FindText manque une correspondance d'exécution fractionnée, car il ne correspond qu'à un élément texte qui contient toute la phrase.
Comment remplacer du texte dans un dossier de documents ?
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.
Dans IronWord 2026.10.4, l'enregistrement d'un DOCX chargé avec un tableau rejette chaque modification de texte à l'intérieur du tableau et dans tout paragraphe après le premier tableau. La copie sur disque conserve l'ancien texte, aucune exception n'est levée, et le document en mémoire montre toujours le remplacement. Les modifications avant le premier tableau persistent, tout comme une cellule remplacée par un nouveau TableCell. Ces contrats placent la signature après le tableau des parties, de sorte qu'une vérification en mémoire passe des copies dont la signature enregistrée n'a jamais changé.
Le Save sans paramètre est documenté pour écraser le fichier source d'un document chargé, donc un lot ne devrait pas le appeler. Le guide de suppression de texte montre la suppression de paragraphe derrière la règle de fax.
Lors de l'étalonnage, le chargement d'un fichier de zéro octet a lancé une NullReferenceException, et un fichier texte, un package tronqué et un package de bits aléatoires ont chacun lancé une FileFormatException depuis un espace de noms obscurci avec le message File contains corrupted data. Un catch pour le type System.IO le manque. Attrapez Exception par fichier et enregistrez son type.
Les copies utilisent SaveAs, que la page de dépannage d'IronWord nomme pour un en-tête qui disparaît après l'enregistrement.
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.
Comment traiter un dossier de documents en parallèle ?
Les appels asynchrones effectuent des entrées/sorties de fichiers sans bloquer, mais la documentation indique que l'analyse et la sérialisation restent synchrones et qu'une instance de document n'est pas sûre pour les threads.
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.
Lors de l'étalonnage, l'ouverture et l'édition de la boîte de réception en mémoire, avec quatre fichiers illisibles inclus, ont pris 4.8 secondes séquentiellement, 1.4 avec une limite de 4 et 1.8 avec 16, et avec SaveAsAsync ont ajouté 14.4, 5.5 et 4.7 secondes. L'enregistrement est l'étape limitante.
Comment diagnostiquer un document qui affiche encore un ancien texte ?
Codex accepte des images via le drapeau -i (--image) lors d'une nouvelle session ou avec codex exec resume, ou en les collant dans le compositeur.
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.
Une réponse correcte nomme la partie en-tête et la ligne HeaderFlagged du fichier.
Comment déboguer la sortie incorrecte d'un lot de bout en bout?
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.
Le diagnostic devrait citer la ligne où le travail marque un contrat comme propre.
Comment transformer un code ponctuel en composants réutilisables et testés?
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.
Un refactoring peut supprimer une règle et toujours construire.
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.
La documentation des prompts personnalisés d'OpenAI déconseille les invites enregistrées dans ~/.codex/prompts au profit des compétences, où les questions récurrentes appartiennent.
$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.
Comment réutiliser ces invites sur un autre arriéré de documents ?
Avec les noms, chemins et règles modifiés, ces invites conviennent au prochain arriéré, et le guide des assistants de codage AI d'IronWord couvre la configuration de tous les cinq assistants.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Les invites ont été exécutées dans l'ordre dans une session Codex. Le projet .NET 9 contenait 124 contrats et un manifeste des statuts et comptes attendus, et chaque construction de Release a réussi. Notre scanner a rescanné chaque copie enregistrée, et les tests ont été relancés dans un nouveau clone.
- Avant le renom, l'inventaire correspondait au manifeste sur les 124 fichiers et marquait les 4 fichiers non-DOCX comme Illisibles.
- Après le rebranding séquentiel, les 120 copies enregistrées ne contenaient aucun des 114 anciens noms au-dessus du tableau des parties, y compris les 22 répartis sur plusieurs exécutions.
- Aucun des 13 titres en majuscules, 38 anciennes adresses d'avis ou 57 paragraphes de fax n'est resté.
- Tous les 9 noms de fonds de pension sont restés intacts.
- L'ancien nom est resté dans 28 tableaux de parties et 114 signatures, parce que l'enregistrement a rejeté ces modifications.
- Le CSV séquentiel du travailleur a donné à chaque fichier le statut du manifeste, Rebranded 104, HeaderFlagged 10, NoChange 6 et Unreadable 4, mais ses propres colonnes de compte affichaient encore les 114 signatures et 28 mentions de tableaux. Les statuts enregistrent la détection, pas le remplacement, comme Codex l'a lui-même signalé.
- Dans les 10 fichiers échantillons, le démarrage rapide a signalé 19 mentions de corps et 2 de tableau, contre 16 et 2 dans le manifeste. Son décompte de corps a également pris en compte les 2 mentions de cellules et le nom du fonds de pension.
- Sans la clé, le test à sec a modifié tous les 9 fichiers échantillons lisibles en mémoire. Le test d'enregistrement a lancé une LicensingException à SaveAs pour chacun d'eux.
- À des limites de 1, 4 et 32, les exécutions parallèles ont pris 11.456, 7.825 et 5.830 secondes. Toutes les 120 copies lisibles dans chaque dossier correspondaient aux séquentielles.
- Le diagnostic nocturne a retracé les résultats à la vérification sensible à la casse ExtractText().Contains du travail et à son remplacement au niveau du document. Elle n'a cité aucun numéro de ligne, et sa commande de preuve était destinée à un projet de test qui n'existait pas encore.
- Le refactoring a gardé chaque règle dans un RebrandJob.cs de 68 lignes, et ses copies finale/out correspondaient aux rebranded/out.
- final.csv correspondait aux statuts du manifeste mais marquait 118 lignes incomplètes, et Codex a signalé l'échec de la vérification du contenu.
- L'exécution de Codex et le nouveau clone ont chacun réussi 4 des 6 tests. Le test d'exécution fractionnée a échoué sur la signature et le test de tableau sur une cellule du tableau des parties.
- La réponse de l'API a listé quatre membres de chargement, sept de sauvegarde et cinq asynchrones, et a nommé le Save sans paramètre comme celui qui écrase la source.
- Elle a correctement nommé quatre membres documentés qui ne compilent pas. Ceux-ci étaient le constructeur prenant des octets et une chaîne, FlushModelToBytes, ReplaceTextAcrossRuns sur un paragraphe et SetNoChangeStatusAsUpdated.
- Elle a également listé le constructeur seulement octets, qui compile, et a manqué cinq autres qui échouent sur 2026.10.4, FromMarkdown, FromMarkdownFile, ExportToMarkdownFile, GetMailMergeWorkingBytes et ApplyCellStyle sur un tableau.
- Certaines étapes ont été exécutées différemment de la page. L'image a été rendue avec python-docx à partir de la copie MSA-1050 de l'exécution. Le travail nocturne, son journal et le fichier de révision juridique ont été ajoutés immédiatement avant l'invite d'enquête.
Le guide GitHub Copilot teste une instruction enregistrée en lisant son tableau via Tables, Rows et Cells. Le guide Cursor répertorie les parties d'un DOCX qu'IronWord ne lit pas.
Le dossier de course partagé liste la version Codex, le modèle, la machine et le temps pour cette exécution.
Dépannage
- Remplacer le texte dans les documents Word pour
ReplaceTextau niveau du paragraphe etFindText - L'en-tête disparaît après SaveAs si une copie enregistrée a perdu son en-tête
- IronWord avec DocumentFormat.OpenXml si la version inclut également le SDK OpenXML
- Licence IronWord dans web.config lorsque IronWord ignore une clé stockée dans Web.config
Des questions ?
Si vous avez des questions, contactez support@ironsoftware.com
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.