IronOCR ve Cursor Nasıl Kullanılır

Curtis Chau
Curtis Chau
Güncellendi: 9 Ekim 2026

Yapay zeka ajanının yazdığı çoğu IronOCR kodu doğru görünür ve genellikle çalışır. Bazı kısımları çalışmaz. Barkod toplama etkinleştirilmeden barkodları okuyan kod, barkod döndürmez. Almanca'yı dil olarak ayarlayıp Almanca dil paketi yüklenmemiş kod, bir LanguagePackException hatası atar. Model, eğitim verilerinden yazar, bu yüzden hızlıdır ve bu tür detayları yanlış anlar.

Cursor, VS Code kod tabanına dayanan bir yapay zeka kod editörüdür. Linkeden belgeleri okuyabilir ve deposuna eklenen kural dosyalarını uygulayabilir, böylece önerileri IronOCR'nin API'sine ve ekibinizin konvansiyonlarına uygun olur. IronOCR, yerel olarak metin, barkod ve tablo yapıları okuyan bir C# kütüphanesidir.

Her temizlik filtresi hem girdi üzerinde bir yöntem hem de bir filtre enum'unda bir değerdir ve sadece adı kodun hangisini kullanması gerektiğini söylemez. Bu, zayıf taramaları seçme, metin katmanları olmadan PDF'leri okuma veya tablo yapılarını koruma gibi kesin değişiklikler için en önemli olanıdır.

El yazısı kılavuzu ve fotoğraf okuma kılavuzunda el yazısını ve fotoğrafları IronOCR ile okuma ayrı ele alınmıştır.

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

PM > Install-Package IronOcr

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

C# projesi içinde, bu isteği gönderin.

@Program.cs Read https://ironsoftware.com/ocr/csharp/llms-full.txt first.

In this C# project, read TestData/skewed-scan.png twice, once untouched and once
with a single correction filter applied to the input, and print both confidence
scores exactly as IronOCR returns them so I can compare them. Read the license
key from the IRONOCR_LICENSE_KEY environment variable and never print it. Use
only members that appear in the documentation.
Text

Lisans anahtarı kılavuzu, anahtarı uygulamanın her yolunu gösterir.



OCR çalışması 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ı.

OCR çalışması genellikle filt ekleme, yeniden yapılandırma ve örnekleri yeniden okuma şeklinde kısa döngülerden oluşur ve hızlı bir model bunlarla iyi başa çıkar. Üretim taramalarının bir grubu açık bir sebep olmadan yanlış alanlar döndürdüğünde, daha uzun süre düşünen bir modelle değiştirin.

IronOCR belgelerini Cursor'a nasıl verirsiniz?

LLM'ler için tam metin dosyası 145 dokümantasyon sayfasını bir URL'de özetler. Ekim 2026 itibariyle, Cursor'un @ menüsü dosyalar, klasörler, terminaller, sohbetler, Git-farkları ve tarayıcı ekler, böylece IronOCR belgeleri ajan için bir bağlantı olarak ulaşır.

Read https://ironsoftware.com/ocr/csharp/llms-full.txt

How do I read a scanned PDF and save a searchable copy, and how do I straighten
a slightly rotated page before reading it? Show the exact class and member names
from the documentation, and link the page you took them from.
Text

IronOCR konvansiyonlarınızı kodlayan proje kuralları nasıl yazılır?

Proje kuralları depo kökünde .cursor/rules klasöründe tutulur. Kodla birlikte taahhüt edildikleri için, deponun her kopyası aynı seti alır.

Kurallar Markdown ve YAML frontmatter ile yazılmış .mdc dosyalarıdır. Alt klasörler de okunur. Cursor bu klasörde düz bir Markdown dosyasını yok sayar, çünkü dosyada ne zaman uygulanacağını belirtecek bir frontmatter yoktur. Bir IronOCR kuralı içerebilecek olan budur.

