Cursor'u IronBarcode Belgelerine Dayand?rma

Curtis Chau
Curtis Chau
Güncellendi: 21 Eylül 2026

BarcodeReaderOptions.CropArea, IronBarcode'da, aynı isimdeki System.Drawing türünü değil, bir IronSoftware.Drawing.Rectangle alır ve hafızadan çalışan bir model, tanıdık olanı seçer. Aynı alışkanlık dotnet add package IronBarcode yazar, ancak paket BarCode ve namespace IronBarCode'dir.

Cursor eskiden bu ihtiyac?, bir belge sitesini @Docs referans? ?zerinden indeksleyerek kar??l?yordu. Bu referans art?k Cursor'un belgelerinde yer alm?yor. Bunun yerini, isteme yap??t?r?lan ve ajan?n web arac?yla getirdi?i bir ba?lant? ya da bir kural veya beceride yer alan y?nergeler ald?. ??? de ajan? ger?ek sayfalara y?nlendirir ve hi?biri bir indeksin haz?rlanmas?n? beklemez.

Cursor, AI odakl? bir edit?rd?r ve ajan? birbirinden olduk?a farkl? iki kapsamda ?al???r:

  • Sat?r i?i d?zenleme ve Tab, imlecinizin bulundu?u yerde ?al???r: Ctrl+K (Mac'te Cmd+K) ile de?i?ikli?i tek c?mlede belirtirsiniz; Tab ise bir sonraki d?zenlemenizi tahmin eder.
  • Ajan modu, dosyalar aras?nda planlama yapar, derlemeyi ?al??t?r?r, hatalar? okur ve i?lemi yineler. Plan modu ise ?nce yakla??m ?zerinde sizinle anla??r.

Sonraki de?i?iklik ba?ka bir dosyada yap?lacaksa Tab o dosyaya ge?i? i?in bir portal a?ar. Sat?r i?i d?zenleme ise kabul etmeniz veya reddetmeniz i?in fark? bulundu?u yerde g?sterir.

Kurallar yaln?zca ajan modunda ve sohbette ge?erlidir. Cursor'un belgeleri, kurallar?n Cursor Tab veya di?er AI ?zelliklerini etkilemedi?ini a??k?a belirtir. Bu nedenle depoya kaydetti?iniz bir kural, Tab bir y?ntem ?nerirken devrede de?ildir.

Barkod i?lerinde Cursor'un belgeleri temel almas? i?in depoya kaydedilmi? iki dosya ve isteme yap??t?r?lm?? bir ba?lant? gerekir. Bu haz?rl?k ?zellikle okuyucu se?eneklerini daraltmak, bir k?rpma b?lgesi eklemek, bir okuma h?z? se?mek veya k?t? taramalardan olu?an bir grubu okunabilir hale getirecek tek g?r?nt? d?zeltmesini belirlemek gibi hassas de?i?ikliklerde ?nemlidir.

Buradaki a??klamalar, IronBarcode okuyucusunun kendi uygulamal? ?rne?i bulunan g?ven puanlamas?yla ilgili de?ildir.

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

PM > Install-Package BarCode

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

Cursor'da bir C# projesi a??n ve kod yazmaya ba?lamadan ?nce ajana okuyaca?? bir sayfa verin.

In Program.cs, generate a Code 128 barcode for an asset tag and style it for a
printed label. Set the bar color and the background with ChangeBarCodeColor and
ChangeBackgroundColor, size it with ResizeTo, and print the value under the
bars. The license comes out of IRONBARCODE_LICENSE_KEY.

Work from https://ironsoftware.com/barcode/csharp/llms-full.txt, use only
members that appear in it, and tell me which page each styling call came from.
Text

Renk ve boyutland?rma ?yelerinin adlar?n? eksik veya yanl?? hat?rlamak kolayd?r; bu y?zden istem, ajan? ?nce ilgili sayfaya y?nlendirir. Barkod stili k?lavuzu ???n?n de tam ad?n? verir.

Lütfen dikkat: Yap??t?rd???n?z her istem oturumda saklan?r. Dolay?s?yla bir isteme lisans anahtar? yap??t?r?rsan?z, anahtar? edit?r?n?z?n ge?mi?ine kaydetmi? olursunuz. Bunun yerine, lisans anahtar? k?lavuzunda a??kland??? gibi anahtar? ortamdan okuyun.


Hangi model barkod oturumunuzu çalıştırmalı?

Cursor, bu seride modeli se?ebildi?iniz tek ara?t?r. Cursor'un kendi ajan modeli Composer, edit?r i?inde ara? kullan?m?, dosya d?zenleme ve terminal i?lemleri i?in optimize edilmi?tir; varsay?lan olarak h?zl? varyant? kullan?l?r. Model se?ici ayr?ca OpenAI, Anthropic, Google ve SpaceXAI'nin en geli?mi? modellerini listeler. Tab bu se?imden ba??ms?zd?r; son d?zenlemelerinizi, ?evredeki kodu ve linter hatalar?n? temel al?r.

Bir barkod oturumunun b?y?k b?l?m? d???k maliyetli ve tekrarl?d?r. Bir format ekler, yeniden derler, test k?mesindeki barkodlar? ??zer ve ince ayar yapars?n?z. Bazen ger?ek taramalardan olu?an bir grubun kodu ??z?lemez ve hi?bir hata bunun nedenini a??klamaz. B?yle durumlarda d?zenlemeden ?nce daha uzun s?re ak?l y?r?ten bir modele ge?in. Model kodu da ?ekillendirir; bu nedenle sembolojiyi, ??kt? boyutunu ve geri okuma ko?ulunu varsay?lanlara b?rakmak yerine a??k?a belirleyin.

Serideki rehberlerin ortak noktas? budur. Cursor'da bir Claude modeli ?al??t?r?rsan?z, Claude Code k?lavuzundaki notlar onun ??kt?s? i?in de ge?erlidir. Model ayn?d?r. Yaln?zca aray?z farkl?d?r.

Cursor'un IronBarcode Belgelerini Temel Almas?n? Nas?l Sa?lars?n?z?

Eski indeksin yerini birbirini tamamlayan ?? ad?m al?r:

  • Ba?lant?y? yap??t?r?n: belge merkezi yerine llms-full.txt dosyas?na y?nlendirin; b?ylece tek bir URL, k?lavuzlar?, ?rnekleri ve ?ye adlar?n? ajana sunar.
  • Beceriyi depoya kaydedin: IronBarcode'un yay?mlad??? skill.md dosyas?n? .cursor/skills/ironbarcode/SKILL.md olarak kaydedin, name: ironbarcode de?erini klas?r ad?yla e?le?tirin ve dosyay? depoya kaydedin.
  • Kural? depoya kaydedin: sonraki b?l?m, kural?n i?eri?ini ele al?r.

Cursor, proje k?k?ndeki veya bir alt dizindeki .cursor/skills/ ve .agents/skills/ klas?rlerinden ajan becerilerini y?kler. Her beceri, ?nbilgisinde name ve description alanlar? bulunan bir SKILL.md dosyas? i?eren bir klas?rd?r. Ajan, g?revle ilgili g?r?nd???nde beceriyi y?kler; /ironbarcode yazarak da do?rudan ?a??rabilirsiniz. .agents/skills/, ayn? dosyan?n ara?tan ba??ms?z konumudur; Codex ve Antigravity de dosyay? buradan y?kler.

???n? de atlarsan?z model, g?ncel s?r?me g?re hi? do?rulanmam?? e?itim verileriyle yan?t verir. ?lk hatalar y?ntem adlar?nda ortaya ??kar. BarcodeScanner.DecodeImageFile() ger?ek bir ?a?r? gibi g?r?n?r, ancak derleme s?ras?nda hata verir.

Bir sayfa üzerinden çalışıldığında, tahmin olacak sorular sorgular haline gelir.

Which options narrow a read to two symbologies inside a fixed region of a
larger image? Give me the exact class and property names, and quote the lines
you took them from in https://ironsoftware.com/barcode/csharp/llms-full.txt.
Text

Ajan önerdiği API için bir sayfa alıntılayamazsa, bunun üzerine inşa etmeden önce doğrulayın.

İpuçları: Bu yakla??m, tan?mad???n?z her s?n?f i?in i?e yarar. Dosya ba?lamdayken BarcodeReaderOptions hakk?nda bilgi edinmek i?in sayfay? kayd?rmak yerine sorular sorabilirsiniz; yan?t da bilginin al?nd??? API referans? sayfas?na at?fta bulunur.

IronBarcode Kullan?m Kurallar?n?z? Tan?mlayan Proje Kurallar? Nas?l Yaz?l?r?

Proje kurallar?, depo k?k?ndeki .cursor/rules klas?r?ne yerle?tirilir. S?r?m kontrol? alt?nda kodla birlikte depoya kaydedildikleri i?in her geli?tirici ek kurulum yapmadan ayn? davran??? elde eder.

Her kural, description, globs ve alwaysApply alanlar?n? tan?mlayan YAML ?nbilgisine sahip bir Markdown dosyas? olan .mdc dosyas?d?r. Cursor klas?r? ?zyinelemeli olarak tarar; dolay?s?yla alt klas?rler de kullan?labilir. Buradaki s?radan bir .md dosyas?, onu etkinle?tirecek ?nbilgisi olmad???ndan yok say?l?r. Bir IronBarcode kural? ??yle g?r?n?r.

---
description: IronBarcode conventions for barcode reading and writing in this project
globs: ["**/Services/**/*.cs", "**/Barcodes/**/*.cs"]
alwaysApply: false
---

# IronBarcode conventions

Applies to the barcode code in this folder only.

- IronBarcode (package BarCode, namespace IronBarCode) writes and reads every
  barcode here. Never reach for a second barcode package.
- Reader options are explicit: set ExpectBarcodeTypes to the formats this
  feature really reads, and reuse one BarcodeReaderOptions per format set
  rather than allocating per call.
- Reads on a request path are async.
- CropArea takes IronSoftware.Drawing.Rectangle, not System.Drawing.
- Verified recipes: https://ironsoftware.com/barcode/csharp/skill.md
- If you are unsure a member exists, say so and cite the page. Do not guess a
  method name that sounds plausible.
YAML

Modele belirsizli?in kabul edilebilir oldu?unu s?ylemek, API uydurmas?n? ?nler. Bir kural, sonraki t?m oturumlar i?in bunu bir kez belirtmenizi sa?lar.

globs sat?r?n? bilin?li olarak kopyalay?n. alwaysApply: true i?eren bir kural her istekte y?klenir ve barkodlarla ilgisi olmayan i?lerde de ba?lam t?ketir. Kural? barkod kodunun bulundu?u klas?rlerle s?n?rlamak, yaln?zca ilgili yerlerde uygulanmas?n? sa?lar.

Lütfen dikkat: Cursor, ChatGPT Codex ve Google Antigravity'nin kulland??? d?z AGENTS.md dosyas?n? da okur. Bu dosya ?nbilgi ve dolay?s?yla glob desenleri i?ermez. Cursor dosyay? proje k?k?nde ve alt dizinlerde okudu?undan, kapsam? s?n?rlaman?n tek yolu dosyalar? i? i?e dizinlere yerle?tirmektir. Glob desenleri i?in .cursor/rules, birden fazla ara?ta kullan?lacak tek bir talimat dosyas? i?in AGENTS.md kullan?n.

Değişime hangi mod uyar?

Cursor, bu serideki di?er ara?lardan daha fazla d?zenleme yolu sunar. Tek sat?rdan t?m depoya kadar, de?i?ikli?in b?y?kl???ne g?re se?im yap?n:

ModNe zaman kullan?lmal?Barkod ?rne?i
TabSonraki d?zenleme tahmin edilebilirBir okuyucu se?ene?ini tekrarlama
Satır içi düzenlemeBir dosya, bir cümleOkumayı iki formata daraltma
Ajan?al??ma birden fazla dosyay? kapsar ve bir derleme d?ng?s? gerektirirBir etiket u? noktas? ve bir tarama u? noktas?
Plan moduYeniden yaz?m, sonradan incelenemeyecek kadar b?y?kt?rBa?ka bir barkod k?t?phanesinden ge?i?
Bulut ajanıGözetimsiz çalışabilirHer formatta gidiş-dönüş testleri

Bir @ Referans? Neyi De?i?tirir?

Bir @ referans?, ajana okuyaca?? i?eri?i sunar: bir dosya, klas?r, terminal, ?nceki sohbet, Git fark? veya taray?c? olabilir. Barkodlar? okuyan dosyaya referans vermek, dosyay? tarif etmekten daha etkilidir; ??nk? tarif ederken hatan?n bulundu?u ayr?nt? kaybolabilir.

@Services/ScanService.cs @TestData/depot/

Read https://ironsoftware.com/barcode/csharp/llms-full.txt for the options.

Half the photos in TestData/depot/ come back empty. The reader options are
where this gets fixed, not the label generator. Name the setting that was
missing, and give me a decode rate for the folder before your change and after
it.
Text

Bir klas?re referans vermek, mod?l genelindeki i?ler i?in uygundur. Hangi dosyan?n ilgili oldu?unu bilmiyorsan?z t?m kod taban?n? kullanabilirsiniz. Kodu belgelerle birlikte sunmak, sorunun iki y?n?n? de kapsar: dosya kodunuzun ?u anda ne yapt???n?, belge sayfas? ise k?t?phanenin ger?ekte neler sundu?unu g?sterir.

Bir foto?raf grubunu hangi ayar?n okunabilir hale getirece?i, g?r?nt?lerdeki bozulman?n t?r?ne ba?l?d?r. Hi?bir a??klama, ajan?n g?r?nt?ler ?zerinde ?al??mas?n?n yerini tutmaz. Okuma h?z? ve g?r?nt? d?zeltme sayfalar?, ilgili ayarlar? ayr? ayr? ele al?r.

IronBarcode'a Ge?i? Nas?l Planlan?r ve Uygulan?r?

?ok say?da dosyay? kapsayan, incelenmemi? bir yeniden yaz?m ge?i? s?ras?nda maliyetli olabilir; ??nk? geri almak yazmaktan daha zordur. Plan modu bunun i?in vard?r. Sohbet giri?inde Shift+Tab tu?lar?na bas?n veya a??l?r mod men?s?nden se?in. Ajan a??klay?c? sorular sorar, kod taban?n? okur ve herhangi bir kod yazmadan ?nce sohbette ya da Markdown olarak d?zenleyebilece?iniz bir plan olu?turur. Planlar kullan?c? ana dizininize kaydedilir; "?al??ma alan?na kaydet" se?ene?i, ekibin incelemesi i?in plan? depoya ta??r.

The barcode code in @Labels/ belongs to another library. Using
https://ironsoftware.com/barcode/csharp/llms-full.txt, work out what replacing
it with IronBarcode would actually involve. Which files change, what the
equivalent call is for each thing the folder does today, and where the
documentation says no clean equivalent exists.

Public method signatures are fixed. If the plan needs one to change, say so in
the plan rather than changing it.
Text

Plan? okuyun, bir veya iki c?mleyle d?zeltin ve uygulanmas? i?in geri g?nderin. Ajan modu ard?ndan kodu okur, dosyalar aras?nda d?zenlemeler yapar, komutlar? ?al??t?r?r, ??kt?y? kontrol eder ve i?lemi yineler; b?ylece sonraki istem k?sa olabilir.

Carry out the plan we agreed. Compile it, clear whatever errors come up, and
satisfy yourself that every symbology the folder handles still comes back out
the same as it went in. Show me the diff at the end. BarCode is the only package
that may appear in the .csproj.
Text

Bu iki sınırı kaldırın ve ajanlar, taşınma sırasında çağrı desenini yeniden tasarlar.

G?zetim gerektirmeyen i?leri, edit?rde ?al??maya devam ederken eskiden arka plan ajan? olarak adland?r?lan bulut ajan?na verebilirsiniz. Gidi?-d?n?? test paketi buna uygundur; do?rulamalar uygulama ayr?nt?lar?na de?il, ??z?mlenen de?erlere dayan?r. Dolay?s?yla bu testleri yazmak i?in ge?i?in tamamlanmas?n? beklemek gerekmez.

@Services/

Send this to a cloud agent while I keep working on the reader options.

Cover the migrated service with xUnit. Use a [Theory] over the symbologies it
supports rather than one [Fact] per format, so adding a format later costs one
line. Each case writes a sample value and reads it back, and the assertion is on
the decoded string and the decoded format together.

Then three edge cases as their own facts: an empty image returns no results
instead of throwing, a letters-only value is refused as EAN-13, and a missing
path fails with a readable message. Image bytes are off limits as an assertion
target.
Text

Bayt kar??la?t?rmalar?n? d??ar?da b?rakmak, test paketinin farkl? platformlarda kararl? ?al??mas?n? sa?lar.

Okuma Sorunlar?n?n Kayna?? Nerededir?

Okunamayan barkodlar, IronBarcode hakk?nda en s?k sorulan konudur. ??z?m neredeyse her zaman etikette de?il, okuyucu se?eneklerindedir. Cursor sayesinde hatay? tarif etmeniz gerekmez. Servise ve okunamayan g?r?nt?lerin bulundu?u klas?re referans verin; edit?r her ikisini de temel alarak ?al???r.

Photos of returns labels read fine on a handheld scanner but come back empty
from @Services/ScanService.cs, and a few product photos carrying no barcode at
all return a value. Samples of both are in @TestData/returns/.

Explain the cause of each before changing anything, then fix both in the reader
options.
Text

?nce a??klama istemek, yap?lan de?i?ikli?i sonradan ??z?mlemek yerine kontrol edebilece?iniz bir gerek?e sunar. Buradaki iki belirti z?t d?zeltmeler gerektirir. Ka??r?lan okumalar i?in Barkod Tan?nmad? k?lavuzunda anlat?ld??? gibi daha dar bir format listesi, k?rpma alan? ve do?ru g?r?nt? filtresi gerekir. Ger?ekte bulunmayan de?erlerin d?nd?r?lmesi i?inse yanl?? pozitifler k?lavuzunda ele al?nan RemoveFalsePositive ve bir g?ven e?i?i gerekir.

Da??t?m hatas?n?n kayna?? genellikle bir C# dosyas? de?il, .csproj veya konteyner imaj?d?r. Terminal eri?imi olan bir ajan her ikisini de okuyabilir ve derlemeyi kendisi ?al??t?rabilir.

@Dockerfile @LabelScan.csproj @Terminals

Reading works on Windows but fails in our Linux container. The failing build is
in the terminal output above, so read it there rather than asking me to paste it.

Check which BarCode package the project references and whether the image has
the native dependencies IronBarcode needs on Linux. Explain the cause, then
propose the change. Don't modify C# code unless the cause is there.
Text

C# koduna dokunulmamas? gerekti?ini a??k?a belirtin. Ba?ar?s?z bir ?a?r? i?in s?n?r koymazsan?z ajan bir try/catch ekleyip sorunun ??z?ld???n? bildirebilir. Linux'ta Docker k?lavuzu, imaj?n ger?ekte nelere ihtiya? duydu?unu listeler.

?nce Neleri Haz?rlamal?s?n?z?

Beceri dosyas?n? ve kapsam? s?n?rland?r?lm?? bir kural? haz?rlamak yakla??k on be? dakika s?rer; ikisi de sonraki her oturumda ge?erlidir. Belge ba?lant?s?n? yap??t?rmak ise her istemde s?rd?rmeniz gereken, yaln?zca bir sat?r gerektiren bir al??kanl?kt?r.

Edit?r?n kulland??? modeli de?i?tirseniz de ?? kontrol ge?erlili?ini korur: kod derlenir, barkodun kodu ??z?l?r ve kulland???n?z her ?ye IronBarcode'un belgelenmi? API'sinde yer al?r. AI kodlama asistanlar? ve ajanlar? k?lavuzu tam olarak bu ?? ?l??t? de?erlendirir. Claude Code, ChatGPT Codex, GitHub Copilot ve Google Antigravity i?in ayr? birer sayfa vard?r.


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.

Daha Fazla Oku

Başlamaya Hazır mısınız?

NuGet İndirmeleri 2,564,559Sürüm:2026.11yeni çıktı