IronQR와 Cursor 사용 방법

Curtis Chau
Curtis Chau
업데이트됨: 2026년 10월 9일

ZXing.Net은 ZXing 바코드 라이브러리의 오픈 소스 .NET 포트입니다. AI 에이전트에게 고객 사진에서 QR 코드를 읽는 C# 코드를 요청할 때 IronQR을 명시하더라도 ZXing.Net 관례를 적용할 수 있으며, 예를 들어 Result.Text를 비교하거나, QR_CODE 형식에서 필터링하거나, QrImageInput을 using 문으로 감쌀 수 있습니다. IronQR 2026.10.1에서는 그러한 방식으로 입력을 dispose할 경우 NotImplementedException이 발생합니다.

Cursor는 VS Code 코드베이스를 기반으로 한 AI 코드 에디터입니다. IronQR 코드를 생성할지 ZXing.Net 변환을 할지는 두 가지 기능에 따라 달려 있습니다. 에이전트는 제공된 문서 링크를 따르고, .cursor/rules에서 프로젝트 규칙을 적용합니다. 이 가이드는 고객 사진에서 일련번호와 등록 링크를 추출하는 보증 접수 서비스를 통해 두 가지 방법을 보여주며, 그 서비스를 ZXing.Net에서 IronQR로 이전합니다. IronQR은 QR, 마이크로 QR, rMQR 심볼을 지원합니다.

이 가이드는 Cursor로 코드를 작성하는 데 중점을 둡니다. IronQR의 읽기 옵션에 대한 자세한 내용은 스캔 모드 가이드, QR 유형 가이드, 값 및 좌표 가이드를 참조하십시오.

빠른 시작
NuGetNuGet으로 설치

PM > Install-Package IronQR

위 명령을 NuGet 패키지 관리자 콘솔에 입력하거나 NuGet 패키지 관리자에서 패키지를 검색하여 IronQR를 설치하십시오.

Cursor에서 접수 프로젝트를 열고 에이전트 패널에서 이 요청을 보냅니다.

@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

라이선스 키는 채팅 메시지에 포함하지 마십시오. 에이전트가 파일을 생성하고 터미널 명령을 실행하므로, 붙여넣은 키가 소스 코드, 커밋, 또는 로그에 포함될 수 있습니다. 라이선스 키 가이드는 지원되는 저장 위치를 나열합니다.



QR 코드 작업에 어떤 Cursor 모델을 사용해야 합니까?

Composer는 Cursor의 독자적 에이전트 모델입니다. 모델 선택자는 또한 Cursor와 공동 개발한 SpaceXAI의 Grok 모델 및 OpenAI, Anthropic, Google 기타 실험실의 모델을 제공합니다. 아래 테스트 실행은 Grok 4.7을 사용했습니다.

클레임 기록에 필드를 추가하거나 사진 폴더를 다시 실행하는 일상적인 사진 작업에는 빠른 모델이 적합합니다. 이유 없이 사진 배치가 디코딩을 멈추면, 더 긴 시간 동안 이유를 숙고하는 모델로 전환하십시오. 모델은 요청을 다르게 읽으므로, 각 요청에서 사진 폴더와 출력이 일치해야 하는 일련번호를 명시하십시오.

Cursor에 IronQR 문서를 어떻게 제공합니까?

IronQR의 문서 링크를 요청에 포함시키거나, 이를 규칙에 커밋하여 아무도 붙여넣지 않도록 하십시오. llms.txt 인덱스는 가이드와 API 레퍼런스를 연결하고, llms-full.txt은 44개의 문서 페이지를 하나의 파일로 요약합니다. 2026년 10월 기준으로, Cursor의 @ 메뉴는 파일, 폴더, 터미널, 채팅, Git diff 및 브라우저를 첨부하므로 IronQR의 문서가 에이전트에 링크로 도달합니다.

