Jak używać IronPrint z Cursorem

Curtis Chau
Curtis Chau
Zaktualizowano: 26 października 2026

Kiedy agent AI przenosi usługę drukowania C# z System.Drawing.Printing do IronPrint, ustawienia kopiowane bez zmian nadal kompilują się, ale zmieniają swoje znaczenie. Margines 50 w starym kodzie oznacza pół cala, podczas gdy to samo 50 w IronPrint oznacza 50 milimetrów. Nazwy drukarek również przechodzą bez zmian. W naszych testach, IronPrint wysłał zadanie do drukarki o nazwie, która nie była zainstalowana, do domyślnej drukarki bez generowania błędu.

Cursor, oparty na kodzie źródłowym VS Code, dodaje agenta do edytora. Czy migracja zachowuje te szczegóły, zależy od dwóch cech Cursora, linków do dokumentacji podanych agentowi oraz zatwierdzonych zasad projektu w .cursor/rules. Przykłady dotyczą zarówno usługi biurowej do wysyłki, która drukuje listy pakowania, etykiety półkowe i noty zwrotne. Usługa buduje każde zadanie z pliku konfiguracyjnego w setnych częściach cala, a podpowiedzi przenoszą je do IronPrint.

Szczegóły na temat zaangażowanych ustawień znajdują się w przewodniku po marginesach papieru i przewodniku po nazwach drukarek.

Szybki start
NuGetInstalacja z NuGet

PM > Install-Package IronPrint

Zainstaluj IronPrint, wykonując powyższe polecenie w konsoli Menedżera Pakietów NuGet lub wyszukaj pakiet w Menedżerze Pakietów NuGet.

Otworzyć repozytorium wysyłki, rozpocząć nowy czat agenta i wysłać tę podpowiedź.

@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.
Text

Nigdy nie wklejaj klucza licencyjnego do czatu. Agent Cursora może edytować pliki i wykonywać polecenia powłoki, więc może skopiować wklejony klucz do wiadomości zatwierdzającej, pliku źródłowego lub dziennika budowania. Podpowiedź przypisuje IRONPRINT_LICENSE_KEY do License.LicenseKey, ponieważ ustawienie zmiennej pozostawiło IronPrint 2026.10.1 bez licencji podczas testów. W próbie bez klucza, IronPrint wymienił drukarki i tace, a Printer.Print wyrzucił AggregateException wokół LicensingException przed wysłaniem jakiegokolwiek zadania. Przewodnik po kluczach licencyjnych wymienia miejsca, z których IronPrint czyta klucz, takie jak appsettings.json.



Który model Cursora należy użyć do pracy z IronPrint?

Composer to własny agentyczny model Cursor. Wybór modelu oferuje także modele SpaceXAI Grok, które Cursor współtworzył, oraz modele od OpenAI, Anthropic, Google i innych laboratoriów. Test przeprowadzony poniżej używał wersji Grok 4.7.

Jak przekazać dokumentację IronPrint do Cursora?

Umieść link do dokumentacji IronPrint w każdym żądaniu lub raz w zasadzie projektu dla całego zespołu. llms.txt IronPrint wymienia każdy przewodnik, przykład i stronę rozwiązywania problemów z podsumowaniem, a llms-full.txt zawiera streszczenia 33 stron dokumentacji. Od października 2026 r. Cursor wymienia foldery, pliki, przeszłe czaty, przeglądarki, terminale i różnice Git w swoim @ menu, więc agent otrzymuje dokumentację IronPrint jako link.

Dokumentacja stwierdza, że pusta nazwa drukarki wybiera domyślną drukarkę, a przewodnik IronPrint o specyfikowaniu nazwy drukarki mówi, że niezgodna nazwa milczy lub wyrzuca błąd. Żadne z tych wyników nie wystąpiło podczas testów, więc zasada projektu zapisuje zmierzone zachowanie zamiast tego.

@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.
Text

Jak pisać zasady projektowe, które kodują konwencje IronPrint?

Zasady projektowe to pliki .mdc przechowywane w .cursor/rules i zatwierdzane do repozytorium, więc każdy kloń ładuje te same zasady. System zasad Cursora ignoruje zwykły plik .md, ponieważ nie posiada on frontmatter.

Zapisz poniższą zasadę jako .cursor/rules/ironprint-despatch.mdc. Z ustawionym globs i alwaysApply jako false, Cursor dołącza go, gdy plik C# z katalogu src/DespatchDesk lub testy jest w kontekście żądania, i pomija go w innych żądaniach.

