AI Kodlama Asistanları ile IronOCR Kullanımı
IronOCR, .NET için ticari bir OCR kütüphanesidir ve altı milyondan fazla NuGet indirmesi vardır. Eğitim verilerinde genellikle gördükleri için kılavuzları, nasıl yapılır rehberleri ve sorun giderme notları yıllardır herkese açıktır.
Bu aşinalık, projenizin hangi sürüme sabitleneceğine kadar uzanmaz. IronOCR'un belgelerini okuyan bir asistan, OCR kodu yazarken daha doğru metin döndüren bir yapı oluşturabilir. Belgeleri ilk isteğinizden önce paylaşın.
Bu araçlar, sonuçları incelemeden önce ne kadar işlem yaptıklarına göre farklılaşan iki kategoriye ayrılır.
- Bir asistan, iş akışınızın bir kısmında çalışır. GitHub Copilot'un satır içi önerileri gibi bir satırı tamamlar, bir yöntemi açıklar veya küçük bir düzenleme yapar.
- Bir ajan, çok adımlı bir görevi üstlenir, dosyalar arasında düzenleme yapar, yapıyı çalıştırır, testleri yürütür ve inceleme için sonucu işlemeyi tamamlar, Claude Code, ChatGPT Codex, Cursor ve Google Antigravity gibi.
Kurulum her ikisi için de aynıdır. Paketin kurulumunu yapın, bir ortam değişkeninden lisans anahtarını uygulayın, IronOCR'un makine tarafından okunabilir belgesini sağlayın ve önceden bildiğiniz metni karşılaştırarak her çıkarılan değeri kontrol edin. Bu, görüntüler ve taralı PDF'ler için geçerlidir ve bir taramanın aranabilir hale getirilmesi, birden çok dil okuma, aynı okumadan barkod çıkarma veya düşük kaliteli bir taramanın iyileştirilmesi dahil.
Bir AI Kodlama Asistanı veya Ajanı ile IronOCR Nasıl Kullanılır
- C# OCR kütüphanesini NuGet'ten indirin
- İlk okumadan önce lisans anahtarını bir ortam değişkeninden yükleyin
- Asistana, herhangi bir kod yazmadan önce IronOCR'un
llms.txtdizinini verin - Asistanın proje talimatlarını sakladığı her yere IronOCR kurallarını kaydedin
- Aşağıdaki tek seferlik kurulum istemiyle yeni bir oturuma başlayın
- Derleyin, sonra IronOCR'un çıktısını her bir örnek sayfada beklediğiniz değerlere karşı kontrol edin
Yapay Zeka Asistanım OCR'ı Kendi Başına Halledemiyor mu?
Belgeler olmadan, bir asistan, genellikle ham Tesseract sarmalayıcılarından veya önceki bir IronOCR sürümünden ayarların karıştığı eğitim sırasında edindiği OCR koduna dayanır.
IronOCR, araçlar için okumaya yönelik belgeler yayımlar, kılavuzlar, uygulama rehberleri ve elliden fazla sorun giderme makalesi içerir. Asistan bunu yükledikten sonra, belgeler IronTesseract, OcrInput ve OcrResult bir arada nasıl çalıştıklarını gösterir.
Motor seçimi hala önemlidir. Ücretsiz Tesseract sarmalayıcıları İngilizce'nin düzgün, yansız bir sayfasını iyi yönetir.
- Okunabilir çıktı doğru çıktıyı garanti etmez: bir OCR sonucu akıcı bir şekilde okuyabilir ve yine de 589,50'yi 580,50 yapabilir.
OcrResult, bakılacak yeri göstermek için her kelime için bir güven puanı rapor eder. - Taramalar hazırlık gerektirir: eğri, gürültülü veya düşük çözünürlüklü sayfalar herhangi bir motorda zayıf okunur.
OcrInput, bir sayfayı düzleştiren, gürültüyü gideren, çözünürlüğü artıran ve daha fazlasını taşıyan filtreler taşır. - Bir motoru elle ayarlamak maliyetlidir: bir asistanın ham Tesseract ayarlarına yaptığı her deneme, kütüphanenin zaten yaptığı çalışmalarda jeton harcar ve bu maliyet her yeni belge türüyle tekrarlanır.
- Paket platforma bağlıdır:
IronOcrWindows'ı kapsar,IronOcr.MacOsIntel Mac'leri kapsar veIronOcr.MacOs.ARMApple silicon'u kapsar. Bir asistan ayrıca muhtemel bir paket adı icat edebilir, ve saldırganlar bu tür isimleri kötü amaçlı kodla birlikte kaydeder, bu uygulama slopsquatting olarak adlandırılır. İstemde paketin adını belirtin. - Lisanslama öngörülebilirdir: bulut OCR hizmetleri genellikle sayfa başına veya çağrı başına fatura keser ve bir asistan bu terimlerden kendiliğinden bahsetmeyecektir. IronOCR, geliştiriciler, konumlar ve projelere göre katmanlı fiyatlandırılan, sayfa başına ölçüm yapılmayan süresiz ticari bir lisans altında yerel çalışır.
Adım 1: IronOCR'u Yükleyin
Paket referansı mevcut olduğunda, asistan IronOCR'un gerçek türlerini, kod üretirken görebilir.
Install the IronOcr NuGet package into this project and confirm it restores.
gelişmiş NuGet yükleme kılavuzu diğer yükleme seçeneklerini listeler.
Adım 2: Lisans Anahtarınızı Uygulayın
IronOCR'un lisanssız bir şekilde kullanılan su damgası yoktur. Bir IronTesseract anahtarı olmadan oluşturmak başarısız olmaz, ancak ilk okuma IronSoftware.Exceptions.LicensingException ile "Üretim Lisansı Gereklidir" mesajıyla döner. Mevcut ama yanlış yazılmış bir anahtar, aynı çağrıdan "Lisans Anahtarı Tanınmadı" üretir. Aşağıdan ücretsiz bir deneme anahtarı alabilirsiniz.
IronOCR'u projenizde kullanmaya bugün ücretsiz deneme sürümüyle başlayın.
Uygulama başlangıcında, başka herhangi bir IronOCR çağrısından önce IronOcr.License.LicenseKey ayarlayın ve IRONOCR_LICENSE_KEY ortam değişkeninden okuyarak kaynak kontrolüne girmemesini sağlayın. Aynı sınıfın ayrıca bir anahtar dizesini uygulamadan test eden bir yöntemi vardır.
Web.config ve appsettings.json dahil.Adım 3: IronOCR'un LLM Belgelerine Asistanınızı Yönlendirin
llms.txtindekstir, sayfa başına bir satır.- 145 sayfanın özetleri
llms-full.txt'dan tek bir alımda gelir. llms-full-catalog.txtblogu indekse ekler.- API Referansı, her tür ve üyeyi belgelendirir.
- Kurulum, lisanslama, tarifler ve düzeltmeler
skill.md'da bulunur. - AI Ürün Bilgi Formu kapsamı, platformları ve sınırları özetler.
Bir görev bir kılavuzun ayrıntısına bağlı olduğunda, asistanın o kılavuzun sayfasını açmasını sağlayın.
Dizinle birlikte doğrudan bir talimat verin.
Before writing any IronOCR code, read https://ironsoftware.com/ocr/csharp/llms.txt
and use only APIs documented there. A read is assembled on an OcrInput, whose
Load overloads differ by source type, and run through IronTesseract.Read.
Confirm the overload you pick against
https://ironsoftware.com/ocr/csharp/object-reference/api/, and if you cannot find
it, say so instead of guessing.
Adım 4: Projenize IronOCR Bağlamı Ekleyin
Ekibinizde zaten hangi dosyada bulunuyorsa IronOCR kurallarını oraya yerleştirin. Claude Code CLAUDE.md okur, GitHub Copilot .github/copilot-instructions.md okur, ve ChatGPT Codex ile Google Antigravity AGENTS.md okur. Cursor .cursor/rules/*.mdc veya AGENTS.md okur, ve sadece onun kural dosyasında MDC önbilgilerine ihtiyaç vardır. Aşağıdakini başlangıç noktası olarak kullanın.
## OCR with IronOCR
This project uses IronOCR (NuGet package `IronOcr`, or `IronOcr.Linux` for Linux and Docker, namespace `IronOcr`) for all OCR work.
- Reference: https://ironsoftware.com/ocr/csharp/llms.txt
- Skill file: https://ironsoftware.com/ocr/csharp/skill.md
- Read with `IronTesseract` and an `OcrInput` inside a `using` block, and use the `OcrResult` it returns.
- Read the license key from the IRONOCR_LICENSE_KEY environment variable at startup. Never inline it.
- Every OCR change must be tested against sample pages whose text is known, reporting the values read and their confidence.
- Do not add another OCR engine or a cloud OCR service. If IronOCR cannot do something, say so.
Beceri dosyasının tek dosya örneği hala nuget 2026.10.2 sunulurken IronOcr 2026.7.2’ye işaret ediyor. Aynı zamanda dil paketlerinin takip edemeyeceğini, çünkü IronOcr.Languages.German 2020.11.2 olarak yayımlandığını belirtiyor. Bizim testlerimizde, sadece resim içeren taranmış PDF'lerde çalıştırılan tek satırlık ConvertToSearchablePdf hataya neden oluyordu, PDF'yi yükleme, okuma ve sonuç üzerinde SaveAsSearchablePdf çağrısı iyi çalışırken.
5. Adım: Anında Kurulum Komutu
- Adımdan 4. Adıma kadar her şey tek bir mesajda gönderilebilir.
Use IronOCR for all OCR work in this project.
1. Install the IronOcr NuGet package (IronOcr.Linux when the app runs on Linux or Docker).
2. Apply the license key at application startup, before any other IronOCR call,
reading it from the IRONOCR_LICENSE_KEY environment variable. Never write
the key into source or into a committed file.
3. Read https://ironsoftware.com/ocr/csharp/llms.txt before writing OCR code
and work only from APIs documented there, checking the API reference when a
member is unfamiliar.
4. Load https://ironsoftware.com/ocr/csharp/skill.md if your tooling supports skill files.
5. Keep these instructions for future sessions in this project.
6. Adım: Çalışan Kod Üreten Talimat Desenleri
Zayıf sonuçlar genellikle asistana tahmin yapma alanı bırakan bir istemden gelir.
Girdi, alanlar ve dili adlandırın.
Belirsiz Faturaları IronOCR ile okuyun.
Daha İyi Her taranmış PDF'yi yükleyen bir OcrInput ile IronTesseract kullanarak, fatura numarasını ve Toplam ödenecek ile başlayan satırı okuyun ve bu satırın güvenoyunu ile miktarı döndürün.
Sürümü ve çerçeveyi de belirtin.
Daha İyi IronOcr 2026.9.4 ile .NET 9’a hedefle.
Tüm dosyayı isteyin.
Daha İyi Derleme yapmadan ve düzenlemeden hazır bir şekilde tüm Program.cs’yi, direktifler ve lisans kurulumları dahil, geri verin.
7. Adım: Geri Aldığınız Şeyi Doğrulayın
Bu yaygın hatalara dikkat edin.
- Metin içeren bir PDF'de OCR: gerçek bir metin katmanının çıkartılması, sayfalar üzerinde OCR çalıştırmaktan daha hızlı ve daha doğrudur. Önce bir metin katmanı olup olmadığını kontrol edin ve yalnızca taranmış sayfalarda OCR çalıştırın.
- Birden fazla filtre aynı anda: temiz bir sayfa üzerinde bir düzeltmenin diğerine eklenmesi doğruluğu düşürebilir ve her zaman zaman ekler. Testlerimizdeki yoğun bir fatura setinde,
DeNoise, döndürülmüş bir fatura numarasının son 1’ini 4’e çevirdi veDilateeklemek o sayfayı düzeltti ancak diğer setlerin bir ila üç satırı maliyetle gitti. Yalnızca gördüğünüz hatayı düzelten filtreyi uygulayın. IronOCR'un beceri dosyası aynı tavsiyeyi verir ve görüntü kalitesi düzeltme kılavuzu hangi filtrenin ne zaman uygulanacağını açıklar.
Ajanın Kendi Çalışmasını Doğrulamasına İzin Verin
Build and run this project in Release. Confirm that every IronOCR member you used
appears in the documentation, that IronOcr.License.IsLicensed returns true, and
that every sample page reads back with the values it is known to contain.
Report the build result and a table of page, expected value, value read, confidence, and match.
Başka Diller Nasıl Okunur?
İngilizce, IronOcr paketindeki tek dildir. IronOCR'un dil listesi 125'i kapsar. Asistana bu bilgileri verin.
- Başka bir dil,
IronOcr.Languages.Germangibi kendi paketine ihtiyaç duyar, sonraLanguage = OcrLanguage.German. - NuGet erişimi olmadan,
.ocrdatadosyasını veInstallation.LanguagePackDirectorykullanılır. OcrLanguage.GermanFastgibi Hızlı ve En İyi varyantları aynı pakette gönderilir.- Birden çok dilde bir sayfa için, en yaygın olanı önce çağırarak
AddSecondaryLanguagekullanın. - Finansal tablolar
OcrLanguage.Financial'denIronOcr.Languages.Financialalır. - Başka yerde eğitilen bir model
UseCustomTesseractLanguageFileile.traineddatadosyasıyla yüklenir.
Eksik bir paket, ilk okumada LanguagePackException yükseltir. Mesaj, tam NuGet paketini ve .ocrdata alternatifini adlarıyla belirtir, bu yüzden asistanın mesajın belirttiği şeyi yüklemesini sağlayın.
IronOCR'un hızlı yapılandırma kılavuzu, barkod okumayı kapatmakla birleştirildiğinde EnglishFast'dan %17’lik bir kazanç bildirmektedir. On sayfamız üzerinde bu varyant yalnızca İngilizce’nin koşu-öncesi düzeyselliği içinde kaldı, bu yüzden hız için doğruluğu değiştirmeden önce kendi sayfalarınızda varyantları zamanlayın.
ClickOnce yayımlama, ikincil dillerin .ocrdata dosyalarını atlar, ClickOnce notu açıklamaktadır. Windows'ta, EnglishFast'yi ikincil bir dil olarak eklemek, 2025.12.3 ile 2026.7.2 arasında büyük PDF'lerde tıkanabilir, bu sorun giderme girişi kaydediyor.
Hangi IronOCR Ayarları Varsayılan Olarak Açıktır?
Üretilen kod genellikle zaten varsayılan olan değerleri ayarlar veya varsayılan olarak kapalı olan bir ayarı kaçırır. Bunlar, IronOcr 2026.9.4'teki başlangıç değerleridir, yeni bir IronTesseract'dan okunur.
| Ayar | Default | Değiştirin |
|---|---|---|
Language | İngilizce | Diğer diller |
Configuration.ReadBarCodes | kapalı | Barkodlar |
Configuration.ReadDataTables | kapalı | Tablo yapısı |
Configuration.RenderSearchablePdf | açık | Aranabilir çıktıyı atlama |
Configuration.RenderHocr | kapalı | hOCR çıktısı |
Configuration.PageSegmentationMode | AutoOsd | Tek satır veya tek kelime kırpmaları |
Configuration.EngineMode | LstmOnly | Nadiren |
Configuration.WhiteListCharacters ve BlackListCharacters | boş | Dar karakter setleri |
Configuration.TesseractVariables | üç önceden ayarlanmış giriş | Ham Tesseract değişkenleri |
MultiThreaded | açık | Nadiren |
MaxDegreeOfParallelism | Environment.ProcessorCount | Bellek yetersiz büyük partiler |
OcrInput.TargetDPI | 0 | Düşük çözünürlüklü taramalar |
Standart okumanın ötesinde, IronTesseract diğer girişler için ayarlanmış okuma cihazları sağlar. ReadPhoto belgelerin fotoğraflarını işler ve ReadScreenShot ekran görüntülerini işler. özelleştirilmiş belgeler kılavuzu, yine de bunlar için IronOcr.Extensions.AdvancedScan listeler, ancak bu paket son olarak 2025'te gönderildi ve okuyucuların hiçbiri buna ihtiyaç duymadı. Aynı kılavuz ayrıca pasaport ve plaka okuyucuları da kapsar.
Yenileyebileceğiniz Bir Sonuç
İstem
Build a .NET 9 console app that reads totals from scanned invoices. Start in an empty folder; if it already holds code or project files, stop and report. Work start to finish alone: write, build, run, and fix, making sensible assumptions where anything is unspecified. Save every deliverable under the project root, in the folders named below.
1. Install the IronOcr NuGet package pinned to version 2026.9.4.
2. Read https://ironsoftware.com/ocr/csharp/llms.txt and the pages it links to, and use only IronOCR APIs documented there for the OCR work. Any .NET imaging library may draw the test images.
3. Read the license key from the IRONOCR_LICENSE_KEY environment variable at startup and never write it into source or any output file. If IronOcr.License.IsLicensed is false, stop and report that.
4. With random seed 2026, generate testset/invoice-01.png to invoice-10.png. Each is a US Letter page of exactly 1700 x 2200 pixels, saved as PNG with 200 DPI in the file metadata, with all text in Arial inside 0.75 inch margins, headings at 14 point bold and everything else at 11 point. Each invoice has an invoice number made of INV- and six random digits, a customer name, three line items with random prices in dollars and cents, and a total equal to their sum, with no two totals alike.
5. Rotate invoice-02 and invoice-07 by 3 degrees about the page center, keeping the 1700 x 2200 canvas. Add speckle noise to invoice-04 and invoice-09: dark square specks 1 or 2 pixels wide, placed anywhere including over the text, until they have darkened 1% of the page's pixels, counting a pixel as dark below 128 of 255. Leave the other six clean. Write manifest.csv with each file, invoice number, the three prices, total, and distortion (none, rotated, or speckled).
6. Before the first OCR call, check every saved image: 1700 x 2200 pixels, 200 DPI when rounded, and, measured on each page before distortion, the smallest distance from any ink to an edge, at least 0.75 inch. On each speckled page, check that speckling raised the share of dark pixels by 0.9 to 1.1 percentage points. Also draw a capital H with the 11 point font on a 200 DPI bitmap and check that its ink is 21 to 23 pixels tall. If a check fails, fix the generator. After the first OCR call, never regenerate or change the saved image files; filters applied in memory are expected.
7. Read all 10 images in one OcrInput with one set of filters for every page. Each run of the program uses one filter set; it must not try several or choose between them, and choosing filters is your job between runs. No manifest value, file name, or expected value may steer the OCR or the parsing of its text; read the manifest only to write roundtrip.md. The reader must hold no invoice number, price, or total as a literal and must run the same code for every page. Extract each page's invoice number and total, save each page's OCR text as ocr/invoice-01.txt to invoice-10.txt, and save the result as invoices-searchable.pdf.
8. Build in Release and run.
9. Write roundtrip.md: the step 6 checks as measured numbers for every image, not pass or fail words, the filter set used, then a table of file, distortion, expected invoice number, invoice number read, expected total, total read, the Confidence (0 to 100) of the OCR line holding the total or n/a, and match, then the page count of invoices-searchable.pdf loaded back with OcrInput. A row matches only when the invoice number read is identical to the expected one and the total read equals the expected total to the cent.
10. All 10 rows must match and the PDF must have 10 pages. If not, read the saved OCR text of the failing pages, change the filter set or the reader, rebuild, and run again. If rows still fail after eight such runs, stop and report which rows failed, the filter sets tried, and why.
11. Finish with a short report: build result, match count, filters used, font sizes used, and assumptions made.
Çıktı
Bu, çalıştırma sırasında, baskı alanına kırpılmış iki benekli sayfadan biri olan fatura-09'dur. Düz bir okuma, 10 faturadan 8'iyle eşleşti ve her iki benekli sayfayı kaçırdı, bu faturanın fatura numarasını ANV-938066 olarak döndürdü ve tek başına Deskew daha iyi yapmadı. DeNoise eklendiğinde, IronOCR INV-939066 ve 1731.53'ü döndürdü, toplam satırında 41.45 güvenmeile çalışmanın en düşük değeri. Diğer benekli toplam satır 63.86, temiz sayfalar ise yaklaşık 95 olarak okundu. Claude Code ilk taslakta bu iki filtreyi seçti ve programın beş koşusunda da tuttu.
- Bağımsız bir kontrol her gereksinimi tekrar ölçtü ve tüm 10 fatura eşleşti.
- ChatGPT Codex ile GPT-6 Luna aynı istemde 10 üzerinden 10 eşleşti.
roundtrip.mddüzenlenmeden yayımlandı ve
olarak küçültülmüş boyutta.
Geçen şeyler
- Kodunuzdan düzenleme gerekmedi.
- Herhangi bir resmi açmak, kenarlarda hiçbir şey kesilmeden küçük metin gösterir ve metnin yanı sıra kenarlarda benekler vardır.
roundtrip.md'daki her fatura numarası ve toplam, o sayfanın kaydedilmiş OCR metninde de görünür.
Çalıştırma kaydı
- Makine Windows 11 x64'te, 64 GB bellekli bir Core i9-14900KF'de çalışır.
- Her proje .NET 9'u hedefler.
- Bu kılavuz, Copilot ve Cursor
IronOcr2026.9.4 çalıştırdı, Claude Code, Codex ve Antigravity ise 2026.10.2 çalıştırdı. CopilotIronOcr.Linux2026.9.4 ekledi ve Codex, Cursor ve AntigravityIronOcr.Languages.German2020.11.2 ekledi. - Son test 8 Ekim 2026, Cursor koşusu ile yapıldı. Diğer tüm koşular 6 Ekim tarihli.
| Kılavuz | Asistan ve versiyon | Model | Süre (dakika) |
|---|---|---|---|
| Bu kılavuz | Claude Code 2.1.277, izin istekleri kapalı | Claude Opus 5 | 20.8 |
| Claude Code | Claude Code 2.1.277 | Claude Sonnet 5 | 9.4 |
| ChatGPT Codex | Codex CLI 0.160.0 | GPT-6 Luna | 27.7 |
| GitHub Copilot | VS Code 1.140'da Copilot ajan modu | GPT-6 Luna, Auto ile yönlendirilen | 22.0 |
| Cursor | Cursor 3.23.23 masaüstü uygulaması | Grok 4.7 | 83.5 |
| Google Antigravity | Antigravity CLI 1.3.0 | Gemini 3.8 Flash (Yüksek) | 32.7 |
Ajan'a Özgü Kılavuzlar
Bir araca uygun adımlar için kılavuzunu açın.
- Claude Code ile IronOCR Kullanımı
- ChatGPT Codex ile IronOCR Kullanımı
- GitHub Copilot ile IronOCR Kullanımı
- Cursor ile IronOCR Kullanımı
- Google Antigravity ile IronOCR Kullanımı
Hata Ayıklama
- IronOCR'da Lisans Anahtarı Uygulama
- Tanınan metin sayfa ile eşleşmiyorsa OCR Doğruluğunu Artırma
- Dağıtımdan sonra hatalar görünüyorsa Genel OCR Sorun Giderme
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.