IronQR의 열거형은 쉽게 잘못 배치됩니다. QrScanMode와 QrEncoding은 IronQr.Enum에 있고, QrErrorCorrectionLevel은 IronQr에 있으며, 잘못하면 메모리에서 작성된 코드는 빌드에 실패합니다.

@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
팁: 페이지가 없는 답변은 API 레퍼런스에서 멤버를 찾기 전까지 확인되지 않은 것으로 취급하세요.

IronQR 관례를 인코딩하는 프로젝트 규칙을 어떻게 작성합니까?

프로젝트 규칙은 .mdc 파일이며, .cursor/rules에 있습니다. 그들은 코드와 함께 커밋되어, 모든 클론이 동일한 규칙을 얻습니다. 그 폴더에 있는 일반 .md 파일은 적용할 때를 나타내는 프론트메터가 없기 때문에 무시됩니다.

이 규칙은 globs을 설정하고 alwaysApply를 꺼둡니다. 따라서 읽기기 또는 그 시험이 맥락에 있을 때마다 부착되며, 사진을 전혀 다루지 않는 요청에는 존재하지 않습니다. 이를 .cursor/rules/ironqr-photos.mdc로 저장하십시오.

---
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
유의 사항: Cursor는 또한 프로젝트 루트 및 하위 디렉터리에서 AGENTS.md를 읽습니다. 프론트메터가 없으므로 파일 패턴에 따라 범위를 지정할 수 없습니다. 패턴 범위 IronQR 규칙을 .cursor/rules에 유지하십시오.

규칙은 에이전트 요청에 적용됩니다. Cursor의 문서에 따르면, 그들은 탭에 영향을 주지 않으며, 사용자 규칙은 인라인 편집에 적용되지 않습니다. 이메일의 제안 된 기능을 규칙과 대조하세요.

ZXing.Net 호출을 IronQR에 매핑하는 방법은?

"IronQR 사용"이라고만 명시된 규칙은 ZXing.Net 호출이 무엇으로 되는지 모델이 추측하게 만듭니다. 대등물을 나열하면 추측을 제거합니다.

ZXing.Net 또는 QRCoderIronQR
BarcodeReader 디코드 호출Read를 사용하는 QrReader로, 모든 코드를 반환합니다.
Result.TextQrResult.Value
QR_CODE 형식 검사 및 필터링읽기 후 QrResult.QrType에 대한 검사
더 깊은 스캔 옵션입력에서의 스캔 모드
Result.ResultPoints, 패턴 중심QrResult.Points, 네 모서리
QRCoder의 생성기QrWriter.Write 및 그 저장 호출

ZXing.Net의 BarcodeFormat 열거형에는 Micro QR 또는 rMQR 멤버가 없고, 이 README는 QR 코드만 나열하며, 더 작은 심볼은 없으므로 ZXing.Net 리더는 Micro QR 일련번호만 있는 스티커에 대해 아무 것도 반환하지 않습니다.

표를 규칙에 두 줄 더 추가하십시오.

- 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로 이전을 계획하고 실행하는 방법은?

Shift+Tab을 눌러 채팅을 계획 모드로 전환한 후 이 요청을 보내면 Cursor가 편집할 수 있는 파일로 계획을 작성합니다.

@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

플랜에서 잘못된 부분을 수정한 후 Build를 클릭하거나 다음 요청을 에이전트에 보냅니다.

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

@ 메뉴에서 선택한 @ironqr-photos는 이름으로 규칙을 부착하며, 그 글롭이 파일을 놓쳤더라도 부착합니다. 깨끗한 빌드는 Micro QR 일련번호가 반환되는지 여부를 보여주지 않습니다. 일치 횟수가 그렇습니다.

Cursor의 어떤 기능이 각 변경에 적합합니까?

