Cursor ile IronQR Nasıl Kullanılır

Curtis Chau
Curtis Chau
Güncellendi: 9 Ekim 2026

ZXing.Net, ZXing barkod kütüphanesinin açık kaynaklı .NET sürümüdür. Bir yapay zeka aracısından müşteri fotoğraflarından QR kodları okuyan C# kodu istemeniz durumunda, Result.Text karşılaştırma, QR_CODE formatında filtreleme veya QrImageInput bir kullanma ifadesine sarmalaması gibi ZXing.Net geleneklerini uygulayabilir, IronQR belirtmiş olsanız bile. IronQR 2026.10.1 sürümünde, girdiyi bu şekilde atmak bir NotImplementedException fırlatır.

Cursor, VS Code tabanlı bir AI kod editörüdür. IronQR kodu veya ZXing.Net çevirisini üretip üretmemesi iki özelliğe bağlıdır. Aracı, sağladığınız dokümantasyon bağlantılarını takip eder ve .cursor/rules projesinden kuralları uygular. Bu kılavuz, müşteri fotoğraflarından seri numaraları ve kayıt bağlantıları çıkaran bir garanti kabul hizmetiyle her ikisini de göstermektedir ve bu hizmeti ZXing.Net'ten IronQR'a taşımaktadır. IronQR, QR, Micro QR ve rMQR sembollerini destekler.

Bu kılavuz, Cursor ile kod yazmaya odaklanmaktadır. IronQR'un okuma seçenekleri hakkında ayrıntılar için, tarama modları kılavuzuna, QR türü kılavuzuna ve değer ve koordinat kılavuzuna bakın.

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

PM > Install-Package IronQR

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

Cursor'da teslim projesini açın ve bu isteği Agent panelinden gönderin.

@src/WarrantyIntake/ @TestData/claims/ Before writing code, fetch
https://ironsoftware.com/qr/csharp/llms.txt and the scan modes page it links.

Add the IronQR package to src/WarrantyIntake. Give Program.cs a second entry
point so that `dotnet run -- --modes <photo>` reads one photo three times, once
per QrScanMode value, and prints each result's QrType, Value, Url, and four
Points. Set License.LicenseKey from IRONQR_LICENSE_KEY at startup, never from
a literal. Leave Claims/StickerReader.cs and its ZXing.Net reference untouched.
Run the new mode on TestData/claims/claim-0004.jpg and show me what it printed.
Text

Lisans anahtarını sohbet mesajlarının dışında tutun. Aracı dosyalar oluşturur ve terminal komutlarını çalıştırır, bu yüzden yapıştırılan bir anahtar, kaynak kodda, kayıtlarda veya günlüklere düşebilir. Lisans anahtarı kılavuzu, desteklenen saklama yerlerini listeler.



QR kod çalışmaları 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ı.

Kayıt kaydına bir alan eklemek veya fotoğraf klasörünü yeniden çalıştırmak gibi rutin fotoğraf işlemleri hızlı bir modele uygundur. Açık bir neden olmadan fotoğraf yığını çözülmez duruma geldiğinde, daha uzun süre düşünen bir modele geçin. Modeller istekleri farklı okur, bu yüzden her istekte fotoğraf klasörünü ve eşleşmesi gereken seri numaralarını adlandırın.

IronQR dokümantasyonunu Cursor'a nasıl verirsiniz?

IronQR'un dokümantasyon bağlantısını isteğe koyun veya yapıştırma gerekmeyecek şekilde taahhüt edilmiş bir kuralda tutun. llms.txt dizini kılavuzlar ve API referansı ile bağlantılıdır ve llms-full.txt 44 dokümantasyon sayfasını tek bir dosyada özetler. Ekim 2026 itibarıyla Cursor'ın @ menüsü dosyaları, klasörleri, terminalleri, sohbetleri, Git farklarını ve tarayıcayı bağlar, böylece IronQR dokümantasyonu bağlantı olarak araca ulaşır.

