IronPrint ile Cursor Nasıl Kullanılır
Bir yapay zeka ajanı, System.Drawing.Printing'den IronPrint'e bir C# yazdırma hizmeti aktardığında, değişmeden kopyalanan bir ayar hala derlenir ve anlamını değiştirir. Eski kodda 50'lik bir kenar boşluğu yarım inç anlamına gelirken, IronPrint'te aynı 50, 50 milimetre anlamına gelir. Yazıcı adları da değişmeden gelir. Testlerimizde IronPrint, yüklü olmayan bir yazıcı adı için bir işi varsayılan yazıcıya bir hata oluşturmadan gönderdi.
VS Code kod tabanına dayalı olan Cursor, editöre bir ajan ekler. Bir göçün bu detayları saklayıp saklamayacağı, iki Cursor özelliğine, ajana sağlanan dokümantasyon bağlantılarına ve .cursor/rules dosyasındaki taahhüt edilmiş proje kurallarına bağlıdır. Örnekler, ambalaj etiketleri, raf etiketleri ve iade notları yazdıran bir gönderi ofisi hizmeti için de geçerlidir. Hizmet, her işi santimetrelerin yüzde biri cinsinden bir yapılandırma dosyasından oluşturur ve yönlendirmeler bunu IronPrint'e taşır.
İlgili ayarların detayları için kağıt kenar boşlukları kılavuzuna ve yazıcı adları kılavuzuna bakın.
Hızlı BaşlangıçGönderi deposunu açın, yeni bir Ajan sohbeti başlatın ve bu yönlendirmeyi gönderin.
@src/DespatchDesk/ @config/despatch.json
Start by fetching https://ironsoftware.com/print/csharp/llms.txt.
Also read the pages it links on printer names and print settings.
Then add a printers command to Program.cs:
`dotnet run --project src/DespatchDesk -- printers`
Have it show what IronPrint reports on this machine:
- Every name from Printer.GetPrinterNames, in square brackets so spaces show.
- The trays GetPrinterTrays returns for each printer, or "none".
- Whether each printer named in config/despatch.json is in that list.
Have the program read IRONPRINT_LICENSE_KEY from the environment.
Set License.LicenseKey from it before anything else runs.
Don't echo the key or dump the environment.
IronPrint stays on version 2026.10.1.
Send no print jobs, and leave DespatchJobs.cs on System.Drawing.Printing for now.
Run the printers command and show me what it prints.
Hiçbir zaman lisans anahtarını sohbete yapıştırmayın. Cursor'ın ajanı dosyaları düzenleyebilir ve kabuk komutları çalıştırabilir, böylece bir lisans anahtarını taahhüt mesajına, bir kaynak dosyasına veya bir derleme günlüğüne kopyalayabilir. Yönlendirme, IRONPRINT_LICENSE_KEY'yi License.LicenseKey'ya atamak için programı görevlendirir çünkü yalnızca değişkeni ayarlamak, test sırasında IronPrint 2026.10.1'i lisanssız bırakıyordu. Anahtarsız bir probede, IronPrint yazıcıları ve tepsileri listeledi ve Printer.Print, herhangi bir iş gönderilmeden önce LicensingException çevresinde bir AggregateException fırlattı. lisans anahtar kılavuzunda IronPrint'in bir anahtarı okuduğu yerler belirtilmiştir, örneğin appsettings.json.
Asgari İş Akışı (5 adım)
- C# yazıcı kütüphanesini NuGet'ten indirin
- .cursor/rules altında IronPrint'in dokümantasyon bağlantısını içeren bir proje kuralı ekleyin
- Kuralda kenar boşluklarının milimetre cinsinden olduğunu ve yazıcı adlarının tam olarak eşleşmesi gerektiğini kaydedin
- Her istekte yazdırma koduna ve kabul edilmiş ayarlar raporuna referans verin
- Her işin ayarlarını o raporla karşılaştırın, ardından API referansı'ndaki her bir üye adını onaylayın.
IronPrint işleri 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ı.
Cursor'a IronPrint dokümantasyonunu nasıl verirsiniz?
IronPrint dokümantasyon bağlantısını her istekte veya proje kuralında tüm ekip için bir kez koyun. IronPrint'in llms.txt'si her kılavuzu, örneği ve sorun giderme sayfasını bir özetle listeler ve llms-full.txt 33 dokümantasyon sayfasının özetlerini içerir. Ekim 2026 itibarıyla, Cursor, @ menüsünde klasörler, dosyalar, geçmiş sohbetler, tarayıcı, terminaller ve Git farklarını listeler, böylece ajan IronPrint'in dokümantasyonunu bir bağlantı olarak alır.
Dokümantasyon, null bir yazıcı adı varsayılan yazıcıyı seçtiğini belirtir ve IronPrint'in bir yazıcı adı belirtme kılavuzu ise uyumsuz bir adın sessizce başarısız olduğunu veya bir hata fırlattığını söyler. Test sırasında bu sonuçların hiçbiri gerçekleşmediğinden, proje kuralı ölçülen davranışı kaydeder.
@src/DespatchDesk/Printing/ReprintService.cs
Answer five questions about IronPrint without editing any files:
1. What unit does the Margins class use?
2. Which sides does each value of new Margins(10, 20) set?
3. What does Printer.Print do when PrintSettings.PrinterName is null?
4. What do the docs say about a name GetPrinterNames doesn't return, and does the rule agree?
5. Does NumberOfCopies always produce that many copies?
Base each answer on https://ironsoftware.com/print/csharp/llms.txt or a page linked from it.
Check them against the printers output from the last turn where that helps.
Cite the page behind each answer.
If no page covers a question, say so plainly rather than guess.
IronPrint geleneklerini kodlayan proje kurallarını nasıl yazarsınız?
Proje kuralları, .cursor/rules içinde saklanan ve depoya taahhüt edilen .mdc dosyalarıdır, böylece her klon aynı kuralları yükler. Cursor'un kurallar sistemi, orada ön bilgi taşımadığı için düz bir .md dosyasını yoksayar.
Aşağıdaki kuralı .cursor/rules/ironprint-despatch.mdc olarak kaydedin. globs set edilmiş ve alwaysApply false olduğunda, Cursor istek bağlamında src/DespatchDesk veya testler altındaki bir C# dosyası olduğunda iliştirir ve diğer isteklerde eklemez.
---
description: IronPrint conventions for the despatch printing code
globs: src/DespatchDesk/**/*.cs, tests/**/*.cs
alwaysApply: false
---
Despatch printing code uses IronPrint and follows these rules:
- Print with IronPrint only.
- Reference IronPrint 2026.10.1 from NuGet and use its IronPrint namespace.
- Do not add another printing package.
- Move existing code to IronPrint only when a request asks for it.
- The IronPrint docs index is https://ironsoftware.com/print/csharp/llms.txt.
- Read the license key from the IRONPRINT_LICENSE_KEY variable.
- Keep the license key out of output and files.
- IronPrint Margins uses whole millimeters, as left, top, right, bottom.
- System.Drawing.Printing.Margins uses hundredths of an inch, as left, right, top, bottom.
- new Margins(a, b) sets left and right to a, and top and bottom to b.
- Printer.Print sends the job to the default printer if PrinterName is not an exact installed name.
- Check the name against Printer.GetPrinterNames before every job.
- Run the print and reprint commands only when I ask for them.
- Check settings with the jobs and reprint-jobs reports instead.
- If an IronPrint member is not in the docs, say that and cite the page you searched.
- Never make up an IronPrint member.
Cursor'un kurallar sayfasına göre, Ajan kuralları kullanır ancak Sekme kullanmaz ve kullanıcı kuralları satır içi düzenlemelere dahil edilmez. Önerileri el ile kontrol edin.
System.Drawing.Printing ayarlarını IronPrint ile nasıl eşleştirirsiniz?
IronPrint kullanma isteği, her PrintDocument ayarını hangi IronPrint ayarının değiştirdiğini belirtmez. Aşağıdaki tablo o eşlemeyi verir.
| System.Drawing.Printing | IronPrint |
|---|---|
PrinterSettings.PrinterName | PrintSettings.PrinterName |
PageSettings.PaperSize, santimetrelerin yüzde biri cinsinden boyutlandırılmış | PaperSize enum'u, örneğin PaperSize.A4 |
PageSettings.Landscape | PaperOrientation.Landscape veya PaperOrientation.Portrait |
PageSettings.Margins, santimetrelerin yüzde biri, sol, sağ, üst, alt | PaperMargins ile bir Margins değeri, tam milimetreler, sol, üst, sağ, alt |
PrinterSettings.Copies | NumberOfCopies |
PageSettings.Color false olarak ayarlandı | Grayscale true olarak ayarlandı |
PrintDocument.Print ile bir PrintPage işleyici | Printer.Print ile bir dosya yolu ve ayarlar |
50 ayarlanmış bir kenar boşluğu 12.7 milimetredir ve yapılandırıcı sadece tamsayıları aldığından 13'e yuvarlanır. IronPrint'in kağıt boyutu kılavuzu dört değer sırasını üst, sağ, alt, sol olarak listeler, ancak gönderilen XML dokümantasyonu ve kütüphanenin bir probu sol, üst, sağ, alt olarak verir.
IronPrint'e bir geçişi nasıl planlar ve uygularsınız?
Shift+Tab, sohbetin modlarını döndürür. Plan Modunda durun ve aşağıdaki isteği gönderin. Cursor, planı bir markdown dosyasına kaydeder, onaydan önce düzenlenebilir.
@src/DespatchDesk/Printing/ @TestData/expected-jobs.tsv
Plan the move of DespatchJobs from System.Drawing.Printing to IronPrint.
Write no code until I approve.
ReprintService already uses IronPrint, so keep it out of this plan.
The plan needs to cover these points:
- Each PrintDocument setting DespatchJobs uses, with its PrintSettings replacement or none.
- How margins in hundredths of an inch become IronPrint margins, including the order of the sides.
- How the jobs command keeps its columns and its values.
Keep config/despatch.json, JobSummary and the public Describe and Print signatures unchanged.
Where something is unclear, write down the assumption you made.
Planın yanlış olduğu yeri düzenleyin. Onaylamak için, Derleyi tıklayın veya Ajan moduna geri dönüp bu isteği gönderin.
@ironprint-despatch
Go ahead with the approved plan.
TestData/expected-jobs.tsv holds the jobs report the despatch office signed off.
A row matches when all eight columns agree with it.
Then follow these four steps:
1. Run `dotnet run --project src/DespatchDesk -- jobs` and count the matching rows.
2. Move DespatchJobs to IronPrint.
3. Remove System.Drawing.Common from the project file.
4. Build the solution and run the jobs command a second time.
Tell me the match count before and after the move, then show me the diff.
@ironprint-despatch, kuralı ada göre isteğe ekler. İş raporu, hiç kimseye bağlı bir yazıcı olmadan, belgelerin her birinin ayarlarını yazdırır, bu nedenle karşılaştırma, yazıcı bağlı olmayan bir makinede çalışır.
Değişimin her birine hangi Cursor özelliği uyar?
Değişikliğin boyutuna göre özelliği seçin. Sekme, zaten devam etmekte olan bir düzenlemenin geri kalanını sunar. Satır içi düzenleme (Ctrl+K) seçili kodu tek cümlelik bir talimattan değiştirir. Ajan, birden fazla dosyayı kapsayan veya bir yapı gerektiren bir değişiklik için uygundur. Yanlış bir değişikliği geri almak plan yazmaktan daha uzun sürüyorsa, Plan Modu ek bir adıma değer ve bir Bulut Ajanı gözetimsiz işi halleder.
DespatchJobs'un Yazdır metodunu seçin ve Ctrl+Shift+L veya macOS'ta Cmd+Shift+L ile sohbeti bağlam olarak ekleyin. Ardından, bu isteği Ajan modundan gönderin.
Make DespatchJobs.Print refuse a printer that isn't installed:
- Check the name against Printer.GetPrinterNames before anything is sent.
- Use an ordinal, case-sensitive comparison so spaces and case must match too.
- If it's missing, throw an error whose message includes every installed printer name.
- Have the print command show that message and exit with code 2.
Then run these two commands and show me what each one prints:
`dotnet run --project src/DespatchDesk -- print packing-slip`
`dotnet run --project src/DespatchDesk -- print packing-slip --printer "adobe pdf"`
İkinci komut, yalnızca büyük küçük harf değişikliğiyle yüklü bir yazıcı adından farklıdır.
IronPrint bir yazıcı adı bulamazsa ne olur?
Eski hizmet bir hata ile durdu. System.Drawing.Printing, "Despatch-A4-01 yazıcısına erişim ayarlarınız geçerli değil." mesajıyla bir InvalidPrinterException attı. IronPrint 2026.10.1, bu ad için ve üç diğer ad için yakalanan işi varsayılan yazıcıya yönlendirdi. Bunlar, IronPrint'in kenar boşlukları kılavuzundan alınan örnek yazıcı adı, küçük harfle yazılmış yüklü bir yazıcı adıdır ve sonuna boşluk eklenmiş aynı yazıcıdır.
Sınama makinesinin varsayılan yazıcısı olan Microsoft Print to PDF, bir dosya adı ister, bu nedenle gözetimsiz bir hizmet, Dosya olarak Kaydet iletişim kutusunda dururdu. yazıcı adları kılavuzu, her döndürülen adın Windows yazıcı ayarlarında adı tam olarak eşleştirdiğini ve böylece her işten önce çalıştırılacak Printer.GetPrinterNames kontrolü için sıralı bir karşılaştırma yapıldığını belirtir.
Farklı iki yazdırma yolunu nasıl ayıklarsınız?
Yeniden yazdırma kiosk kodu zaten IronPrint kullanıyordu ve ayar raporu çıktı alınmış raporla her satırda anlaşmazlık gösteriyor.
@src/DespatchDesk/Printing/ReprintService.cs @TestData/expected-jobs.tsv
Find out why the reprint report disagrees with expected-jobs.tsv on every row.
The jobs report matches it, and both read config/despatch.json.
Work through these steps before changing any code:
1. Run the reprint-jobs command and the jobs command, and compare them.
2. List each column where reprint-jobs differs, per document type.
3. Explain what ReprintService does to cause each difference.
Then fix ReprintService and keep it on IronPrint.
Give its Print method the same printer check.
Keep the check out of BuildSettings and Describe, since reprint-jobs reads those.
Run reprint-jobs again and tell me how many rows match, before and after the fix.
Anlaşmazlığın iki nedeni var. Kiosk kodu, doğrudan iki değerli yapılandırıcıya yüzdelik santim verir, böylece bir ambalaj fişi 50 milimetre kenar boşluğu raporlar ve iade notu altında yapılandırmanın 80 santimetre belirlediği üst değerini tekrarlar. Ayrıca, raf etiketleri için yazıldığı için her belgeyi manzara yönlendirme olarak ayarlar.
Çıktı
Düzeltmeden önceki çalışmadan bir çekimde, manzara yönlendirme ile gönderilen portre ambalaj fişi, 297 x 210 milimetre sayfaya yerleştirildi. Sayfası 148.4 x 209.9 milimetre ölçeklendirildi ve sayfanın diğer 148.5 milimetresi boş kaldı.
IronPrint, işi oluşturan sabitlenmemiş ReprintService ayarları ile, bir yazıcı yerine bir dosyaya yazıldı.
IronPrint yazıcıya ne gönderir?
Test makinesindeki dört yazıcıdan hiçbiri gözetimsiz bir işi tamamlamaz, bu nedenle kağıt üzerine hiçbir şey yazdırılmadı. Bu ölçümler için, kenar boşlukları kılavuzunun örnekleri ve göç eden hizmet değişmeden çalıştırıldı ve yalnızca Windows yazdırma işlemine son çağrı değiştirildi. Bu çağrıda, bir yama her işin sayfalarını ve yazdırma biletini bir XPS dosyası olarak kaydetti ve yazdırma kuyruğuna hiçbir şey gönderilmedi. Aşağıdaki ölçümler bu dosyalardan gelir ve bir yazıcının ne alacağını açıklar.
- Kenar Boşlukları: 0, 10, 15, 20, 30 ve 50 milimetrelik kenar boşlukları için üretilen sayfalar identikti ve sayfa resmi sayfayı doldurdu. System.Drawing.Printing versiyonundaki ambalaj fişi, resmini 12.7 milimetre kenar boşlukları içinde çizdi.
- Gri Tonlama: bir PNG sayfası için, ayar yalnızca yazdırma biletini değiştirdi ve resim renkli kaldı. Bir PDF sayfası için, resim gri tonlamadaydı.
- Çözünürlük: Bir PDF,
Dpiayarında, A4 için 300'de 2479 x 3508 piksel olarak render edildi. Bir PNG kendi piksel boyutunda gönderildi.
IronPrint PaperMargins'yi Windows üzerinde sayfaya uygulayana kadar, kenarlarda boş alan ihtiyacı olan bir düzeni belge kendi içinde taşımak zorundadır.
Giriş
Hizmet, TestData/jobs'dan slip-1001.png, labels-aisle-07.png ve return-2207.png olmak üzere üç PNG dosyası yazdırır. Her biri, kenarlarında kırmızı bir sınır olan 150 DPI görüntüdür.
Çıktı
Aşağıdaki PDF'ler, Cursor'ın yazdığı koddan her bir iş için bir iş gösterir. Her sayfa görüntüsü değiştirilmemiştir ve yakalanan sayfanın boyutunu korur.
IronPrint'in işi oluşturduğu ambalaj fişi, bir yazıcı yerine bir dosyaya yazıldı.
IronPrint'in işi oluşturduğu raf etiketler, bir yazıcı yerine bir dosyaya kaydedildi.
Iade notu, IronPrint'in işi oluşturduğu gibi, bir yazıcı yerine bir dosyaya kaydedildi. Tek bir A5 portre sayfası ölçüleri 148 x 210 milimetredir ve yazdırma bileti tek renkli çıktı ayarlıdır.
Yazdırma kodu için gerileme testlerini nasıl yazarsınız?
Cursor'ın Bulut Ajanları, Ubuntu makinelerinde çalışır ve örnek net9.0-windows'u hedefler, bu nedenle bu isteği yerel bir Ajan sohbetinde gönderin.
@tests/DespatchDesk.Tests/ @TestData/
Write xUnit tests for DespatchJobs and ReprintService. None of them may send a print job.
Cover these cases with tests:
- Describe returns every row of TestData/expected-jobs.tsv, for both classes.
- The returns note reports a 20 mm bottom margin.
- Print throws when the printer is missing from GetPrinterNames.
- That error message names each printer GetPrinterNames returns when the test runs.
- An installed printer name with its case changed is refused as well.
- Hundredths of an inch convert to the millimeters in expected-jobs.tsv.
Link config and TestData from the repo root into the test output, keeping their relative paths.
Leave expected-jobs.tsv as it is, then run dotnet test.
Tell me how many tests passed and how many failed.
Red testi, yüklü olmayan yazıcı adlarını kullanır, bu yüzden Printer.Print çağrılmadan önce yazıcı kontrolünde dururlar.
AI kodlama asistanları kılavuzu, bir IronPrint görevini boş bir klasörden yazılı geçiş kriterlerine karşı kontrol edilen bir sonuca götürür.
Gerçek bir çalıştırmada istemler ne üretti?
Cursor, yönerge örnek deposuna karşı sırayla yedi yönlendirme aldı. Çalıştırmadan sonra, değişen her kod taahhüdünün, aşağıdaki her raporu ve komutu tekrarlayan taze Yayın yapıları meydana geldi.
- IronPrint'e geçtikten önce ve sonra, işler raporu yerleşik raporun 3 satırının tümünü eşleştirdi.
- Düzenli rapor, hatadan önce 3 satırdan 0'ını ve hatadan sonra 3'ün 3'ünü eşleştirdi.
- Yazıcılar komutu, tepsileri ile dört yüklenmiş yazıcıyı ve iki yapılandırılmış yazıcıyı yüklü değil olarak işaretledi.
- Cursor'ın beş dokümantasyon yanıtının her biri bir sayfa alıntıladı ve hiçbir dosya değişmedi.
- GetPrinterNames'ın dönüş yapamadığı bir ad için, Cursor, kılavuzun ifadesini yineledi ve proje kuralının farklı bir sonuç tarif ettiğini not düştü.
- Plan, belge adı için hiçbir PrintSettings yedeği bulamadı ve bunu bir varsayım olarak kaydetti.
- Geçişten sonra uygulama yalnızca IronPrint paketine referans veriyordu ve hiçbir System.Drawing.Printing kode taşımıyordu.
- DespatchJobs, açık Describe ve Print imzalarını korudu.
- Yazdırma komutu, üç belgenin her biri için ayarlanmış yazıcıyı, dört yüklü yazıcının listesi ve çıkış kodu 2 ile reddetti.
- Yazıcı kontrolü, küçük harfle yazılmış veya sonunda bir boşlukla girilmiş yüklü Adobe PDF yazıcısını da reddetti.
- Düzeltmeden önce, yeniden yazdırma komutu, eksik ayarlanmış yazıcı ve "adobe pdf" için işleri varsayılan yazıcıya gönderdi.
- Düzeltmeden sonra, yeniden yazdırma komutu her iki adı da reddetti. Kodu durduran istisna ile durduruldu, çünkü talimat 06 çıkış kodu istemiyordu.
- Tüm 9 xUnit testi geçti. Beş test metodundan geldiler ve hiçbiri bir iş göndermedi.
- Çalıştırma, yapılandırma, test verileri ve proje kuralını değiştirmeden bıraktı.
- Her Yayın derlemesi, 0 uyarı ve 0 hata ile bitirdi ve hiçbir dosya el ile düzenlenmedi.
- Bazı adımlar sayfadan farklı çalıştı. Her yönlendirme, tek bir yerel masaüstü sohbette el ile gönderildi. Yönlendirme 04 önce gönderilmeden kopyalandı, sonra çalıştırmanın günlük betiği, sohbette eksik olduğunu rapor ettikten sonra gönderildi. Plan, Agent'a yönlendirme 04 gönderilerek onaylandı ve Build asla tıklanmadı. Cursor'ın geçişi, önerilen plana göre zaten yazıcı adını kontrol etti, bu yüzden talimat 05 var olan bir kontrolü değiştirdi.
GitHub Copilot kılavuzu ayrıca depo içinde yol özgüllüğünde talimat dosyalarını da tutar ve Google Antigravity kılavuzu baskı sayfasını gerçek bir tarayıcıda test eder. çalıştırma kaydı, her kılavuz için araç versiyonunu, modeli, süresini ve test makinesini listeler.
Hata Ayıklama
- Nasıl Yazıcı Adları Alınır? adı belirtilen bir yerine varsayılan yazıcıya giden bir iş için
- Kenar Boşlukları Nasıl Ayarlanır? kenar boşluklarını santimlerin yüzde birinden çevirirken
- C# Yazdırma Ayarları her ayarın varsayılan değeri için
- Lisans Anahtarlarını Kullanma oluşturulan yazdırma kodu bir lisanslama istisnasıyla başarısız olduğunda
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.