Cursor'u IronBarcode Belgelerine Dayand?rma
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'teCmd+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ıç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.
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.
5 Adımda Minimal İş Akışı
- NuGet üzerinden C# barkod kütüphanesini indirin
- IronBarcode'un
llms-full.txtbağlantısını barkod kodu yazan herhangi bir komut istemine yapıştırın - IronBarcode'un
skill.mddosyasını.cursor/skills/ironbarcode/SKILL.mdolarak kaydedin - BarCode s?r?m?n? sabitleyen ve proje kurallar?n?z? belirleyen bir proje kural?n? depoya kaydedin
- Derleyin, her barkodu geri okuyun ve her API ismini API referansı ile karşılaştırın
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.txtdosyas?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.mddosyas?n?.cursor/skills/ironbarcode/SKILL.mdolarak kaydedin,name: ironbarcodede?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.
Ajan önerdiği API için bir sayfa alıntılayamazsa, bunun üzerine inşa etmeden önce doğrulayın.
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.
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.
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:
| Mod | Ne zaman kullan?lmal? | Barkod ?rne?i |
|---|---|---|
| Tab | Sonraki d?zenleme tahmin edilebilir | Bir okuyucu se?ene?ini tekrarlama |
| Satır içi düzenleme | Bir dosya, bir cümle | Okumayı iki formata daraltma |
| Ajan | ?al??ma birden fazla dosyay? kapsar ve bir derleme d?ng?s? gerektirir | Bir etiket u? noktas? ve bir tarama u? noktas? |
| Plan modu | Yeniden yaz?m, sonradan incelenemeyecek kadar b?y?kt?r | Ba?ka bir barkod k?t?phanesinden ge?i? |
| Bulut ajanı | Gözetimsiz çalışabilir | Her 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.
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.
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.
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.
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.
?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.
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
- Sat?r i?i d?zenleme derleniyor ancak uygulama ?al??m?yorsa IronBarcode'da Bir Lisans Anahtar? Uygulay?n.
- Okuyucu se?eneklerinin h?l? ayarlanmas? gerekiyorsa Barkod Tan?nmad?.
- Proje kuralınızdaki sürüm ve
.csprojiçindeki sürüm uyuşmadığında IronBarcode NuGet Paketleri. - Yerel ortamda okumalar ba?ar?l?, konteynerde ba?ar?s?z oluyorsa IronBarcode'u Linux'ta Docker ??inde ?al??t?r?n.
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.