IronQR'un Enum'ları karıştırılması kolaydır. QrScanMode ve QrEncoding, IronQr.Enum içinde bulunurken, QrErrorCorrectionLevel, IronQr içinde bulunur ve hafızadan yazılan kod bunu yanlış yaptığında derlenemez.

@src/WarrantyIntake/Program.cs Answer from https://ironsoftware.com/qr/csharp/llms.txt
and the pages it links, and leave every file as it is.

Which namespace declares QrScanMode and QrEncoding, and which declares
QrErrorCorrectionLevel? Which scan mode does a QrImageInput get when the
constructor is given only an image? What do IronQR's pages say OnlyDetectionModel
returns, and does that match the --modes output from the last turn? Put the
page URL under each answer.
Text
İpuçları: Arkasında bir sayfa olmayan bir cevabı API referansı içinde üyeyi bulana kadar doğrulanmamış olarak değerlendirin.

IronQR geleneklerinizi şifreleyen proje kurallarını nasıl yazarsınız?

Proje kuralları .mdc dosyalarıdır ve .cursor/rules içinde bulunur. Kodla birlikte taahhüt edildikleri için, her klon aynı kuralları alır. Bu klasördeki sade bir .md dosyası yok sayılır çünkü ne zaman uygulanacağına dair bir ön ayar yoktur.

Bu kural, globs ayarlayıp alwaysApply kapalı bırakır, böylece okuyucu veya testleri bağlamdayken ilişir ve asla bir fotoğrafa dokunmayan isteklerden uzağa kalır. Onu .cursor/rules/ironqr-photos.mdc olarak kaydedin.

---
description: IronQR conventions for reading QR codes from customer photos
globs: src/WarrantyIntake/Claims/**/*.cs, tests/**/*.cs
alwaysApply: false
---

# Reading customer photos with IronQR

- Read and write QR codes with IronQR only. The NuGet package is IronQR, or
  IronQR.Linux for a Linux build, and the namespace is IronQr. Do not add
  ZXing.Net, QRCoder, or any other QR package, and remove them where they
  are already referenced.
- Documentation: https://ironsoftware.com/qr/csharp/llms.txt
- Never inline a license key. Read it from the IRONQR_LICENSE_KEY environment
  variable.
- Do not put QrImageInput in a using statement. Its IDisposable.Dispose throws
  NotImplementedException in IronQR 2026.10.1.
- Load only image files with AnyBitmap.FromFile. It throws on a CSV.
- Compare QrResult.Value with stored strings, never Url.ToString().
- Do not invent IronQR members. If one is uncertain, say so and cite the page.
Markdown
Lütfen dikkat: Cursor ayrıca proje kök dizininde ve alt dizinlerde AGENTS.md okur. Ön ayar yoktur, bu yüzden dosya deseni ile kapsama uygun olamaz. Desenle kapsanan IronQR kuralını .cursor/rules içinde saklayın.

Kurallar Aracı isteklerine uygulanır. Cursor belgelerine göre, Tab'ı etkilemezler ve kullanıcı kuralları satır içi düzenlemelere uygulanmaz. Bu özelliklerden gelen önerileri kendiniz kurala karşı kontrol edin.

ZXing.Net çağrılarını IronQR'a nasıl eşlersiniz?

Yalnızca "IronQR kullan" diyen bir kural, modelin ZXing.Net çağrısının neye dönüşeceğini tahmin etmesine bırakır. Eşdeğerleri listelemek tahmini kaldırır.

ZXing.Net veya QRCoderIronQR
BarcodeReader çözme çağrılarıHer kodu döndüren Read ile QrReader
Result.TextQrResult.Value
QR_CODE format kontrolleri ve filtreleriOkumadan sonra QrResult.QrType üzerinde bir kontrol
Daha derin tarama seçeneğiGirişte bir tarama modu
Result.ResultPoints, desen merkezleriQrResult.Points, dört köşe
QRCoder'ın jeneratörüQrWriter.Write ve kaydetme çağrıları

