IronOCR ve GitHub Copilot Nasıl Kullanılır
.NET takımları, belge yakalama, alacak hesapları, talep işleme veya kayıt yönetimi için mevcut Visual Studio çözümleri ile, GitHub Copilot'u değerlendirmek için editör değiştirmeleri gerekmez, çünkü mevcut iş akışlarını destekler.
Copilot, Visual Studio, VS Code, JetBrains IDE'leri ve GitHub.com'da çalışır. IronOCR tanımayı .NET içinde yerel olarak işler.
Fotoğraflar ve el yazısı için IronOCR modelleri hakkında ayrıntılar için, fotoğraf okuma kılavuzuna ve el yazısı kılavuzuna bakın.
Hızlı BaşlangıçMevcut IDE'nizde, metodun ne döndürmesi gerektiğini ve modelin aksi takdirde hatırlayacağı herhangi bir varsayılan ayarı belirtin.
Add a ReadDeliveryNote method to Imports/DeliveryNotes.cs that uses IronOCR (the
IronOcr NuGet package, namespace IronOcr) to read a scanned delivery note and
return both its text and the barcode values found in the same pass. Barcode
reading is off by default, so switch it on before the read. Take the license key
from the IRONOCR_LICENSE_KEY environment variable, never inline. Then build and
fix any errors.
Editörün başladığı ortamda IRONOCR_LICENSE_KEY ayarlayın ve anahtarın tutulacağı diğer yerler için lisans anahtarı kılavuzunu inceleyin. Bu olmadan, ilk okuma lisans kontrolünde durur ve Copilot, yazdığı OCR kodunu çalıştıramaz.
Asgari İş Akışı (5 adım)
- C# OCR kütüphanesini NuGet'ten indirin
- IronOCR kurallarınızı
.github/copilot-instructions.mdiçine kontrol edin. - Tek bir dosya için satır içi sohbeti kullanın ve birden fazla dosya içeren bir durumda ajan moduna geçin.
- Bulut ajanı yalnız çalışacağında ayrıntılı bir sorun yazın.
- Her IronOCR üyesini çekme isteğinde API referansını kullanarak doğrulayın.
Visual Studio'da zaten bir projede Copilot nerede yer alır?
Tek dosyalık bir IronOCR değişikliği için satır içi sohbeti kullanın. Değişiklik birkaç dosyayı kapsadığında, proje oluşturabileceği ve OCR kodunu kendisi çalıştırabileceği için ajan moduna geçin. GitHub'daki bulut ajanı, atanan bir sorunu alır ve bir çekme isteği ile geri döner.
IronOCR kurallarını Copilot için nasıl belirlersiniz?
Copilot Chat, ajan modu ve bulut ajanı tarafından okunan IronOCR kurallarını .github/copilot-instructions.md olarak taahhüt edin. Satır içi tamamlamalar bunu görmezden gelir.
# Copilot instructions
## OCR
- 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.txt
Skill file: 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.
- Always dispose OcrInput with a using block.
- Barcode reading is off by default. Set Configuration.ReadBarCodes only where needed.
- Apply only the image filters that fix a visible defect.
- Do not invent IronOCR API names. If a member is uncertain, say so and cite
the documentation rather than guessing.
## Testing
- Every OCR change must be run against pages with known values.
- Assert on extracted fields. Never assert on the full text of a page.
## Pull requests
- Say which IronOCR APIs the change introduces, and link the page for each.
- If the OCR tests fail, check the runner environment before changing code
that the issue did not ask you to touch.
Bir klasöre kendi OCR dil kurallarını nasıl verirsiniz?
IronOCR ayarları genellikle kaynağa göre değişir, örneğin Almanca tedarikçi faturaları ve İngilizce depo taramaları gibi. Alman kurallarını .github/instructions/ocr-german.instructions.md içine koyun. Copilot, üzerinde çalıştığı dosya Alman dosyasının üstündeki yol düzeniyle eşleşirken, o dosyayı depo genelindeki dosya ile birlikte uygular.
---
applyTo: "Imports/De/**"
---
- Invoices in this folder are German. Set Language = OcrLanguage.German and add
English with AddSecondaryLanguage(OcrLanguage.English) for supplier names.
- German comes from the IronOcr.Languages.German NuGet package. Language packs
keep their own version numbers, so never align this one with IronOcr.
- Amounts use German formatting, such as 1.234,56. Parse them with the de-DE culture.
En yeni Alman paketi, 2020.11.2 ve ikincil dil olarak İngilizce ile yapılan bir Alman örneği okuma, o satırda %96,6 güvenle 'Gesamtbetrag: 3.271,07 EUR' döndürdü.
Bulut ajanının etkili olduğu bir sorun ne yapar?
Sadece yanlış fatura toplamlarını rapor eden bir sorun, hatalı dosyayı, etkilenen taramaları ve doğru toplamları bulmak için bulut ajanını bırakır.
Title: Totals misread on rotated scans from the warehouse scanner
**Files:** Imports/InvoiceReader.cs, Imports/ImportJob.cs
**IronOcr version:** as pinned in Directory.Packages.props
**Framework:** .NET 8
**Expected:** Every invoice in TestData/warehouse/ returns the total recorded in
TestData/warehouse/expected.csv, with line confidence of at least 80.
**Actual:** About a third of warehouse scans return totals with one wrong digit.
The pages are rotated a few degrees and have speckle. Invoices from the email
inbox read correctly. No exception is thrown.
**Constraints:** Keep the Total due parsing as it is. Do not change the public
signature of InvoiceReader.ReadTotal. No new packages.
**Acceptance:** Existing tests pass, plus a new test that reads every scan in
TestData/warehouse/ and matches expected.csv.
E-posta ile gönderilen faturaların doğru okunduğunu belirten not, incelemeyi tarama kalitesine yönlendirir, pars etmeye değil.
Bulut ajanının testleri bir IronOCR projesinde neden başarısız oluyor?
Varsayılan olarak, bulut ajanı, geçici bir Ubuntu Linux çalıştırıcısında oluşturur ve test eder. IronOcr paketi yalnızca Windows yerel çalışma zamanlarını gönderir, dolayısıyla çalıştırıcının IronOcr.Linux gereksinimi vardır. .github/workflows/copilot-setup-steps.yml adresindeki bir kurulum iş akışı, copilot-setup-steps adlı tek işiyle, varsayılan dala birleştirildiğinde bu boşluğu kapatır.
Write .github/workflows/copilot-setup-steps.yml for this repository.
The job must be named copilot-setup-steps exactly, or it is ignored. Trigger it
manually, and on push and pull request limited to that one file path.
Run it on ubuntu-latest with read access to repository contents. Check out the
repository, set up the .NET SDK for the version this project targets, install
the native dependencies IronOCR needs on Ubuntu, then restore packages.
For those dependencies read
https://ironsoftware.com/ocr/csharp/get-started/linux/ and use what it lists for
Ubuntu rather than a list from memory. Note in a comment that the list can
change between releases.
The runner is Linux, so OCR there needs the IronOcr.Linux package this
repository's instructions name. Show me the finished YAML, then any project
change the runner still needs to restore IronOcr.Linux.
- Lisans anahtarı: Bulut ajanı Actions, Codespaces veya Dependabot sırlarını okuyamaz, bu nedenle anahtarın bir Ajanlar sırrına ihtiyacı vardır. Ayarlar altındaki anahtarı ekleyin, ardından Sırlar ve değişkenler, ardından Ajanlar, aynı adı editör okur ve ajan onu bir ortam değişkeni olarak alır.
- Başarısız bir kurulum adımı: Bulut ajanını durdurmaz. Ajan kalan adımları atlar ve yine de çalışmaya başlar, bu nedenle iş akışını Actions sekmesini kullanarak bir kez çalıştırın ve geçtiğini doğrulayın.
Birleştirmeden önce neyi kontrol etmelisiniz?
Bir Copilot çekme isteğini, bir meslektaşınızınkini gözden geçirdiğiniz gibi gözden geçirin.
/tests Add xUnit tests for this change: every scan in TestData/warehouse/ returns
the invoice number and total in its expected.csv, a page without a total returns
null rather than a guess, and reads below 80 confidence are flagged. Assert on
extracted fields, not on the full page text.
Yeni bir IronOCR sürümü, değerleri değiştirmeden boşlukları ve satır sonlarını değiştirebilir. AI kodlama asistanları kılavuzu bu incelemeyi tekrarlanabilir bir teste dönüştürür.
Yanlış bir OCR sonucunu nasıl teşhis edersiniz?
Yanlış bir sonuç genellikle üç nedenden biridir. Sayfanın bir görüntü filtresine veya daha yüksek DPI'a ihtiyacı vardır, belgenin dil paketi hiç eklenmemiştir veya okuma yanlış bölgeyi hedefliyordu. Boş bir barkod koleksiyonu, Configuration.ReadBarCodes ayarlanmadığı anlamına da gelebilir.
Delivery notes in TestData/notes/ return their text, but about a third
come back with an empty barcode collection, while the same notes decode fine on
the handheld scanner.
Explain the cause before changing anything, then fix it in ReadDeliveryNote only.
Do not change the text extraction. Report how many notes return a barcode before
and after. Measure the current count first and base the explanation on what you
measured, not on a guess.
Önce ölçü adımı olmadan çalışan bir durumda, Copilot başlangıçta çözünürlüğü suçladı, ardından kayıp barkodları soluk gri basılmış QR kodlarına izledi ve sabit bir bölgeyi kırparak ve bir gri tonunu seçerek onları kurtardı. Faded kodların sayfada daha aşağı bastığı bir ikinci setle, o düzeltme hiçbiri okumadı. Talimatla, Copilot önce ölçüm yaptı, kontrast, ikileştirme, yükseltme ve kırpmayı devre dışı bıraktı ve bir keskinleştirme filtresi uyguladıktan sonra ikinci bir okuma ekledi. Her zaman daha önce Copilot'un görmediği sayfalarda düzeltmeleri test edin.
Tanıma yerel olarak çalışıyor ancak bir çalıştırıcıda veya bir konteynerde başarısız oluyorsa, Copilot'a özet yerine tam istisna mesajını verin.
Gerçek bir çalıştırmada istemler ne üretti?
Editörde çalışan bu kılavuzdaki her ayar istemi, iki sohbet üzerinden sıralı olarak gönderildi, örnek bir alıcı uygulamaya karşı, tüm .NET 9 konsol projesi ile merkezi paket yönetimi, bir fatura okuyucu ve bilinen değerlerle taramalar ile. Her sonuç aşağıda, sohbet dışında tekrar ölçüldü.
- Bir barkodlu teslimat notları, düzeltmeden önce 9 üzerinden 6'dan düzeltmeden sonra 9 üzerinden 9'a gitti ve aynı düzeltme ikinci sette 12 sol emniyet kodundan 8'ini okudu.
/testspaketi 14 üzerinden 14 geçti. Ayrıca, ImportJob'un konsol çıktısını sorgusuz değiştirdi ve taranmış kayıtlar yerine oluşturulmuş kayıtlar üzerinde güven aralığını test etti.- Tüm dört istemden sonra, Sürüm yapısı temizdi, elle düzenleme yoktu.
- İki parça sayfadan farklı çalıştı. Kişi lisans anahtarını testler istemine yapıştırdı ve Copilot onu her dosyadan uzak tuttu. Kurulum iş akışı, bulut ajanı, sorunu ve Ajanlar sırrı GitHub Actions veya bir GitHub deposu gerektirir, bu yüzden hiçbirisi çalışmadı.
Bu sayıların arkasındaki asistan versiyonu, model, zamanlamalar ve test makinesi, çalıştırma kaydındaki diğer tüm kılavuzlarla birlikte listelenmiştir.
Hata Ayıklama
- Bir çekme isteği derleniyor ancak ilk okuma lisanslama hatası veriyorsa, IronOCR'da bir Lisans Anahtarı Uygula
- Bir Linux çalıştırıcının yerel bağımlılıklar dışında eksik olduğu durumda Linux'ta IronOCR
- Çıkarılan değerler taramadan farklılık gösteriyorsa OCR Doğruluğunu Arttırın
- Derleme çıktısından yerel dosyalar eksikse IronOCR Çalışma Zamanları Klasörü
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.