---
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.
Markdown
Uwaga: Cursor odczytuje również pliki AGENTS.md w korzeniu projektu i w podkatalogach. AGENTS.md jest zwykłym markdownem bez frontmatter, więc nie może przechowywać globów, od których zależy ta zasada.

Według strony z zasadami Cursora, Agent używa zasad, ale Tab nie, i zasady użytkownika są pomijane w edycji online. Ręcznie sprawdź sugestie Taba i edycji inline w odniesieniu do tej zasady.

Jak zamapować ustawienia System.Drawing.Printing do IronPrint?

Żądanie korzystania z IronPrint nie mówi, które ustawienie IronPrint zastępuje każde ustawienie PrintDocument. Poniższa tabela przedstawia to mapowanie.

System.Drawing.PrintingIronPrint
PrinterSettings.PrinterNamePrintSettings.PrinterName
PageSettings.PaperSize, mierzone w setnych częściach calaEnumaracja PaperSize, takie jak PaperSize.A4
PageSettings.LandscapePaperOrientation.Landscape lub PaperOrientation.Portrait
PageSettings.Margins, setne części cala, lewy, prawy, górny, dolnyPaperMargins z wartością Margins, całe milimetry, lewy, górny, prawy, dolny
PrinterSettings.CopiesNumberOfCopies
PageSettings.Color ustawione na falseGrayscale ustawione na true
PrintDocument.Print z handlerem PrintPagePrinter.Print ze ścieżką pliku i ustawieniami

Skonfigurowany margines 50 to 12,7 milimetra, co zaokrągla się do 13, ponieważ konstruktor przyjmuje tylko całe liczby. Przewodnik po rozmiarze papieru IronPrint wymienia kolejność czterech wartości jako górny, prawy, dolny, lewy, podczas gdy dostarczona dokumentacja XML i próba biblioteki podają lewy, górny, prawy, dolny.

Jak zaplanować i przeprowadzić migrację do IronPrint?

Shift+Tab przełącza tryby czatu. Należy zatrzymać się na trybie planowania i wysłać poniższe żądanie. Cursor zapisuje plan do pliku markdown, który można edytować przed zatwierdzeniem.

@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.
Text

Edytować plan tam, gdzie jest błędny. Aby go zatwierdzić, kliknąć Buduj lub wrócić do trybu agenta i przesłać to żądanie.

@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.
Text

Wzmianka @ironprint-despatch dodaje zasadę do żądania po nazwie. Raport zadań drukuje ustawienia każdego dokumentu bez wysyłania zadania, dzięki czemu porównanie działa na maszynie bez podłączonej drukarki.

Która funkcja Cursor pasuje do każdej zmiany?

Wybierz funkcję na podstawie wielkości zmiany. Tab oferuje resztę edycji już w toku. Edycja inline (Ctrl+K) zmienia zaznaczony kod na jednozdaniową instrukcję. Agent pasuje do zmiany, która obejmuje kilka plików lub wymaga kompilacji. Tryb planowania jest wart dodatkowego kroku, gdy cofnięcie błędnej zmiany trwa dłużej niż napisanie planu, a Agent Chmurowy obsługuje pracę bez nadzoru.

Wybrać metodę Print w DespatchJobs i dodać ją do czatu jako kontekst za pomocą Ctrl+Shift+L, lub Cmd+Shift+L na macOS. Następnie przesłać to żądanie z trybu Agenta.

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"`
Text

Drugie polecenie różni się od zainstalowanej nazwy drukarki tylko wielkością liter.

Co się dzieje, gdy IronPrint nie może znaleźć nazwy drukarki?

Stara usługa kończyła się błędem. System.Drawing.Printing wyrzucił InvalidPrinterException z wiadomością "Ustawienia dostępu do drukarki 'Despatch-A4-01' są nieprawidłowe." IronPrint 2026.10.1 skierował zapisane zadanie dla tej nazwy, i dla innych trzech nazw, do domyślnej drukarki. Były to przykładowe nazwy drukarek z przewodnika po marginesach IronPrint, zainstalowana drukarka wpisana małymi literami oraz ta sama drukarka z końcową spacją.

