IronWord ile ChatGPT Codex Nasıl Kullanılır

Curtis Chau
Curtis Chau
Güncellendi: 19 Ekim 2026

Bir şirket adını değiştirdiğinde, hukuk ekibi güncelleme yapmak üzere imzalı sözleşmelerin olduğu bir dosya alır. Eski ad, metin paragraflarında, taraf tablolarında, büyük harfli başlıklarda ve sayfa başlıklarında bulunur. Word, ayrıca, adını birkaç biçimlendirme çalışmasının arasında depolayabilir, örneğin yıllar önce bir parça kalın yazılmışsa. Her dosyada standart bir bul-ve-değiştir bazı durumları düzeltir, ancak diğerleri uyarı olmaksızın değişmeden kalır.

ChatGPT Codex, OpenAI'nin kodlama aracıdır. Bir depo içinde dosyaları düzenler, dotnet run gibi komutlar yürütür ve ardından değişiklikleri özetler. Bir acente terminal, IDE'ler, ChatGPT masaüstü uygulaması ve bulut görevleri için hizmet verir. IronWord, Iron Software'den bir .NET kütüphanesi olup, mevcut Word belgelerini, Microsoft Office olmadan değiştirilebilen ve kaydedilebilen paragraflar, çalıştırma ve tablo nesne modeli olarak açar.

Codex, bir kontrat yedeğinde bir temel manifest ile çalışır. Toplu bildirimler, her bir sözleşme için bir satır içeren bir CSV yazar, bu nedenle Codex'ten rapor edilen her sayı bir dosya ile desteklenir.

Hızlı Başlangıç
NuGetNuGet ile Yükle

PM > Install-Package IronWord

Yukarıdaki komutu NuGet Paket Yöneticisi Konsolunda çalıştırarak veya NuGet Paket Yöneticisinde arama yaparak IronWord'u yükleyin.

.NET konsol projesinde Codex'i, sözleşme klasörü içeren bir çalışma ile başlatın ve herhangi bir düzenlemeden önce bir envanter isteyin.

$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


ChatGPT Codex nedir ve .NET Word belge işine nasıl uyar?

Yükleme adımları Codex CLI belgelerinde yer almakta ve sürümler açık kaynak deposunda yayımlanmaktadır.

Codex, IronWord'u eğitim verilerinden ve sağlanan dosyalardan tanır ve yeni bir sürüm her ikisini de güncel olmayabilir. 2026.10 sürümleri akışlar ve eşzamansız çağrılar aracılığıyla yükler ve kaydeder.

Bir IronWord bildirimini nasıl yazarsınız ve Codex'i bunun için nasıl kurarsınız?

Etkili bir toplu bildirim, girdiyi, adın her konumunu, çıktıyı, kanıtı, salt okunur temel doğruyu ve kısıtlamaları adlandırır.

OpenAI'nin dil modellerinin halüsinasyon nedenini anlatan makalesi, yanlış yanıtları tahmin ödüllendiren eğitim ve değerlendirmelere bağlar, ve yeniden adlandırma işinde tahmin her sözleşmenin temiz olduğudur.

Codex, çalışılan dizin ve depo kökü arasındaki her dizindeki .agents/skills içindeki becerilere bakar. .agents/skills/IronWord/SKILL.md olarak kaydedildi, IronWord'un skill.md hedefi $ironword bahsini çözer.

Herhangi bir işten önce, Codex depo kökü ile çalışma klasörü arasındaki yoldaki her dizinde en fazla bir AGENTS.md okur. Çalışma klasörüne en yakın dosya önceliklidir. /init komutu başlangıç AGENTS.md bir taslak oluşturur.

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

Codex'e IronWord eklemesini ve lisansı kontrol etmesini nasıl sorarsınız?

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, IronSoftware.Abstractions 2026.1.2, IronSoftware.Common 2026.4.2 ve IronSoftware.System.Drawing 2026.11.3'ü referans alır. Ayrıca listelenen IronSoftware.Drawing.Abstractions 2026.1.2'yi geri yükleyin. Derleme, Windows, Linux ve macOS için yerel LayoutEngineInterop kütüphanelerini bir çalışma zamanları klasörüne kopyalar. OpenXML çatışma sayfası 2025.7.13 öncesi sürümlerde daha yeni bir DocumentFormat.OpenXml ile bir çatışmayı kapsar. Sabitlemeden önce IronWord değişiklik günlüğünü kontrol edin.

Bir anahtar olmadan, açma, okuma ve değiştirme başarılı olur, ancak her kaydetme aşırı yüklemesi, eşzamanlı olanlar dahil, Production License Required mesajı ile bir LicensingException fırlatır.

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

lisan anahtarları sayfası Web.config, App.config ve appsettings.json'u da kapsar.

Bir Word belgesinin hangi bölümlerine metin değiştirme ulaşır?

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

Yerleşik gezgin acente, gerçek dosyalar üzerinde değişimi test eder.

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

2026.10.4'teki kalibrasyon bu hafıza sonuçlarını verdi.