변경이 얼마나 먼지에 따라 하나를 선택하세요. 탭은 예측 가능한 다음 편집을 처리하며, 인라인 편집은 한 문장으로 덮을 수 있는 하나의 선택을 처리합니다. 에이전트는 여러 파일, 규칙, 또는 빌드 루프가 필요한 변경 사항을 가져갑니다. 잘못된 변경을 취소하는 데 더 많은 비용이 들 때 계획 모드가 유리하며, 클라우드 에이전트는 누군가가 볼 필요 없는 작업에 적합합니다.

새 제품 라인은 일련번호가 rMQR 코드에 있는 직사각형 케이블 태그를 추가하며, 이는 IronQR에서는 QrEncoding.RMQRCode로 보고합니다. 리더에서 결과 루프를 선택하고 Ctrl+Shift+L(Cmd+Shift+L on macOS)을 눌러 선택을 채팅에 추가한 다음, 이 요청을 에이전트에서 보냅니다.

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

이전의 리더는 태그 사진에 대해 이미 SN-61518을 반환했습니다. 그 이유는 URL이 아닌 모든 값을 일련번호로 간주했기 때문입니다. 편집은 그 추측을 기호 유형 검사로 대체하므로, Micro QR 또는 rMQR 값은 텍스트가 URL과 같아 보여도 일련번호로 변환됩니다.

누락된 QR 코드 값을 디버깅하는 방법은?

각 스캔 모드는 반환되는 내용을 변경합니다.

  • Auto은 기본값입니다. IronQR의 API 레퍼런스는 이를 기계 학습 모델로 설명하며, 모델이 아무 것도 찾지 못할 때 기본 강제 읽기(fallback)를 설명합니다.
  • 기본 강제 읽기는 모델 생략 상태에서 OnlyBasicScan로 단독 실행됩니다.
  • OnlyDetectionModel는 코드를 디코딩하지 않고 찾습니다. 스캔 모드 가이드는 이를 좌표로 나열합니다.

모델이 디코딩할 수 없는 상자를 보고하면, 기본 강제 읽기는 실행되지 않으며, 자동으로 값을 반환하지 않습니다. 전체 박스 사진이 110 픽셀 폭의 스티커가 4000x3000 프레임에 있을 때 이렇게 됩니다. 에이전트가 수정하여 값이 반환되지 않을 때 OnlyBasicScan으로 다시 시도하는지 확인하십시오.

@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

IronQR의 인쇄된 출력에서 각 일련번호를 가져와 이를 생성한 명령을 요청하십시오.

모서리 순서도 모드에 따라 달라집니다. 모델이 코드를 찾으면, 네 지점은 스캔 모드 가이드에서 언급한 것처럼 왼쪽 상단, 오른쪽 상단, 왼쪽 하단, 오른쪽 하단으로 실행됩니다. OnlyBasicScan은 스티커와 함께 회전된 코드의 고유 모서리를 시계 방향으로 반환합니다. 주문을 가정하는 것보다 좌표에서 윤곽선을 계산하십시오.

QR 읽기에 대한 회귀 테스트를 작성하는 방법은?

디코딩된 값을 알려진 목록과 비교하는 테스트는 라이브러리 업그레이드를 견디지만, 이미지 바이트를 비교하는 테스트는 렌더링이 변경될 때마다 실패할 수 있습니다. 클라우드 에이전트는 이를 고립된 클라우드 VM에서 실행할 수 있습니다. 시작하기 전에 IRONQR_LICENSE_KEY을 클라우드 에이전트 대시보드에서 비밀로 추가하십시오.

@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

스티커의 모든 값이 주소라면 마지막 단언이 중요합니다. IronQR의 스캔 모드 가이드에서 샘플 이미지를 읽으면 Value의 http://en.m.wikipedia.org과 후행 슬래시가 있는 Url을 출력했는데, 이는 Uri이 주소를 표준화했기 때문입니다. 서비스의 이 링크들처럼, 일련번호가 마지막 경로 세그먼트인 경우 단언은 실패할 수 없습니다.