---
description: IronOCR conventions for scan reading in this project
globs: Imports/**/*.cs, Capture/**/*.cs
alwaysApply: false
---

# IronOCR conventions

- Use IronOCR for all OCR work. The NuGet package is IronOcr on Windows and
  IronOcr.Linux on Linux and Docker. The namespace is IronOcr. Do not add
  another OCR engine or a cloud OCR service.
- Documentation: https://ironsoftware.com/ocr/csharp/llms-full.txt
- Skill file with recipes: https://ironsoftware.com/ocr/csharp/skill.md
- Target the IronOcr version pinned in Directory.Packages.props. Do not upgrade
  it as part of an unrelated change.
- Never inline a license key. Read it from configuration or the
  IRONOCR_LICENSE_KEY environment variable.
- Dispose OcrInput with a using block.
- Any language other than English needs its IronOcr.Languages package first.
  Language packs keep their own version numbers, so pin the newest one on NuGet.
- Do not invent IronOCR API names. If a member is uncertain, say so and cite
  the documentation instead of guessing.
Markdown

Globs'u dikkatli seçin. Her zaman uygulanan bir kural her sohbet oturumuna eklenir ve ekstra bağlam kullanır, bu yüzden IronOCR kuralını OCR kodunu tutan klasörlere yönlendirin.

Lütfen dikkat: Cursor ayrıca bir kök AGENTS.md da okur. Frontmatter'ı yoktur ve dolayısıyla globs'u yoktur, bu yüzden kök dosya tüm depoya uygulanır. Talimatlarını kapsamak için, kapsaması gereken alt dizine başka bir tane ekleyin.

Kurallar Aracı isteklerine uygulanır. Cursor'un dokümantasyonuna göre, bunlar Sekme tamamlamayı etkilemez ve kullanıcı kuralları satır içi düzenlemelere uygulanmaz. Bu özelliklerden gelen önerileri kendiniz kurala karşı kontrol edin.

Tesseract ayarlarını IronOCR'ye nasıl eşlersiniz?

Tesseract komut satırlarını IronOCR kodundan daha iyi bilen bir model, IronOCR ayarının yerine bir Tesseract bayrağı veya değişken adı yazabilir.

TesseractIronOCR
--psm 7Configuration.PageSegmentationMode = TesseractPageSegmentationMode.SingleLine
--oem 1Ayar yok. LSTM tek motordur
-c tessedit_char_whitelist=...Configuration.WhiteListCharacters
Diğer -c değişkenleriConfiguration.TesseractVariables
-l eng+deuAddSecondaryLanguage(OcrLanguage.German)
--tessdata-dir, TESSDATA_PREFIXBir .traineddata dosyası için UseCustomTesseractLanguageFile, .ocrdata dosyalarının bulunduğu bir klasör için Installation.LanguagePackDirectory

IronOCR'nin filtre sihirbazının da aynı özen gerektirir. Filtre kombinasyonlarını test eder ve en iyi olanı C# kodu olarak döndürür, ancak bu kod bir dosya yolundan girdiyi inşa eder ve derleyici bunu eski olarak işaretler. Sihirbaz aynı zamanda yavaştır. Test makinemizde 200 DPI bir sayfa neredeyse dokuz dakika sürdü, bu yüzden tek bir sayfada çalıştırın.

Kuralda iki daha fazla giriş her iki durumu da kapsar.

- Configure Tesseract through IronTesseract.Configuration properties, never raw
  tessedit_* variables or command-line flags. Use TesseractVariables only for a
  setting with no named property.
- Rewrite OcrInputFilterWizard output from new OcrInput(path) to new OcrInput()
  with LoadImage or LoadPdf before it reaches the codebase.
Markdown

Değişime hangi mod uyar?

Cursor değişiklik yapmak için beş yol sağlar. Özelliği işin boyutuna uyarlayın.