YerBelge düzeyi değiştirmeOna ulaşan
Gövde, bir çalıştırmaDeğiştirildiBelge çağrısı
Gövde, çalıştırmalar arasında bölünmüşDeğiştirildiBelge çağrısı
Tablo hücresiDeğiştirilmediReplaceText her TableCell üzerinde
Büyük harfle yazılmış başlıkDeğişmeden (torensiz eşleşme)Büyük harf formu ile ikinci bir çağrı
Emeklilik güven fonu adıYenilenmiş (düz alt dizi eşleşmesi)İlk olarak bir yer tutucu ikame edildi ve sonrasında geri yüklendi
Başlık veya altbilgiNesne modelinde değilBildirin, ardından elle düzenleyin

Bölünmüş çalıştırma satırının bir yan etkisi var. Kalın North ardından sade wind Traders olarak saklanan bir ad, Contoso Ltd. okuyan bir kalın çalıştırma olur.

Belgenin sadece gövde paragraflarını döndüren ExtractText üzerine kurulu bir kontrol, taraf tablosu hala eski şirketi adlandıran bir sözleşmeyi geçer. FindText bölünmüş bir çalıştırma eşleşmesi kaçırır, çünkü sadece tüm ifadenin yer aldığı bir metin elemanı ile eşleşir.

Bir belge klasöründe metni nasıl değiştirirsiniz?

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

IronWord 2026.10.4'te, bir tablo içeren bir yüklü DOCX kaydetmek, ilk tablodan sonra her paragraftaki ve tablodaki metin düzenlemelerini atar. Diskteki kopya eski metni saklar, hiçbir istisna ortaya çıkmaz ve bellek içi belge hala yer değişikliği gösterilir. İlk tablodan önceki değişiklikler, yeni bir TableCell ile değiştirilen bir hücre gibi kalıcıdır. Bu sözleşmeler imzayı taraf tablosunun arkasında yerleştirir, bu nedenle bellek içi kontrol kaydedilmiş imzası hiçbir zaman değişmemiş olan kopyaları geçer.

Parametresiz Save, bir yüklü belgenin kaynak dosyasının üzerine yazıldığını belgeler, bu nedenle bir toplu işlem ona çağrı yapmamalıdır. Metni kaldırma kılavuzu fak kuralının arkasındaki paragraf kaldırılmasını gösterir.

Kalibrasyonda, sıfır byte'lık bir dosyanın yüklenmesi NullReferenceException fırlattı ve metin dosyası, kısılmış bir paket ve rastgele byte paketlerinin her biri, dosya bozuk veri içeriyor mesajı ile birlikte gizlenmiş bir ad alanından FileFormatException fırlattı. System.IO türü için bir yakalama onu kaçırır. Dosya başına Exception yakalayın ve türünü kaydedin.

Kopyalar, bir kaydedildikten sonra kaybolan başlığın adını veren IronWord'un sorun giderme sayfasında SaveAs kullanır.

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

Bir belge klasörünü nasıl paralel işlersiniz?

Eşzamanlı çağrılar dosya G/Ç işlemi yapar ve engellemez, ancak belgelerde çözümleme ve serileştirmenin eşzamanlı kaldığını ve bir belge örneği iş parçacığı güvenli olmadığını belirtir.

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

Kalibrasyonda, bellek içi gelen kutusunu açmak ve düzenlemek 4 okunamayan dosya dahil, ardışık olarak 4,8 saniye, 4 limitinde 1,4 ve 16'da 1,8 saniye sürdü ve SaveAsAsync eklenmesi ile 14,4, 5,5 ve 4,7 saniye aldı. Kaydetme sınırlayıcı adımdır.

Hala eski metni gösteren bir belgeyi nasıl teşhis edersiniz?

Codex, yeni bir oturumda -i bayrağı (--image) aracılığıyla veya codex exec resume ile ya da besteciye yapıştırma ile görselleri kabul eder.

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

Doğru bir yanıt, başlık kısmını ve dosyanın HeaderFlagged satırını adlandırır.

Yanlış toplu çıktı sonuna kadar nasıl hata ayıklarsınız?

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

Teşhis, bir sözleşmenin temiz olarak işaretlendiği satırı belirtmelidir.

Geçici kodu yeniden kullanılabilir, test edilmiş bileşenlere nasıl dönüştürürsünüz?

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

Bir kuralı kaldırmak ve hala derlemek için bir yeniden yapılandırma yapılabilir.

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

OpenAI'nin özel verev işaretçiler dökümantasyonu, tekrarlayan soruların ait olduğu beceriler lehine ~/.codex/prompts içinde kaydedilen istemleri kullanımdan kaldırır.

$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

Bu istemleri başka bir belge yedeğinde nasıl yeniden kullanırsınız?

Adlar, yollar ve kurallar değiştirilerek, bu istemler sonraki yedeğe uyar ve IronWord AI kodlama asistanları rehberi, beş asistan için kurulumun hepsini kapsar.

Gerçek bir çalıştırmada istemler ne üretti?