AI 코딩 어시스턴트 가이드는 정의된 통과 기준에 따라 하나의 IronQR 작업을 처음부터 끝까지 실행합니다.

어떤 IronQR 패키지를 배포해야 합니까?

IronQR.Slim는 IronQr 네임스페이스와 기본 스캔을 제공합니다. 전체 IronQR 패키지는 감지기와 ONNX 런타임을 추가합니다. IronQR의 NuGet 패키지 가이드는 Slim 전용 프로젝트가 운영 체제를 위한 IronSoftware.ReaderInternals 패키지도 필요하다고 말합니다.

@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

IronQR.Slim만으로는 모델이 없기 때문에 자동으로 기본 스캔으로 바로 이동하고, OnlyDetectionModel은 IronQrException을 발생시킵니다. IronQR의 API 레퍼런스는 모델 없이 읽는 것이 느리고 품질이 낮다고 경고합니다. 패키지를 전환하기 전에 고객 사진으로 테스트하십시오.

실제 실행에서 프롬프트가 무엇을 생성했습니까?

여덟 개의 프롬프트가 샘플 보증 접수 저장소에 대해 순서대로 Cursor에 전달되었습니다. ZXing.Net 리더가 포함된 콘솔 앱, QRCoder로 스티커를 그리는 xUnit 프로젝트 및 확인된 일련번호가 있는 열두 개의 클레임 사진이 있습니다. 규칙, 케이블 태그 사진 및 전체 박스 사진은 해당 프롬프트 바로 전에 추가되었습니다. 라이선스 키는 오직 환경에서만 설정되었습니다. 실행 후, 마이그레이션에서 모든 커밋의 새 릴리즈 빌드를 사진 폴더를 다시 읽고 IronQR 리더의 일치 횟수와 아래의 테스트 결과를 재생산했습니다.

  • 클레임 사진은 이동 전 ZXing.Net 리더로 8/12, IronQR로 이동 후 12/12입니다.
  • 각 스캔 모드당 한 번 읽으면 claim-0004는 자동 및 OnlyBasicScan에서 두 개의 값을, OnlyDetectionModel에서 빈 값의 두 결과를 제공합니다.
  • rMQR 변경은 클레임 사진을 이동 전후에 13/13으로 두었습니다.
  • 수정 전, 자동은 전체 박스 사진 중 0/4를 읽었습니다. OnlyDetectionModel은 3, 1, 3 및 2개의 값을 가지지 않는 상자를 찾았으며, OnlyBasicScan은 4/4을 읽었습니다.
  • 수정 후, 전체 박스 사진은 4/4, 클레임 사진은 13/13을 읽었습니다.
  • xUnit 제품군은 22/22 테스트에 통과했습니다.
  • win-x64용 출판은 IronQR와 19,510,306 바이트로 IronQR.Slim 및 75,624,980 바이트를 생성했습니다. 재구축 시 75,624,288 및 19,509,614을 얻었습니다.
  • IronQR.Slim에서 리더는 여전히 클레임 사진 13/13 및 전체 박스 사진 4/4와 일치했습니다.
  • 모든 릴리스 빌드는 0개의 오류를 가지고 있고 수작업 편집이 필요하지 않았습니다.
  • 모든 단계가 여기에서 작성된 대로 실행되지 않았습니다. 프롬프트는 수작업으로 전송되었고, 언급은 텍스트로 붙여넣어졌으며, 에이전트는 이름을 검색하여 규칙 파일을 찾았습니다. 계획은 다음 프롬프트를 전송하여 승인되었고, 클라우드 에이전트 프롬프트는 에이전트 모드에서 로컬로 실행되었습니다.

실행 기록은 가이드별 패키지 버전, 모델, 타이밍 및 테스트 머신을 보유합니다.


문제 해결


질문?

질문이 있으시면 support@ironsoftware.com으로 문의하세요.

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 82,442버전:2026.11방금 출시