ÖzellikKullanırkenOCR örneği
SekmeSonraki düzenleme tahmin edilebilirBir filtre seçeneğini tekrarlama
Satır içi düzenlemeBir dosya, bir cümleTektaraflı bir okuyucuya bir filtre
AjanÇeşitli dosyalar ve bir yapım döngüsüBir okuyucu ve onu yazan iş
Plan ModuSonradan gözden geçirmek için çok büyükTesseract'tan taşınmak
Bulut AjanıGözetimsiz çalışmaBilinen sayfa testleri

Satır içi bir düzenleme için, ilgili satırları seçin, Ctrl+K'ye (macOS'ta Cmd+K) basın ve değişikliği açıklayın. Barkodlar teslimat notunda bir Ajan değişikliği.

@Imports/DeliveryNotes.cs @Imports/ImportJob.cs Read https://ironsoftware.com/ocr/csharp/skill.md first.

Also return every barcode and QR code on each delivery note, and have the notes
command print each one's format and value.
Text

Barkodlar yalnızca Configuration.ReadBarCodes okunmadan önce ayarlandığında toplanır. Metinle aynı sonuçta geri dönerler, bu yüzden bir okuma her ikisini de kapsar. Beceriler dosyası o ayarı gösterir.

Bir @ mention isteğe ne ekler?

Gerçek okuyucu dosyasına referans vermek, özetleri kullanmaktan tercih edilir, çünkü özetler önemli detayları atlayabilir.

@Imports/InvoiceReader.cs @TestData/warehouse/

InvoiceReader reads every scan in TestData/warehouse/ without an error, but about
a third of the totals have one wrong digit. Fix the input preparation, not the
parsing. Explain which setting caused it, and report how many totals match
expected.csv before and after.
Text

Hangi dosyaların ilgili olduğundan emin değilseniz, bahsetmeyi çıkarın ve Ajan kod tabanını kendisi arayacaktır.

Bağlamınıza örnek taramalar da ekleyin. Gerçek dosyaları filtrelerden geçirerek hangi kombinasyonun onları düzelttiğini gösterir. Depomuzdaki set için, yalnızca Deskew 9 üzerinden 5'ini ve yalnızca DeNoise 2'sini okudu. Düzeltme her ikisini, o sırada gerektiriyordu. Görüntü yönlendirme düzeltme kılavuzu ve görüntü kalitesi düzeltme kılavuzu, ilgili filtreleri kapsar.

IronOCR'ye geçişi nasıl planlayıp yaparsınız?

Plan Modu'na geçin ve bu isteği gönderin.

@Imports/ScanOcrService.cs

ScanOcrService reads scans with the Tesseract NuGet package. Plan a migration of
it to IronOCR.

List every read it performs, with the settings it uses (language, page
segmentation, preprocessing, region, output format), map each one to its IronOCR
equivalent, and name the files that change. Keep existing public method
signatures so callers don't change. If anything is ambiguous, choose and state
your assumption, and do not ask. Don't write code yet.
Text

Sonra Build'e tıklayın veya aşağıdaki isteği Ajan'da gönderin.

@Imports/ Implement the approved plan. Then run dotnet build, fix what breaks, confirm
every page in TestData/known/ still returns its expected values, and show me the
diff. Don't add new packages beyond IronOcr and any language packs the plan names.
Text

Bulut Ajanı, önceki adıyla Arka Plan Ajanı, ücretli bir plan gerektirir, bulut VM'de çalışır ve kodunuza çalışmak için bağlı bir depo gerektirir. Başlamadan önce, Bulut Ajanları panosuna IRONOCR_LICENSE_KEY bir gizli anahtar olarak ekleyin. Geçiş birleştirildikten sonra testlere başlayın.