İstemler bir Codex oturumunda sırayla çalıştırıldı. .NET 9 projesi 124 sözleşme ve beklenen durumlar ve sayıları içeren bir manifesto tuttu ve her Release derlemesi başarıya ulaştı. Taramamız her kaydedilmiş kopyayı yeniden taradı ve testler yeni bir clone'da tekrar çalıştırıldı.

  • Yeniden adlandırmadan önce, envanter tüm 124 dosya üzerinde manifestoyu eşleştirdi ve 4 DOCX olmayan dosyayı Okunamaz olarak işaretledi.
  • Ardışık yeniden markalamadan sonra, kaydedilen 120 kopya, parti tablosu üzerinde 114 eski isimden hiçbirini içermiyordu, çalıştırmalara dağıtılan 22 dahil.
  • 13 büyük harfli başlıktan, 38 eski bildirim adresinden veya 57 faks paragrafından hiçbiri kalmamıştır.
  • Tüm 9 emeklilik güven fonu adı sağlam kaldı.
  • Kaydetme, taraf tablolarındaki ve 114 imzalarındaki değişiklikleri attığından, eski ad 28 taraf tablosu ve 114 imzada kaldı.
  • Çalışanın sequential.csv her dosyaya manifestonun durumunu verdi, 104'ü Yeniden Markalandı, 10'u Başlık Etiketli, 6'sı Değişiklik Yok ve 4'ü Okunamaz, ancak kendi sayım sütunları hala 114 imza ve 28 tablo görüşmesini gösteriyordu. Durumlar algılama kaydeder, değiştirme değil, Codex'un kendisi bildirdiği gibi.
  • 10 örnek dosyada, hızlı başlangıç 19 gövde ve 2 tablo görüşmesi bildirdi, manifestoda 16 ve 2 karşı. Gövde sayısı ayrıca 2 hücre görüşmesini ve emeklilik güven fonu adını aldı.
  • Anahtar olmadan, kuru çalıştırma bellek içindeki 9 okunabilir örnek dosyayı düzenledi. Kaydetme çalıştırması, her biri için SaveAs'ta LicensingException fırlattı.
  • 1, 4 ve 32 limitlerinde, paralel çalıştırmalar 11.456, 7.825 ve 5.830 saniye sürdü. Her klasördeki tüm 120 okunabilir kopyalar ardışık olanlarla eşleşti.
  • Gecelik teşhis, bulguları işin büyük küçük harfe duyarlı ExtractText().Contains kontrolüne ve belge düzeyi değiştirmesine izledi. Hiçbir satır numarası belirtilmedi ve kanıt komutu henüz mevcut olmayan bir test projesini hedef aldı.
  • Yeniden yapılandırma, 68 satırlık RebrandJob.cs içinde her kuralı korudu ve çıkış/son kopyalar çıkış/yeniden markalanmış ile eşleşti.
  • final.csv manifesto durumlarla eşleşti ama 118 satırı eksik olarak işaretledi ve Codex içerik kontrolünü başarısız bildirdi.
  • Codex'un çalıştırması ve yeni klon her 6 testin 4'ünü geçti. Bölünmüş çalıştırma testi imzada başarısız oldu ve tablo testi parti tablosu hücresinde başarısız oldu.
  • API yanıtı dört yükleme, yedi kaydetme ve beş eşzamanlı üye sıraladı ve parametresiz Save'in kaynağı üzerine yazan üye olduğunu isimlendirdi.
  • Dört belgelenmiş üyenin doğru şekilde derlenmediğini isimlendirdi. Bunlar byte alarak ve bir dize alan kurucu, FlushModelToBytes, bir paragrafta çalıştırmalar arasında ReplaceText ve SetNoChangeStatusAsUpdated idi.
  • Byte alınan kurucuyu da listeledi, ki derlenir, ve 2026.10.4'te başarısız olan diğer beşini kaçırdı, FromMarkdown, FromMarkdownFile, ExportToMarkdownFile, GetMailMergeWorkingBytes ve bir tablodaki ApplyCellStyle.
  • Bazı adımlar sayfadan farklı çalıştı. Görsel, çalıştırmanın MSA-1050 kopyasından python-docx ile oluşturuldu. Gecelik iş, günlüğü ve hukuk inceleme dosyası soruşturma bildiriminden hemen önce eklendi.

GitHub Copilot rehberi, bir tablodan satırlar ve hücreler üzerinden okuyarak kaydedilmiş bir beyanı test eder. Kursor rehberi, IronWord'un okumadığı bir DOCX'in bölümlerini listeler.

Paylaşılan çalışma kaydı, bu çalışmanın Codex sürümünü, modelini, makinesini ve zamanlamasını listelemektedir.


Hata Ayıklama


Sorular?

Herhangi bir sorunuz varsa, support@ironsoftware.com adresinden bize ulaşın

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

Daha Fazla Oku

Başlamaya Hazır mısınız?

NuGet İndirmeleri 62,392Sürüm:2026.11yeni çıktı