Microsoft Print to PDF, która była domyślną drukarką maszyny testowej, prosi o nazwę pliku, więc usługa bez nadzoru zatrzymałaby się na oknie dialogowym Zapisz jako. Przewodnik po nazwach drukarek stwierdza, że każda zwrócona nazwa dokładnie odpowiada nazwie w ustawieniach drukarki Windows, co czyni porównanie ordinalne z Printer.GetPrinterNames kontrolą, którą należy przeprowadzić przed każdym zadaniem.

Jak debugować dwie ścieżki drukowania, które się nie zgadzają?

Kod kiosku do ponownego wydruku już korzystał z IronPrint, a jego raport z ustawień nie zgadza się z zatwierdzonym raportem w każdym wierszu.

@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.
Text

Nieporozumienie ma dwie przyczyny. Kod kiosku przesyła setne bezpośrednio do konstruktora dwu-wartościowego, więc listy pakowania zawierają marginesy 50 milimetrów, a nota zwrotna powtarza swoją wartość górną na dole, gdzie konfiguracja ustawia 80 setnych. Ustawia również orientację krajobrazową dla każdego dokumentu, ponieważ została napisana dla etykiet półkowych.

Wynik

W przechwyceniu z uruchomienia przed poprawką, portretowa lista pakowania wysłana z orientacją krajobrazową była rozmieszczona na arkuszu o wymiarach 297 na 210 milimetrów. Strona była skalowana do 148.4 na 209.9 milimetrów, a inne 148.5 milimetrów arkusza pozostały puste.

Listy pakowania z ustawieniami niepoprawionego ReprintService, jak IronPrint zbudował zadanie, przechwytywane do pliku zamiast drukarki.

Co wysyła IronPrint do drukarki?

Żadna z czterech drukarek na maszynie testowej nie ukończyła zadania bez nadzoru, więc nic nie zostało wydrukowane na papierze. Dla tych pomiarów, próbki z przewodnika po marginesach i zmigrowana usługa niezmiennie działały, i tylko ostateczne wywołanie do drukowania Windows zostało zastąpione. Przy tym wywołaniu, łatka zapisała strony każdego zadania i bilet do druku jako plik XPS, a kolejka druku nie otrzymała niczego. Poniższe pomiary pochodzą z tych plików i opisują, co otrzymałaby drukarka.

  • Marginesy: marginesy 0, 10, 15, 20, 30 i 50 milimetrów wyprodukowały identyczne strony, z obrazem strony wypełniającym arkusz. Wersja System.Drawing.Printing listy pakowania narysowała swój obraz wewnątrz marginesów 12.7 milimetra.
  • Skala szarości: dla strony PNG ustawienie zmieniło tylko bilet do druku, a obraz pozostał w kolorze. Dla strony w formacie PDF obraz był szary.
  • Rozdzielczość: plik PDF był renderowany przy ustawieniu Dpi, 2479 na 3508 pikseli dla A4 przy 300. Plik PNG został wysłany w swoim własnym rozmiarze pikselowym.

Dopóki IronPrint nie zastosuje PaperMargins do strony w Windows, układ, który potrzebuje pustych spacji na krawędziach, musi je zawierać w samym dokumencie.

Dane wejściowe

Usługa drukuje trzy pliki PNG z TestData/jobs, slip-1001.png, labels-aisle-07.png i return-2207.png. Każdy z nich to obraz o rozdzielczości 150 DPI z czerwoną obwódką na krawędziach.

Packing slip 1001 input image, A4 portrait with a red border Shelf labels for aisle 07 input image, A4 landscape with a red border Returns note 2207 input image, A5 portrait with a red border

Wynik

Poniższe pliki PDF pokazują jedno zadanie z każdego kodu napisanego przez Cursora. Każdy obraz strony jest niezmieniony i zachowuje rozmiar przechwyconej strony.

Listy pakowania, jak IronPrint zbudował zadanie, przechwycone do pliku zamiast drukarki. Zadanie zawiera jedną stronę A4 w orientacji pionowej, a bilet do druku prosi o dwie kopie w monochromie.

Etykiety półkowe, jak IronPrint zbudował zadanie, przechwycone do pliku zamiast drukarki. Ta strona A4 w orientacji poziomej ma wymiary 297 na 210 milimetrów, a bilet do druku określa kolorowy wynik.

Nota zwrotna, jak IronPrint zbudował zadanie, przechwycone do pliku zamiast drukarki. Jego pojedyncza strona A5 w orientacji pionowej ma wymiary 148 na 210 milimetrów, a monochromatyczny wynik jest ustawiony w bilecie do druku.