@Imports/ @TestData/ Write xUnit tests for the migrated OCR service in a
tests/Imports.Tests project that Imports.csproj does not compile. Every page in
TestData/known/ returns its expected invoice number and total, a page without a
total returns null, DeliveryNotes returns the codes in TestData/notes/expected.csv,
and a read with OcrLanguage.French, whose language pack is not installed,
produces a clear error. The tests read the license key from IRONOCR_LICENSE_KEY
and never print it. Assert on extracted fields, never on full page text. Run
dotnet test and fix what fails.
Text

Yapay zeka kodlama yardımcıları kılavuzu, tanımlı geçme kriterleriyle tam bir görevi yürütür.

Yanlış veya eksik OCR değerlerini nasıl hata ayıklarsınız?

@Imports/InvoiceReader.cs @Imports/DeliveryNotes.cs @TestData/returns/

Returned-goods invoices come back with a wrong digit in the total, and delivery
notes return no barcodes even though every note has one. Explain the cause of
each before changing anything, then fix both.
Text

Bir konteynırın istisnası Cursor terminalindeyse, aşağıdaki isteğe @Terminals de ekleyin.

@Dockerfile @Imports.csproj Read https://ironsoftware.com/ocr/csharp/skill.md first.

Reads work on Windows but fail when this app runs in our Linux container. Check
which IronOCR package the project references, whether the container image has
the native dependencies IronOCR needs, and whether the license key reaches the
container. Explain the cause, then propose the change. Don't modify C# code
unless the cause is there.
Text

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

Dokuz istem Cursor'a sırayla, örnek bir ithalat uygulamasına karşı gitti. Merkezi paket yönetimi, IronOCR fatura ve teslimat notu okuyucuları, Tesseract kaplaması üzerinde bir tarama hizmeti ve bilinen değerlere sahip taramalarla konsol projesidir. Lisans anahtarı sadece editörün ortamında ayarlandı. Çalıştırmadan sonra, her taahhüdün yeni Release yapımları her test klasörünü tekrar okudu ve aşağıdaki figürleri yeniden üretti.

  • Depo faturası toplamları düzeltmeden önce 9 üzerinden 6'dan düzeltmeden sonra 9 üzerinden 9'a çıktı.
  • Teslimat notu barkodları düzeltmeden önce gelmedi. Düzeltmeden sonra, 8 üzerinden 8 notunun kodları vardı ve fazladan yoktu.
  • İade edilen mallar dalında, fatura toplamları 6 üzerinden 4'ten 6 üzerinden 6'ya ve not barkodları hiç yokken 6 üzerinden 6'ya yükseldi.
  • Eğik taramalar değişmeden 87,79 güven ile okundu ve Deskew sonrası 96,41 ile okundu.
  • Geçişten sonra bilinen sayfalar hala 10 üzerinden 10 okundu ve Almanca toplamlar öncesi gibi 3 üzerinde 3 kaldı.
  • xUnit seti, 20 üzerinden 20 testi geçti.
  • Her Serbest sürüm derlemesinde 0 hata vardı ve elle düzenleme gerekmedi. Geçiş, eski EngineMode ayarını gerçekleştirdi ve iki CS0618 uyarısı bıraktı.
  • Konteynır yanıtı IronOcr.Linux adını, Docker kılavuzunun apt paketlerini ve eksik anahtarı ve hiç bir C# dosyasını değiştirmedi.
  • Bazı adımlar bu sayfadan farklıydı. İstemler el ile masaüstü uygulamasında gönderildi, plan bir sonraki istemi Build'e hiç tıklamadan göndererek onaylandı ve Bulut Ajanı istemi yerel olarak çalıştı. Sekizinci istem yanlışlıkla önceki sohbete gitti ve resetlenip yeniden gönderildi. Makinede Docker olmadığında, konteynır istemi açıklama ve öneri açısından değerlendirildi.

Çalıştırma kaydı, diğerleri yanında bu kılavuz için sürümleri, zamanlamayı ve test makinesini listeler.


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 6,394,824Sürüm:2026.11yeni çıktı