ZXing.Net'in BarcodeFormat Enum'u Micro QR veya rMQR üyesi içermez ve README'si QR Kodunu listeler ancak daha küçük sembolleri listemez, dolayısıyla ZXing.Net okuyucu yalnızca bir Micro QR seri numarası taşıyan bir etiket için hiçbir şey döndürmez.

Kurala iki satır olarak tablo ekleyin.

- Translate ZXing.Net instead of porting it. Result.Text becomes QrResult.Value,
  BarcodeFormat checks become QrResult.QrType checks, and ResultPoints (finder
  pattern centres) become QrResult.Points (corners).
- Write test stickers with QrWriter.Write(...).Save().SaveAs(path), not QRCoder.
Markdown

IronQR'ye geçişi nasıl planlar ve yürütürsünüz?

Bu isteği göndermeden önce sohbeti Plan Moduna Shift+Tab ile değiştirin ve Cursor, düzenleyebileceğiniz bir dosya olarak planı taslak olarak sunar.

@src/WarrantyIntake/Claims/ @tests/WarrantyIntake.Tests/ @TestData/claims/expected.csv

StickerReader decodes claim photos with ZXing.Net and the tests draw stickers
with QRCoder. Newer products carry a Micro QR serial that ZXing.Net never
returns. Plan the move of both projects to IronQR. For each ZXing.Net or
QRCoder call, name the IronQR member that replaces it and the file it sits in,
state which QrScanMode the reader will use and why, and keep ClaimSticker and
the public Read(string) signature unchanged. No code until I approve.
Text

Planın yanlış aldığı her şeyi düzeltin, ardından Derle'ye tıklayın veya bir sonraki isteği Agent'a gönderin.

Build the approved plan and follow @ironqr-photos. Remove the ZXing.Net and
QRCoder package references, run dotnet build and dotnet test, then run the app
over TestData/claims and compare each printed row with
TestData/claims/expected.csv. Report how many rows matched before the change
and after it, and show the diff.
Text

@ menüsünden seçilen @ironqr-photos, kurala adıyla ilişir, dosyanın globlarını kaçırsa bile. Temiz bir derleme şimdi Micro QR seri numaralarının geri gelip gelmediğini göstermiyor. Eşleşme sayısı bunu yapar.

Değişimin her birine hangi Cursor özelliği uyar?

Değişimin ne kadar ileri gittiğine göre birini seçin. Tab beklenmedik bir sonraki düzenlemeyi ele alır ve satır içi düzenleme bir cümlenin kapsadığı bir seçimi ele alır. Agent, birkaç dosya, kural veya bir derleme döngüsü içeren bir değişikliği alır. Yanlış bir değişikliği geri almak, onu planlamaktan daha pahalıya mal olduğunda Plan Modu fayda sağlar ve İzole Ortamda bir Cloud Agent, izlenmesine gerek olmayan çalışmaya uygundur.