Jak pisać testy regresji dla kodu drukowania?

Agenci Chmurowi Cursora uruchamiają się na maszynach Ubuntu, a przykładowy cel to net9.0-windows, więc należy wysłać to żądanie na lokalnym czacie Agenta.

@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.
Text

Testy odmowy używają nazw drukarek, które nie są zainstalowane, więc zatrzymują się na kontroli drukarki przed wywołaniem Printer.Print.

Przewodnik po asystentach kodowania AI bierze jedno zadanie IronPrint z pustego folderu do wyniku sprawdzonego z odpowiednimi kryteriami.

Co wyprodukowały zapytania w rzeczywistym uruchomieniu?

Cursor otrzymał siedem podpowiedzi w kolejności z próbki repozytorium wysyłki. Po przeprowadzeniu, świeże kompilacje Release każdego zatwierdzenia, które zmieniło kod, powtórzyły każdy raport i polecenie poniżej.

  • Przed przeniesieniem do IronPrint i po nim raporty zadań odpowiadały wszystkim 3 wierszom zatwierdzonego raportu.
  • Raport z ponownego wydruku odpowiadał 0 z 3 wierszy przed poprawką i 3 z 3 po niej.
  • Polecenie z drukarkami wylistowało cztery zainstalowane drukarki z ich tacami i zaznaczyło obie skonfigurowane drukarki jako niezainstalowane.
  • Każda z pięciu odpowiedzi dokumentacji Cursora odwoływała się do strony i żaden plik się nie zmienił.
  • Dla nazwy, której GetPrinterNames nie zwraca, Cursor powtórzył oświadczenie przewodnika i zanotował, że zasada projektu opisuje inny wynik.
  • Plan nie znalazł zamiennika PrintSettings dla nazwy dokumentu i zapisał to jako założenie.
  • Po przeniesieniu, aplikacja odnosiła się tylko do pakietu IronPrint, i nie pozostał żaden kod System.Drawing.Printing.
  • DespatchJobs zachował swoje publiczne sygnatury Describe i Print.
  • Polecenie drukowania odmówiło skonfigurowanej drukarki dla wszystkich trzech typów dokumentów z kodem wyjścia 2 i listą czterech zainstalowanych drukarek.
  • Sprawdzanie drukarki odmówiło również zainstalowanej drukarki Adobe PDF wpisanej małymi literami lub z końcową spacją.
  • Przed swoją poprawką, polecenie reprint wysyłało zadania dla brakującej skonfigurowanej drukarki i dla "adobe pdf" do domyślnej drukarki.
  • Po poprawce, polecenie reprint odmówiło obu nazw. Zatrzymało się z nieobsługiwanym wyjątkiem, ponieważ podpowiedź 06 prosiła o brak kodu wyjścia.
  • Wszystkie 9 testów xUnit przeszły pomyślnie. Pochodziły z pięciu metod testowych i żaden nie wysłał zadania.
  • Uruchomienie pozostawiło konfigurację, dane testowe i zasadę projektu niezmienione.
  • Każda kompilacja Release zakończyła się 0 ostrzeżeniami i 0 błędami, i żaden plik nie został edytowany ręcznie.
  • Niektóre kroki uruchomiono inaczej niż na stronie. Każda podpowiedź została wysłana ręcznie w jednym lokalnym czacie na pulpicie. Podpowiedź 04 została najpierw wklejona bez wysłania, a została wysłana po tym, jak skrypt logowania uruchomienia zgłosił jej brak z czatu. Plan został zatwierdzony przez wysłanie podpowiedzi 04 w Agencie, i Buduj nigdy nie było kliknięte. Migracja Cursora już sprawdziła nazwę drukarki, jak proponował jej plan, więc podpowiedź 05 zmieniła istniejącą kontrolę.

Przewodnik GitHub Copilot również przechowuje pliki instrukcji specyficzne dla ścieżki w repozytorium, a przewodnik Google Antigravity testuje stronę wydruku w prawdziwej przeglądarce. Zapis rekordu uruchomienia wymienia wersję narzędzia, model, czas trwania i maszynę testową dla każdego przewodnika.


Rozwiązywanie problemów


Pytania?

Jeśli są jakiekolwiek pytania, należy skontaktować się z support@ironsoftware.com

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 52,106Wersja:2026.11właśnie wydane