IronWord'u Cursor ile Nasıl Kullanırsınız?
Bu kılavuzun örnek deposu, tedarikçi formlarını OpenXML SDK kodu ile okuyarak, gövde elemanları üzerinde iterasyon yapar ve InnerText'i okur. Her etiketli değeri bir düzenli ifade ile çıkarılan metin bloğundan ayırarak IronWord'a taşımak başarısız olur. Kalibrasyonda, o sürüm 12 formun 3'ünü doğru bir şekilde okudu, beş kayıt numarasını takip eden etikete birleştirdi ve dört tablo formu için kayıt numarası döndürmedi.
Cursor, VS Code kod tabanı üzerine inşa edilmiştir ve düzenleyicinin yanında bir ajan sağlar. İki özelliği; ajan okuduğu dokümantasyon bağlantıları ve .cursor/rules içindeki proje kuralları, IronWord kodu mu yoksa OpenXML okuyucu desenini takip eden kod mu ürettiğini belirler. Her iki özellik de aşağıda, tedarikçiler tarafından döndürülen DOCX formlarını okuyan bir tedarikçi uyarı hizmetinde görünür. Hizmet, tedarikçi adını, kayıt numarasını, fiyat listesi tablosunu ve gömülü logo ve imza resimlerini çıkarır ve okuyucusu OpenXML SDK'dan IronWord'a geçiş yapar.
IronWord'un okuma yöntemleri hakkında ayrıntılar için, metin çıkarma kılavuzuna ve resim çıkarma kılavuzuna bakın.
Hızlı BaşlangıçTedarikçi alım deposu açıkken, bu istemi yeni bir Ajan sohbetine yapıştırın.
@src/SupplierIntake/ @TestData/forms/
Don't write anything until you've fetched https://ironsoftware.com/word/csharp/llms.txt.
Read the extract text and extract images pages it links as well.
Then give Program.cs a dump command that opens one form with IronWord:
`dotnet run --project src/SupplierIntake -- dump <file.docx>`
Have the dump print what IronWord returns for that form:
- The ExtractText result, in quotes.
- Every entry of Paragraphs, with its index.
- Every table cell, with its table, row and column numbers.
- Each extracted image's Width and Height, and the pixel size of the AnyBitmap behind it.
The program should read IRONWORD_LICENSE_KEY itself when it's set.
At startup, assign the key to License.LicenseKey.
Never print the key, and keep environment variables out of the output.
Leave Forms/FormReader.cs and its DocumentFormat.OpenXml reference as they are.
Run the dump on TestData/forms/form-03.docx and show me the output.
Bir sohbete lisans anahtarı girmeyin. Ajan dosyaları düzenler ve shell komutları çalıştırabilir, bu nedenle yapıştırılan bir anahtar, yazdığı her dosyaya, komut mesajına ve derleme günlüğüne maruz kalır. Testlerimizde, IronWord anahtar olmadan her formu açtı ve okudu ve yalnızca bir belgeyi kaydederken LicensingException fırlattı. Lisans anahtarı kılavuzu, anahtarı kodda, Web.config'te veya appsettings.json'da nasıl ayarlayacağınızı gösterir.
Asgari İş Akışı (5 adım)
- NuGet'ten C# Word kütüphanesini indirin
- .cursor/rules altında, IronWord'un dokümantasyon bağlantısını içeren bir proje kuralı ekleyin
- Kuralda
ExtractText'in neleri dışarıda bıraktığını belgeleyin - Her istekte okuyucu dosyasına ve döndürülen formlar klasörüne atıfta bulunun
- Her çıkarılan değeri bilinen bir listeyle karşılaştırın, ardından her üye adını API referansında doğrulayın
IronWord ile çalışmak için hangi Cursor modelini kullanmalısınız?
Composer, Cursor'un kendi agentik modelidir. Model seçici ayrıca Cursor tarafından ortak geliştirilen SpaceXAI'nın Grok modellerini ve OpenAI, Anthropic, Google ile diğer laboratuvarların modellerini sunar. Aşağıdaki test çalışması Grok 4.7 kullanıldı.
Cursor'a IronWord dokümantasyonunu nasıl sağlarsınız?
IronWord'un dokümantasyon bağlantısını isteğe dahil edin veya tüm ekibin paylaştığı bir kurala kaydedin. IronWord'un llms.txt dosyası her kılavuzu ve API referansını listeler ve llms-full.txt 46 dokümantasyon sayfasını tek bir dosyada özetler. Ekim 2026 itibarıyla, Cursor'un @ menüsü dosyaları, klasörleri, terminalleri, sohbetleri, Git karşılaştırmalarını ve tarayıcıyı ekler, bu nedenle IronWord'un dokümantasyonu ajanına bir bağlantı olarak gönderilir.
Quickstart dökümü, metin çıkarma kılavuzunda belirtilmeyen iki davranışı gösterir. Form-03 için ExtractText, gövde paragraf metnini bir string'e birleştirip formun iki tablosundaki tüm metni dışarıda bıraktı.
@src/SupplierIntake/Forms/RegistrationCheck.cs
Answer five questions about IronWord, without editing any files:
1. Does WordDocument.ExtractText include text from table cells?
2. What does it put between paragraphs?
3. Does the Paragraphs collection list the paragraphs inside table cells?
4. What does ExtractImages return, and what element type does the list hold?
5. What unit do the Width and Height of each result use?
Use the documentation at https://ironsoftware.com/word/csharp/llms.txt as your source.
The project rule doesn't count as one.
Check your answers against the form-03 dump from the last turn, where it shows them.
Cite the page each answer comes from.
Where no page states it, say the answer is measured, not documented.
IronWord kurallarınızı kodlayan proje kurallarını nasıl yazarsınız?
Bir proje kuralı, .cursor/rules altında depolanan ve depo ile sürümlenen bir .mdc dosyasıdır, bu nedenle her klonlama onu içerir. Cursor, o klasördeki düz .md dosyalarını yoksayar çünkü, ön madde olmadığında, ne zaman yüklenmesi gerektiğini belirleyemez.
Aşağıdaki kural, globs'i tanımlar ve alwaysApply'u false olarak ayarlar. Bir istek bir form okuyucu veya bir test dosyası içerdiğinde Cursor onu yükler, aksi takdirde dışarıda bırakır. Onu .cursor/rules/ironword-forms.mdc olarak kaydedin.
---
description: IronWord conventions for reading supplier forms
globs: src/SupplierIntake/Forms/**/*.cs, tests/**/*.cs
alwaysApply: false
---
Read and write DOCX files with IronWord only, under these package rules:
- The NuGet package is IronWord.
- Its types come from two namespaces, IronWord and IronWord.Models.
- AnyBitmap comes from IronSoftware.Drawing.
- Don't add DocX, NPOI or any other DOCX package.
- Add no new DocumentFormat.OpenXml code.
- The documentation index is https://ironsoftware.com/word/csharp/llms.txt
Keep license keys out of the code, and handle the key this way:
- Read it at run time from an environment variable named IRONWORD_LICENSE_KEY.
- Never print it.
WordDocument.ExtractText leaves out table cells and runs paragraphs together with no separator.
Use the paragraph and table collections instead:
- Read labeled values one paragraph at a time from doc.Paragraphs.
- Read tables through doc.Tables, Rows and Cells.
- doc.Paragraphs also returns the paragraphs inside table cells.
Table.Rows returns ITableRow, and a row's Cells returns ITableCell.
Two casts are needed:
- Cast a row to TableRow before you pass it to a method that takes a TableRow.
- Cast a cell to TableCell before you call ExtractText on it.
Don't invent IronWord members.
When you're unsure of one, say so and name the page you checked.
Cursor'un kurallar sayfası, kuralların Tab'ı etkilemediğini ve kullanıcı kurallarının satır içi düzenlemelere uygulanmadığını belirtir, bu nedenle Tab ve satır içi düzenleme önerileri kurala karşı manuel olarak kontrol edilmelidir.
OpenXML SDK çağrılarını IronWord ile nasıl eşlersiniz?
Modele IronWord kullanmasını söylemek, her OpenXML SDK çağrısının yerine hangi IronWord çağrısının geçtiğini söylemez. Eşdeğerler tablosu bu haritalamayı sağlar.
| OpenXML SDK | IronWord |
|---|---|
WordprocessingDocument.Open | Yol, bytes veya bir akıştan bir WordDocument yapıcı |
| Gövde paragrafları ve bunların iç metinleri | Paragraphs, her biri için ExtractText ile |
| Gövde tabloları, satırlar ve hücreler | Tables, Rows ve Cells |
| Blip öğeleri ve resim parçaları akışları | ExtractImages, AnyBitmap aracılığıyla kaydedildi |
İki satır, yerini aldıkları SDK kodundan farklı davranır. Paragraf listesi, tablo hücrelerinin içindeki paragraflar ile gövdedeki paragrafları tutar, bu nedenle form-03, OpenXML SDK okuyucusunun 5 gövde paragrafı üzerinden iterasyon yaptığı yerde 15 giriş döndürür. Hücreler ITableCell olarak döndürülür ve bir metin yöntemi yoktur, bu nedenle döküm olmadan yapılan bir çağrı CS1061 ile derleme hatasına neden olur.
IronWord, DocumentFormat.OpenXml paketini referans almaz ve hem IronWord 2026.10.4 hem de DocumentFormat.OpenXml 3.5.1'i referans alan bir proje derlenir ve çalışır. Bu nedenle geçiş bir seferde bir okuyucu olarak devam edebilir. OpenXML çatışma sayfası 2025.7.13'ten daha eski IronWord derlemelerini kapsar.
Kuralları sonuna bu satırları eklemek, kuralı yükleyen her isteğe tabloyu ekler.
Translate OpenXML SDK code instead of porting it, with these equivalents:
- WordprocessingDocument.Open becomes new WordDocument(path).
- Body.Elements<Table>() becomes doc.Tables.
- Counting Blip elements becomes doc.ExtractImages().Count.
Save extracted images with ((AnyBitmap)image.Image).SaveAs(path).
IronWord'a bir geçişi nasıl planlar ve yürütürsünüz?
Plan Modu seçilene kadar sohbet girişinde Shift+Tab tuşlarına basın, ardından aşağıdaki isteği gönderin. Cursor, planını düzenlenebilir bir dosyaya yazar.
@src/SupplierIntake/Forms/ @TestData/forms/expected.csv
Plan the move of FormReader to IronWord so the project can drop DocumentFormat.OpenXml.
Write no code until I approve.
FormReader still reads supplier forms with the OpenXML SDK.
RegistrationCheck already uses IronWord, and the team wants a single DOCX library.
The plan has to cover these points:
- Every OpenXML SDK call, with its IronWord replacement and the file where the call lives.
- How the reader will find the price table.
- How it will find a registration number inside a table.
Keep SupplierForm and the public Read and SaveImages signatures unchanged.
Where something is unclear, state your assumption instead of asking.
Show me the plan when it's ready.
Plan üzerindeki hataları düzeltin. Ardından ya Derleme butonuna tıklayın ya da Ajan'a geri dönüp bu isteği gönderin.
@ironword-forms
Carry out the approved plan.
Check the forms output against TestData/forms/expected.csv before and after the move.
A printed row counts as a match when its supplier, registration, items and images columns agree.
Work through it in this order:
1. Run `dotnet run --project src/SupplierIntake -- forms TestData/forms` and count the matches.
2. Migrate FormReader to IronWord.
3. Remove the DocumentFormat.OpenXml package reference.
4. Run dotnet build, then run the forms command again.
Tell me the match count for the OpenXML version and for the IronWord version.
Then show me the diff.
@ironword-forms bahsi, kurala adınıla uygulamaktadır, Cursor onu globları aracılığıyla zaten çıkarmış olsa da.
Değişimin her birine hangi Cursor özelliği uyar?
Tab, editörde zaten görünen bir düzenlemeyi tamamlar ve satır içi düzenleme (Ctrl+K), tek bir cümlelik talimattan bir seçimi yeniden yazar. Birkaç dosya üzerindeki değişiklikler ya da bir derleme gerektiren değişiklikler Ajan'a gider. Yanlış bir değişikliğin geri alınmasının yazmaktan daha fazla çaba gerektirdiği Plan Modunu kullanın. Bir Bulut Ajanı, gözetimsiz çalışmalar için uygundur.
Yeni bir tedarikçi, iki fiyat dilimini birleştiren bir ürün hücresine sahip form-13'ü döndürür. FormReader içindeki fiyat satırları üzerinde yineleme yaparak döngüyü vurgulayın, Ctrl+Shift+L'ye (macOS'da Cmd+Shift+L) basarak vurgulanan kodu sohbet girişine ekleyin ve bu isteği Ajan'a gönderin.
Make FormReader.Read handle merged cells in the price rows:
- An Item cell that Word merged with the cell above comes back empty.
- For that row, reuse the item name from the previous row.
- Before you read a cell by its column position, check that the row has that many cells.
Then rerun the forms command over TestData/forms.
Tell me how many rows agree with expected.csv, which now lists 13 forms.
Satır uzunluğu kontrolü, diğer yönde birleşmeleri ele alır. Ayrı bir sonda dosyasında, sütunlar boyunca birleşmiş bir hücre, tek bir hücre olarak döndü, böylece o satır diğerlerine göre daha kısaydı.
Çıkarılan metinden eksik olan değerleri nasıl hata ayıklarsınız?
Depo ön kontrolü, ExtractText sonucuna bir düzenli ifade ile kayıt numarasını okur.
@src/SupplierIntake/Forms/RegistrationCheck.cs @TestData/forms/
Find out why the pre-check flags 9 of the 13 forms as missing a registration number.
FormReader finds one in all 13, and every number is visible in Word.
Before you edit anything, do these three things:
1. Run the check command on TestData/forms and on TestData/edge, and note what it flags.
2. Run the dump command on one flagged form.
3. Explain what the check reads that FormReader doesn't.
Then fix RegistrationCheck and keep it on IronWord.
Rerun the check on both folders.
Tell me how many forms it flags in TestData/forms and in TestData/edge, before and after the fix.
Dokuz hata iki nedene sahiptir. Beş formda, numarayı takip eden bir iletişim email paragrafı bulunmaktadır, bu nedenle ifade GB-0012345Contact'ı yakalar ve format kontrolü onu reddeder. Diğer dört form, numarayı bir şirket detayları tablosunda saklar, burada etiket hücresi Kayıt numarası'nı iki nokta olmadan okur ve değer bu hücrenin yanındaki hücrede bulunur. Paragrafları ayrı ayrı okumak ve etikete yanıt veren hücreden değeri almak her iki sorunu da çözer.
IronWord bir DOCX'in hangi parçalarını dışarıda bırakır?
IronWord 2026.10.4'e karşı yapılan denemelerimiz, kütüphanenin bir form okuyucusuna iade etmediği içeriği belirledi.
- Başlıklar: hiçbir okuma başlık metnini döndürmez ve
ExtractImagesbaşlık resimlerini dışarıda bırakır. Sayfa ayarı, başlığın yüksekliğini ortaya çıkarır, ancak içeriği hiçbirini göstermez. - İçerik kontrolleri ve metin kutuları: bunların metni, hem paragraflarda hem de çıkarılan metinde bulunmaz.
- İzlenen değişiklikler: okumalara izleme etkinleştirildiğinde eklenen metin dahil edilmez.
- Eski dosyalar: bir Word 97-2003 .doc dosyası yükleme sırasında "Dosya bozuk veri içeriyor" hatası verir.
- Boşluk öznitelikleri olmayan yerleşik resimler: yerleşik resimleri distT, distB, distL ve distR'ı hariç bırakan bir DOCX dosyası, yükleme sırasında InvalidOperationException ile başarısız olur. python-docx bu öznitelikleri dışarıda bırakır.
Yüzen resimler ve tablo hücrelerinin içindeki resimler, belge sırasına göre çıkarılır. Eğer tedarikçiler içerik kontrolleri ile yapılmış formları dolduruyorsa veya kayıt numarasını bir başlığı içeren bir dosya olarak yerleştiriyorsa, okuyucuya güvenmeden önce bu formları test edin.
Belge okuma için regresyon testlerini nasıl yazarsınız?
Bilinen bir listeyle karşılaştırılan değerlerle çıkarılan değerleri karşılaştırmalar, alım hizmeti çıktısını kontrol eder, okuyucunun içsel uygulamasından bağımsız olarak. Bir Bulut Ajanı, bunları kendi izole edilmiş VM'sinde yazabilir. İlk önce Cloud Agents gösterge tablosu içindeki gizli bilgilerin altında IRONWORD_LICENSE_KEY depolayın.
@tests/SupplierIntake.Tests/ @TestData/
Write xUnit tests for FormReader and RegistrationCheck.
Each of these needs a test:
- Every row of TestData/forms/expected.csv matches.
- In form-13, both price tiers keep the item name.
- SaveImages writes one PNG per picture, with the pixel sizes listed in the image_sizes column.
- RegistrationCheck passes every form and flags TestData/edge/no-registration.docx.
- Reading TestData/edge/legacy.doc throws a FormatException or a type derived from it.
Copy TestData into the test output and run dotnet test.
Tell me the passed and failed counts.
Eski dosya iddiası, IronWord'un özel tipine başvuramaz çünkü o içseldir. Bir FormatException'den türetilmiştir, bu nedenle türetilmiş tipleri kabul eden bir iddia, xUnit'teki Assert.ThrowsAny<FormatException> gibi, derlenir ve farklı bir hata atıldığında yine de başarısız olur.
Yapay Zeka kodlama asistanları kılavuzu, baştan uca yazılı geçiş kriterlerine karşı çalışan bir IronWord görevini içerir.
Gerçek bir çalıştırmada istemler ne üretti?
Yedi istem, tek bir sohbette sırayla Cursor'a gönderildi. Örnek depo, bir OpenXML SDK okuyucu, bir IronWord ön kontrol, boş bir xUnit projesi, bilinen değerlere sahip on iki form ve iki kenar dosyası tuttu.
- On iki formda OpenXML SDK okuyucu ve onun yerini alacak olan IronWord okuyucusu eşleşti.
- IronWord, uygulama ve testlerinde kalan tek DOCX paketi oldu.
- Form-13 eklendiğinde, okuyucu 13'ten 12'sini eşleştirdi ve ikinci fiyat diliminden ürün adını çıkardı.
- Birleştirilmiş hücre değişikliğinden sonra, okuyucu 13'ün 13'üyle eşleşti.
- Düzeltmeden önce ön kontrol 13 formdan 9'unu işaretledi ve düzeltmeden sonra ise hiçbirini. Kenar formunu her iki seferde de kayıt numarası olmadan işaretledi.
- Kaydedilen 21 resmin tümü listelenen piksel boyutlarına sahipti.
- Form-03 dökümü, iki tabloda 10 hücre ve 108'e 36 nokta ve 144'e 48 piksel bir resim listeliyordu.
- Dokümantasyonun ne söylediği sorulduğunda, Cursor herhangi bir dosyayı değiştirmeden yanıtladı.
- Altı test yönteminden 42 vakadan tümü, bir lisans anahtarıyla ve onsuz geçti.
- Nihai kodun kopyalarında, birleştirilmiş hücre işlemenin kaldırılması 2 durumu başarısız yaptı. Eski ön kontrolü geri getirmek 9'da başarısız oldu ve form başına bir resmi atlamak 13'ü başaramadı.
- Eski dosya testi, herhangi bir istisnayı kabul etti ve dosyanın silinmesiyle geçti. FormatException'a daraltıldığında, gerçek dosya ile geçti ve onsuz başarısız oldu.
- Cursor'un ilk IronWord okuyucusu satır dökümü eksikti ve CS1503 ile derleme hatasına düştü. Cursor, bir sonraki derlemesinden önce dökümü ekledi.
- Her Yayın derlemesi, 0 uyarı ve 0 hata içeriyordu, manuel düzenleme yapılmadan.
- Bazı adımlar sayfadan farklı çalıştı. Kural, satır dökümünden yoksundu. Birleştirilmiş hücre değiştirme isteği satır uzunluğu kontrolü istemedi ve Cursor hiçbirini eklemedi. Test isteği, sadece bir istisna atılmasını gerektiriyordu. İstemler, @ bahsini içerenler, masaüstü uygulamasına metin olarak yapıştırıldı. Plan Ajan'da onaylandı, ancak Derleme butonu ile değil. Bulut Ajanı istemi, bir VM olmadan, yerel olarak Ajan modunda çalıştı.
Claude Code kılavuzu, üretilen kodda her IronWord öğesini IronWord.xml'e karşı kontrol eden salt okunur bir yan ajan ekler. ChatGPT Codex kılavuzu, yazma tarafını kapsar ve bir Word belgesindeki metin değiştirmenin hangi kısımlarını değiştiğini ölçer.
çalıştırma kaydı, bu sonuçlar için IronWord paketi, modeli, süreyi ve test makinesini listeler.
Hata Ayıklama
- Çıkarılan metinden bir tablodaki bir değer eksik olduğunda DOCX'ten Metin Çıkarma
- Kaydedilen resimlerin boyutlarının veya formatlarının kontrol edilmesi gerekiyorsa DOCX'ten Resim Çıkarma
- Her iki paket de bir projede referans alındığında bir geçiş sırasında IronWord ile DocumentFormat.OpenXml
- Üretilen kod kaydetme zamanında bir lisanslama istisnası attığında Lisans Anahtarlarını Kullanma
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.