Jak używać IronWord z ChatGPT Codex
Kiedy firma zmienia nazwę, zespół prawny otrzymuje folder podpisanych umów do zaktualizowania. Stara nazwa znajduje się w akapitach treści, tabelach stron, tytułach z wielkimi literami i nagłówkach stron. Word może również przechowywać nazwę w kilku seriach formatowania, na przykład gdy jeden fragment został pogrubiony lata temu. Standardowe znajdowanie i zamienianie w każdym pliku poprawia tylko niektóre przypadki, podczas gdy inne pozostają niezmienione bez ostrzeżenia.
ChatGPT Codex to agent kodujący z OpenAI. W repozytorium edytuje pliki, wykonuje polecenia takie jak dotnet run, a następnie podsumowuje zmiany. Jeden agent obsługuje terminal, IDE, aplikację desktopową ChatGPT i zadania w chmurze. IronWord, biblioteka .NET z Iron Software, otwiera istniejące dokumenty Word jako model obiektowy akapitów, serii i tabel, które kod może edytować i zapisywać bez Microsoft Office.
Codex działa na backlogu kontraktów z manifestem prawdy podstawowej. Partie poleceń zapisują CSV z jednym wierszem na kontrakt, więc każdy licznik, który zgłasza Codex, jest poparty plikiem.
Szybki startUruchomić Codex w projekcie konsolowym .NET, który zawiera folder kontraktów, i zażądać inwentaryzacji przed jakąkolwiek edycją.
$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.
Minimalny proces (5 kroków)
- Pobierz bibliotekę Word C# z NuGet
- Zapisz umiejętność IronWord jako .agents/skills/ironword/SKILL.md, aby odwołanie
$ironwordzostało rozwiązane - Udostępnij AGENTS.md, który oznacza oryginały jako tylko do odczytu i wymaga CSV dla każdej liczby
- Najpierw zinwentaryzuj każdą lokalizację, a następnie zamień tekst w treści i tytułach z wielkimi literami oraz zastąp każdą zmienioną komórkę tabeli nową
- Ponownie przeszukaj zapisane kopie i porównaj plik wyników z manifestem przed akceptacją jakiegokolwiek statusu
Czym jest ChatGPT Codex i jak wpisuje się w pracę z dokumentami Word na platformie .NET?
Kroki instalacji znajdują się w dokumentacji CLI Codex, a wersje są publikowane w repozytorium open-source.
Codex zna IronWord z danych treningowych i dostarczonych plików, a nowe wydanie może sprawić, że oba będą nieaktualne. Wydania 2026.10 ładują i zapisują przez strumienie i asynchroniczne wywołania.
Jak napisać zapytanie do IronWord i skonfigurować Codex do tego?
Efektywne masowe zapytanie nazywa wejście, każdą lokalizację nazwy, wyjście, dowód, prawdę podstawową tylko do odczytu i ograniczenia.
Dokumentacja OpenAI dlaczego modele językowe mają halucynacje śledzi pewne błędne odpowiedzi na trening i ocenę, które nagradzają zgadywanie, a w zadaniu zmiany nazwy przypuszczenie jest takie, że każdy kontrakt jest czysty.
Codex szuka umiejętności w .agents/skills w każdym katalogu między katalogiem roboczym a korzeniem repozytorium. Zapisany jako .agents/skills/IronWord/SKILL.md, skill.md IronWord rozwiązuje odwołanie $ironword.
Przed rozpoczęciem pracy Codex czyta maksymalnie jedną AGENTS.md w każdym katalogu na ścieżce między korzeniem repozytorium a folderem roboczym. Plik najbliższy folderowi roboczemu ma pierwszeństwo. Polecenie /init szkicuje początkowy 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.
Jak poprosić Codex o dodanie IronWord i sprawdzenie licencji?
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 odnosi się do IronSoftware.Abstractions 2026.1.2, IronSoftware.Common 2026.4.2 i IronSoftware.System.Drawing 2026.11.3. Przywróć również wymienione IronSoftware.Drawing.Abstractions 2026.1.2. Kopia natywna bibliotek LayoutEngineInterop dla Windows, Linux i macOS do folderu runtimes. Strona konflikt OpenXML obejmuje konflikt z nowszym DocumentFormat.OpenXml w wydaniach przed 2025.7.13. Sprawdź changelog IronWord przed przypięciem.
Bez klucza, otwieranie, czytanie i zastępowanie powiodą się, ale każde przeciążenie zapisu, w tym asynchroniczne, rzuca LicensingException z wiadomością 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.
Strona kluczy licencyjnych obejmuje również Web.config, App.config i appsettings.json.
Które części dokumentu Word obejmuje zamiana tekstu?
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.
Wbudowany agent eksploracyjny testuje zamianę na rzeczywistych plikach.
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.
Kalibracja na 2026.10.4 dała te wyniki w pamięci.
| Lokalizacja | Zamiana na poziomie dokumentu | Co do niego dociera |
|---|---|---|
| Treść, jedna seria | Zastąpiony | Wywołanie dokumentu |
| Treść, podzielona na serie | Zastąpiony | Wywołanie dokumentu |
| Komórka tabeli | Nie zmieniony | ReplaceText na każdym TableCell |
| Tytuł z wielkimi literami | Niezmieniony (dopasowanie uwzględniające wielkość liter) | Drugie wywołanie z formą z wielkimi literami |
| Nazwa funduszu emerytalnego | Zmieniona (dopasowanie zwykłego podciągu) | Najpierw podstawiono symbol zastępczy, a następnie przywrócono go |
| Nagłówek lub stopka | Nie w modelu obiektowym | Należy zgłosić to, a następnie edytować ręcznie |
Wiersz z rozdzielonym przebiegiem ma działanie uboczne. Nazwa przechowywana jako pogrubiony Północ połączony z prostym Traders staje się jedną pogrubioną serią odczytującą Contoso Ltd.
Sprawdzenie zbudowane na ExtractText dokumentu, które zwraca tylko akapity treści, przechodzi kontrakt, którego tabela strony wciąż wymienia starą firmę. FindText pomija dopasowanie z rozdzieloną serią, ponieważ pasuje tylko do elementu tekstowego, który zawiera całe wyrażenie.
Jak zamienić tekst w folderze dokumentów?
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.
W IronWord 2026.10.4 zapisanie załadowanego pliku DOCX z tabelą odrzuca każdą edycję tekstu wewnątrz tabeli i w dowolnym akapicie po pierwszej tabeli. Kopia na dysku zachowuje stary tekst, nie zgłasza wyjątku, a dokument w pamięci nadal pokazuje zamianę. Edycje przed pierwszą tabelą są trwałe, podobnie jak komórka zastąpiona przez nową TableCell. Te kontrakty umieszczają podpis za tabelą stron, więc sprawdzenie w pamięci przechodzi kopie, których zapisany podpis nigdy się nie zmienił.
Bezparametrowa Save jest udokumentowana jako nadpisująca plik źródłowy załadowanego dokumentu, więc partia nie powinna jej wywoływać. Przewodnik usuwania tekstu pokazuje usuwanie akapitu za zasadą faxu.
W kalibracji załadowanie pliku o zerowym bajcie wyrzuciło NullReferenceException, a plik tekstowy, obcięty pakiet i pakiet losowych bajtów każdy wyrzucił FileFormatException z zaciemnioną przestrzenią nazw i wiadomością Plik zawiera uszkodzone dane. Przechwytywanie dla typu System.IO pomija to. Złap Exception na plik i zarejestruj jego typ.
Kopie używają SaveAs, co strona pomocy IronWord nazywa nagłówkiem, który znika po zapisaniu.
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.
Jak przetworzyć folder dokumentów równolegle?
Wywołania asynchroniczne wykonują operacje wejścia/wyjścia z plikami bez blokowania, ale dokumentacja stwierdza, że analiza składniowa i serializacja pozostają synchroniczne i że jedno wystąpienie dokumentu nie jest bezpieczne dla wielowątkowości.
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.
W kalibracji otwarcie i edytowanie skrzynki odbiorczej w pamięci, w tym cztery nieczytelne pliki, zajęło 4,8 sekundy sekwencyjnie, 1,4 przy limicie 4 i 1,8 przy 16, a z SaveAsAsync dodano 14,4, 5,5 i 4,7 sekundy. Zapis jest ograniczającym krokiem.
Jak zdiagnozować dokument, który nadal pokazuje stary tekst?
Codex akceptuje obrazy za pomocą flagi -i (--image) w nowej sesji lub z codex exec resume, lub jako wklejenie do kompozytora.
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.
Prawidłowa odpowiedź nazywa część nagłówka i wiersz pliku HeaderFlagged.
Jak debugować niepoprawne wyjście partii od początku do końca?
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.
Diagnoza powinna cytować linię, w której zadanie oznacza umowę jako czystą.
Jak zmienić jedno-znaczne kody na komponenty do wielokrotnego wykorzystania i testowania?
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.
Refaktoryzacja może usunąć regułę i nadal zbudować projekt.
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.
Dokumentacja pryncypiów dostosowanych OARimpoli OpenAI odnosi się do pobranych preferencji dla nowych umiejętności, gdzie należą powtarzające się pytania.
$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.
Jak ponownie użyć tych zapytań na innym backlogu dokumentów?
Ze zmienionymi nazwami, ścieżkami i regułami te zapytania pasują do następnego backlogu, a przewodnik po asystentach AI IronWord obejmuje konfigurację wszystkich pięciu asystentów.
Co wyprodukowały zapytania w rzeczywistym uruchomieniu?
Zapytania były uruchamiane w kolejności w jednej sesji Codex. Projekt .NET 9 zawierał 124 umowy i manifest oczekiwanych statusów i liczników, a każda kompilacja wydania powiodła się. Nasz skaner ponownie przeskanował każdą zapisaną kopię, a testy były ponownie uruchomione na świeżym klonie.
- Przed zmianą nazwy, inwentaryzacja zgadzała się z manifestem na wszystkich 124 plikach i oznaczyła 4 pliki inne niż DOCX jako Nieczytelne.
- Po sekwencyjnym rebrandingu, 120 zapisanych kopii nie zawierało żadnego z 114 starych nazw powyżej tabeli strony, w tym 22 podzielonych na serie.
- Żaden z 13 tytułów z wielkimi literami, 38 starych adresów powiadomień ani 57 akapitów faksowych nie pozostał.
- Wszystkie 9 nazw funduszy emerytalnych pozostało nienaruszonych.
- Stara nazwa pozostała w 28 tabelach stron i 114 podpisach, ponieważ zapis odrzucił te edycje.
- Sequential.csv pracownika dał każdemu plikowi status z manifestu, Rebranded 104, HeaderFlagged 10, NoChange 6 i Unreadable 4, ale jego własne kolumny zliczeń wciąż pokazywały 114 podpisów i 28 wzmianek o tabelach. Statusy rejestrują wykrywanie, nie zamianę, jak sam Codex zgłosił.
- W 10 przykładowych plikach, szybki start zgłosił 19 odniesień do treści i 2 do tabeli, w porównaniu z 16 i 2 z manifestu. Jego zliczanie treści obejmowało również 2 wzmianki o komórkach i nazwę funduszu emerytalnego.
- Bez klucza, suchy przebieg edytował wszystkie 9 czytelnych przykładowych plików w pamięci. Przebieg zapisu rzucił LicensingException przy SaveAs dla każdego z nich.
- Przy limitach 1, 4 i 32, przebiegi równoległe zajęły 11,456, 7,825 i 5,830 sekundy. Wszystkie 120 czytelnych kopii w każdym folderze zgadzały się z sekwencyjnymi.
- Nocna diagnoza prześledziła wyniki do sprawdzenia ExtractText().Contains rozróżniającego wielkość liter zadania i jego zamiany na poziomie dokumentu. Nie cytowano numerów linii, a polecenie dowodowe celowało w projekt testowy, który jeszcze nie istniał.
- Refaktoryzacja zachowała każdą regułę w 68-liniowym RebrandJob.cs, a jej kopie końcowe/ostateczne pasowały do out/rebranded.
- Final.csv zgadzał się z statusami manifestu, ale oznaczył 118 wierszy jako niekompletne, a Codex zgłosił, że sprawdzanie zawartości zakończyło się niepowodzeniem.
- Przebieg Codex i świeży klon każdy przeszedł 4 z 6 testów. Test z rozdzieloną serią nie przeszedł na podpisie, a test tabeli na komórce tabeli stron.
- Odpowiedź API wymieniła cztery ładowania, siedem zapisów i pięć asynchronicznych członków, oraz wskazała Save bez parametrów jako ten, który nadpisuje źródło.
- Prawidłowo wymieniła czterech udokumentowanych członków, które nie kompilują się. Były to konstruktor przyjmujący bajty i ciąg, FlushModelToBytes, ReplaceTextAcrossRuns w akapicie i SetNoChangeStatusAsUpdated.
- Zawierała również konstruktor wyłącznie dla bajtów, który się kompiluje, i pominęła pięciu innych, które zawiodły na 2026.10.4, FromMarkdown, FromMarkdownFile, ExportToMarkdownFile, GetMailMergeWorkingBytes i ApplyCellStyle w tabeli.
- Niektóre kroki uruchomiono inaczej niż na stronie. Obraz był renderowany za pomocą python-docx z kopii MSA-1050 biegu. Nocna praca, jej dziennik i plik przeglądu prawnego zostały dodane tuż przed zapytaniem dochodzeniowym.
Przewodnik GitHub Copilot testuje zapisaną deklarację, odczytując jej tabelę przez Tables, Rows i Cells. Przewodnik Cursor wymienia części DOCX, których IronWord nie czyta.
Udostępniony rekord uruchomienia wymienia wersję Codex, model, maszynę i czas działania dla tego uruchomienia.
Rozwiązywanie problemów
- Zamiana tekstu w dokumentach Word dla
ReplaceTextpoziomu akapitu iFindText - Nagłówek zanika po SaveAs jeśli zapisana kopia utraciła nagłówek
- IronWord z DocumentFormat.OpenXml jeśli budowa odnosi się również do SDK OpenXML
- Licencja IronWord w web.config gdy IronWord ignoruje klucz przechowywany w Web.config
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.