Yeni bir ürün hattı, seri numarasını rMQR kodunda taşıyan dikdörtgen bir kablo etiketi ekler, ki IronQR bunu QrEncoding.RMQRCode olarak bildirir. Okuyucudaki sonuç döngüsünü seçin ve seçimi sohbete eklemek için Ctrl+Shift+L (macOS'ta Cmd+Shift+L) tuşlarına basın, ardından bu isteği Agent'da gönderin.

In StickerReader.Read, treat a result whose QrType is QrEncoding.RMQRCode the
same way as a Micro QR result, so its Value becomes the serial.
Text

Geçişten gelen okuyucu, URL olmayan herhangi bir değeri seri numarası olarak ele aldığı için etiket fotoğrafı için zaten SN-61518'i döndürdü. Düzenleme, sembol türü üzerinde bir kontrolle bu tahmini değiştirir, böylece bir Micro QR veya rMQR değeri, metni bir URL gibi göründüğünde bile seri numarası olur.

Eksik QR kod değerlerini nasıl hata ayıklar?

Her tarama modu, geri döneni değiştirir.

  • Auto varsayılandır. IronQR'un API referansı bunu, makine öğrenme modeli olarak tanımlar ve model hiçbir şey bulamazsa bir temel kuvvet okuma geri dönüş olarak kullanılır.
  • Temel kuvvet okuma, OnlyBasicScan altında tek başına çalışır, model atlanır.
  • OnlyDetectionModel kodları çözmeden onları bulur. Tarama modları kılavuzu, çıktısını koordinatlar olarak listeler.

Modelin bir kutu bildirdiğinde ancak çözemediyse, yedekleme asla çalışmaz ve Auto hiçbir değer döndürmez. 4000'e 3000 çerçevede yaklaşık 110 piksel genişliğinde bir etiket içeren tam kutu fotoğrafları buna çarpar. Değer geri alınmadığında OnlyBasicScan ile onarımın yeniden denendiğinden emin olun.

@src/WarrantyIntake/Claims/StickerReader.cs @TestData/claims/far/

Customers who photograph the whole box send pictures like these. Since the move
to IronQR none of them returns a serial, though the ZXing.Net reader read every
one. Before changing code, read each photo with all three QrScanMode values and
show what each mode returned. Then fix StickerReader without losing any photo
it reads today, and report the match count for TestData/claims and for
TestData/claims/far against their expected.csv files.
Text

Her seri numarasını IronQR'tan yazdırılmış çıktısından alın ve onu üreten komutu isteyin.

Köşe sırası da moda bağlıdır. Model kodu bulduğunda, dört nokta üst sol, üst sağ, alt sol, alt sağ olarak çalışır, tarama modları kılavuzu belirttiği gibi. OnlyBasicScan, kodun kendi köşelerini saat yönünde döndürülmüş olarak döndürür. Koordinatlardan konturlar hesaplayın ve bir sıra varsaymayın.

QR okuması için geriye dönük testleri nasıl yazarsınız?

Çözülen değerleri bilinen bir liste ile karşılaştıran testler kütüphane güncellemelerine rağmen ayakta kalır, görüntü baytlarını karşılaştıran testler ise yeniden düzenleme değiştiğinde başarısız olabilir. İzole bir bulut VM'de bu öneriyi çalıştırabilecek bir Cloud Agent olabilir. Başlamadan önce Cloud Agents panosundan IRONQR_LICENSE_KEY'i gizli olarak ekleyin.

@tests/WarrantyIntake.Tests/ @TestData/claims/ Write xUnit tests for StickerReader
that prove every row in TestData/claims/expected.csv and
TestData/claims/far/expected.csv matches, that a Micro QR and an rMQR sticker
made with QrWriter read back to their serials, that a photo with no code gives a
null serial and no exception, and that a link sticker's serial comes from Value,
not Url.ToString(). Copy TestData into the test output. Run dotnet test and
report passed and failed counts.
Text

Son iddia, değeri tamamen çıplak bir adres olan bir etiket için önemlidir. IronQR'nin tarama modları kılavuzundan örnek resmi okuma, bir Value ve bir Url verdi ve bu, sonuna eğik çizgi eklenerek yazdırıldı, çünkü Uri adresi normalleştiriyor. http://en.m.wikipedia.org Seri numarasının son yol segmenti olduğu bu hizmetteki bağlantılar ile, iddia başarısız olamaz.

IronQR'un AI kodlama asistanları kılavuzu, bir IronQR görevini baştan sona belirlenen geçiş kriterlerine karşı yürütür.

Hangi IronQR paketini dağıtmalısınız?

IronQR.Slim IronQr namespace ve temel taramayı sağlar. Tam IronQR paketi dedektörü ve ONNX çalıştırma ortamını ekler. IronQR'un NuGet paketleri kılavuzu, yalnızca Slim olan bir projenin işletim sistemi için IronSoftware.ReaderInternals paketine de ihtiyacı olduğunu söyler.

@src/WarrantyIntake/WarrantyIntake.csproj @src/WarrantyIntake/Claims/StickerReader.cs

The service ships as a win-x64 folder, and someone asked whether IronQR.Slim
could replace IronQR. Settle it with numbers. Publish for win-x64 as things
stand and record the folder size. Then swap to IronQR.Slim plus the native
package its documentation says it needs, publish again, and rerun
TestData/claims and TestData/claims/far against their expected.csv files. Keep
the swap only if every row still matches, and list which QrScanMode values the
reader can still use afterward.
Text

Yalnızca IronQR.Slim ile, Auto modeli yoktur ve doğrudan temel taramaya gider ve OnlyDetectionModel bir IronQrException atar. IronQR'un API referansı, model olmadan yapılan okumaların daha yavaş ve daha düşük kalitede olduğunu uyarır. Paketleri değiştirmeden önce kendi müşteri fotoğraflarınızla test yapın.

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

Sekiz komut istemi, örnek bir garanti teslim deposuna sırayla Cursor'a gitti. ZXing.Net okuyucu içeren bir konsol uygulaması, QRCoder ile etiketler çizen bir xUnit projesi ve bilinen seri numaraları olan on iki iddia fotoğrafı tutar. Kural, kablo etiket fotoğrafı ve tüm kutu fotoğrafları, onları kullanan istemlerden hemen önce eklendi. Lisans anahtarı yalnızca ortamda ayarlandı. Çalıştırdıktan sonra, geçişten her bir kaydın taze Release derlemeleri fotoğraf klasörlerini yeniden okudu ve IronQR okuyucunun eşleşme sayıları ve aşağıdaki test sonuçlarını üretti.

  • ZXing.Net okuyucu ile 12 üzerinden 8 iddia fotoğrafı ile eşleşti ve IronQR'ya geçişten sonra 12 üzerinden 12.
  • Her tarama modu için bir kez okunduğunda, claim-0004 Auto ve OnlyBasicScan altında iki değerle iki kod verdi ve OnlyDetectionModel altında boş değerlerle iki sonuç.
  • rMQR değişikliği ile iddia fotoğrafları önce ve sonra 13'ten 13'e kaldı.
  • Onarım öncesinde, Auto 4'ten 0'ını tam kutu fotoğraflarını okudu. OnlyDetectionModel, değer olmadan 3, 1, 3 ve 2 kutu buldu, OnlyBasicScan 4 üzerinden 4 okudu.
  • Onarımdan sonra tam kutu fotoğrafları 4 üzerinden 4 ve iddia fotoğrafları 13 üzerinden 13 okundu.
  • xUnit dizisi 22 üzerinden 22 testi geçti.
  • win-x64 için yayın yaparken IronQR ile 75.624.980 bayt ve IronQR.Slim ile 19.510.306 bayt üretti. Yeniden yapılandırmamız 75.624.288 ve 19.509.614 verdi.
  • IronQR.Slim üzerinde okuyucu hala 13 üzerinden 13 iddia fotoğrafı ve 4 üzerinden 4 tam kutu fotoğrafı eşleşti.
  • Her Serbest sürüm derlemesinde 0 hata vardı ve elle düzenleme gerekmedi.
  • Her adım burada yazıldığı gibi çalıştırılmadı. Kılavuzlar elle gönderildi, bahsedişler metin olarak kopyalandı ve Agent, kural dosyasını adıyla arayarak buldu. Plan, Derleme hiç tıklanmadığında bir sonraki kılavuzun gönderilmesiyle onaylandı ve Cloud Agent kılavuzu, yerel olarak Agent modunda çalıştırıldı.

Çalışma kaydı, her kılavuz için paket sürümlerini, modeli, zamanlamayı ve test makinesini tutar.


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 82,442Sürüm:2026.11yeni çıktı