IronOCR를 Cursor와 함께 사용하는 방법

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

대부분의 IronOCR 코드는 AI 에이전트가 작성한 것처럼 보이며 종종 실행됩니다. 일부는 그렇지 않습니다. 바코드 수집을 활성화하지 않고 바코드를 읽는 코드는 바코드를 반환하지 않습니다. 독일어 언어 팩을 설치하지 않고 독일어를 언어로 설정한 코드는 LanguagePackException을 발생시킵니다. 모델은 훈련 데이터에서 작성되므로 빠릅니다. 하지만 이와 같은 세부 사항을 잘못하는 이유도 이 때문입니다.

Cursor는 VS Code 코드베이스에 구축된 AI 코드 편집기입니다. 문서 연결 및 리포지토리에 커밋된 규칙 파일을 적용하여 IronOCR의 API 및 팀의 규칙을 따르도록 제안할 수 있습니다. IronOCR는 텍스트, 바코드 및 표 구조를 로컬에서 읽는 C# 라이브러리입니다.

각 정리 필터는 입력에 대한 메서드이자 필터 열거형의 값이며, 이름만으로는 코드에 필요한 것을 알 수 없습니다. 이는 불량 스캔, 텍스트 레이어가 없는 PDF 읽기 또는 표 구조 보존과 같은 정밀한 변경에 가장 중요합니다.

IronOCR로 손글씨와 사진을 읽는 방법은 손글씨 가이드 및 사진 읽기 가이드에서 별도로 다룹니다.

빠른 시작
NuGetNuGet으로 설치

PM > Install-Package IronOcr

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

C# 프로젝트 내에서 이 요청을 전송하십시오.

@Program.cs Read https://ironsoftware.com/ocr/csharp/llms-full.txt first.

In this C# project, read TestData/skewed-scan.png twice, once untouched and once
with a single correction filter applied to the input, and print both confidence
scores exactly as IronOCR returns them so I can compare them. Read the license
key from the IRONOCR_LICENSE_KEY environment variable and never print it. Use
only members that appear in the documentation.
Text

라이선스 키 가이드는 키를 적용하는 각 방법을 보여줍니다.



OCR 작업에 어떤 Cursor 모델을 사용해야 할까요?

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

OCR 작업은 주로 필터를 추가하고 재구성하여 샘플을 다시 읽는 짧은 사이클로 이루어지며, 빠른 모델은 이를 잘 처리합니다. 생산 스캔 배치가 명확한 이유 없이 잘못된 필드를 반환하면 장시간 추론 모델로 전환하십시오.

Cursor에게 IronOCR 문서를 제공하는 방법은?

LLM용 전체 텍스트 파일은 145개의 문서 페이지를 하나의 URL에서 요약합니다. 2026년 10월 현재, Cursor의 @ 메뉴는 파일, 폴더, 터미널, 채팅, Git 차이점 및 브라우저를 첨부하여 IronOCR의 문서가 링크로 에이전트에 도달할 수 있도록 합니다.

Read https://ironsoftware.com/ocr/csharp/llms-full.txt

How do I read a scanned PDF and save a searchable copy, and how do I straighten
a slightly rotated page before reading it? Show the exact class and member names
from the documentation, and link the page you took them from.
Text

IronOCR 규칙을 인코딩하는 프로젝트 규칙을 작성하는 방법은?

프로젝트 규칙은 리포지토리 루트의 .cursor/rules 폴더에 저장됩니다. 코드와 함께 커밋되기 때문에 리포지토리의 모든 복제본은 동일한 세트를 받습니다.

규칙은 Markdown의 YAML 전면 사항으로 작성된 .mdc 파일입니다. 하위 폴더도 읽습니다. Cursor는 이 폴더의 일반 Markdown 파일을 무시합니다. 이 파일에는 이를 적용할 시기를 말할 전면 사항이 없기 때문입니다. IronOCR 규칙은 다음을 포함할 수 있습니다.

---
description: IronOCR conventions for scan reading in this project
globs: Imports/**/*.cs, Capture/**/*.cs
alwaysApply: false
---

# IronOCR conventions

- Use IronOCR for all OCR work. The NuGet package is IronOcr on Windows and
  IronOcr.Linux on Linux and Docker. The namespace is IronOcr. Do not add
  another OCR engine or a cloud OCR service.
- Documentation: https://ironsoftware.com/ocr/csharp/llms-full.txt
- Skill file with recipes: https://ironsoftware.com/ocr/csharp/skill.md
- Target the IronOcr version pinned in Directory.Packages.props. Do not upgrade
  it as part of an unrelated change.
- Never inline a license key. Read it from configuration or the
  IRONOCR_LICENSE_KEY environment variable.
- Dispose OcrInput with a using block.
- Any language other than English needs its IronOcr.Languages package first.
  Language packs keep their own version numbers, so pin the newest one on NuGet.
- Do not invent IronOCR API names. If a member is uncertain, say so and cite
  the documentation instead of guessing.
Markdown

글로브를 신중하게 선택하십시오. 항상 적용되는 규칙은 모든 채팅 세션에 연결되고 추가 컨텍스트를 사용하므로 IronOCR 규칙을 OCR 코드를 보유하는 폴더로 범위를 좁히십시오.

유의 사항: Cursor는 또한 루트 AGENTS.md을 읽습니다. 전면 사항이 없고 글로브도 없으므로 루트 파일은 전체 리포지토리에 적용됩니다. 지침의 범위를 지정하려면 이를 다룰 하위 디렉토리에 다른 것을 추가하십시오.

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

Tesseract 설정을 IronOCR에 매핑하는 방법은?

Tesseract 명령줄을 IronOCR 코드보다 잘 아는 모델은 IronOCR 설정이 필요한 곳에 Tesseract 플래그나 변수명을 작성할 수 있습니다.

TesseractIronOCR
--psm 7Configuration.PageSegmentationMode = TesseractPageSegmentationMode.SingleLine
--oem 1설정할 것이 없습니다. LSTM은 유일한 엔진입니다.
-c tessedit_char_whitelist=...Configuration.WhiteListCharacters
다른 -c 변수Configuration.TesseractVariables
-l eng+deuAddSecondaryLanguage(OcrLanguage.German)
--tessdata-dir, TESSDATA_PREFIXUseCustomTesseractLanguageFile for one .traineddata file, Installation.LanguagePackDirectory for a folder of .ocrdata files

IronOCR의 필터 마법사도 동일한 주의를 필요로 합니다. 필터 조합을 테스트하고 최상의 것을 C# 코드로 반환하지만 그 코드는 컴파일러가 더 이상 사용되지 않음을 플래그하는 생성자를 통해 파일 경로에서 입력을 작성합니다. 마법사는 또한 느립니다. 우리의 테스트 머신에서 200 DPI 페이지 한 장이 거의 9분이 걸렸으므로 단일 페이지에서 실행하십시오.

규칙의 두 항목이 두 경우를 모두 다룹니다.

- Configure Tesseract through IronTesseract.Configuration properties, never raw
  tessedit_* variables or command-line flags. Use TesseractVariables only for a
  setting with no named property.
- Rewrite OcrInputFilterWizard output from new OcrInput(path) to new OcrInput()
  with LoadImage or LoadPdf before it reaches the codebase.
Markdown

어떤 모드가 변경에 적합합니까?

Cursor는 변경을 만드는 다섯 가지 방법을 제공합니다. 작업의 크기에 기능을 맞추십시오.

기능사용할 때OCR 예시
탭다음 편집이 예측 가능합니다필터 옵션 반복
인라인 편집한 파일, 한 문장하나의 리더에 대한 필터
에이전트여러 파일과 빌드 루프리더와 이를 출력하는 작업
계획 모드이후에 검토하기에 너무 큼Tesseract 이주
클라우드 에이전트무인 작업알려진 페이지 테스트

인라인 편집을 위해 관련 줄을 선택하고 Ctrl+K (macOS에서는 Cmd+K)를 누르고 변경 사항을 설명하십시오. 송장에 있는 바코드는 에이전트 변경사항입니다.

@Imports/DeliveryNotes.cs @Imports/ImportJob.cs Read https://ironsoftware.com/ocr/csharp/skill.md first.

Also return every barcode and QR code on each delivery note, and have the notes
command print each one's format and value.
Text

바코드는 Configuration.ReadBarCodes 읽기 전에 설정되어야만 수집됩니다. 텍스트와 같은 결과에서 다시 돌아오므로 하나의 읽기로 둘 다 포함됩니다. 설정 파일이 해당 설정을 보여줍니다.

@ 언급이 요청에 추가하는 것은 무엇입니까?

실제 리더 파일을 참조하는 것이 요약을 사용하는 것보다 바람직합니다. 요약은 중요한 세부 사항을 생략할 수 있습니다.

@Imports/InvoiceReader.cs @TestData/warehouse/

InvoiceReader reads every scan in TestData/warehouse/ without an error, but about
a third of the totals have one wrong digit. Fix the input preparation, not the
parsing. Explain which setting caused it, and report how many totals match
expected.csv before and after.
Text

어떤 파일이 관련 있는지 확신이 서지 않으면 언급을 생략하고 에이전트가 직접 코드베이스를 검색하게 하십시오.

컨텍스트에도 샘플 스캔을 포함하십시오. 실제 파일을 필터를 통해 실행하면 어떤 조합이 고치는지 보여줍니다. 우리의 창고 세트에서 Deskew 혼자 9개 중 5개를 읽고 DeNoise 혼자 2개를 읽었습니다. 고치는 데 둘 다 필요했습니다. 이미지 방향 보정 가이드와 이미지 품질 보정 가이드는 관련 필터를 다룹니다.

IronOCR로 이주 계획과 실행 방법은?

계획 모드로 전환하고 이 요청을 보내십시오.

@Imports/ScanOcrService.cs

ScanOcrService reads scans with the Tesseract NuGet package. Plan a migration of
it to IronOCR.

List every read it performs, with the settings it uses (language, page
segmentation, preprocessing, region, output format), map each one to its IronOCR
equivalent, and name the files that change. Keep existing public method
signatures so callers don't change. If anything is ambiguous, choose and state
your assumption, and do not ask. Don't write code yet.
Text

그런 다음 에이전트에서 요청을 클릭하여 전송하십시오.

@Imports/ Implement the approved plan. Then run dotnet build, fix what breaks, confirm
every page in TestData/known/ still returns its expected values, and show me the
diff. Don't add new packages beyond IronOcr and any language packs the plan names.
Text

예전의 백그라운드 에이전트라고 불리는 클라우드 에이전트는 유료 플랜이 필요하며 클라우드 VM에서 실행되며 코드를 작업할 연결된 리포지토리가 필요합니다. 시작하기 전에 클라우드 에이전트 대시보드에 IRONOCR_LICENSE_KEY을 비밀로 추가하십시오. 이주가 병합된 후 테스트를 시작하십시오.

@Imports/ @TestData/ Write xUnit tests for the migrated OCR service in a
tests/Imports.Tests project that Imports.csproj does not compile. Every page in
TestData/known/ returns its expected invoice number and total, a page without a
total returns null, DeliveryNotes returns the codes in TestData/notes/expected.csv,
and a read with OcrLanguage.French, whose language pack is not installed,
produces a clear error. The tests read the license key from IRONOCR_LICENSE_KEY
and never print it. Assert on extracted fields, never on full page text. Run
dotnet test and fix what fails.
Text

AI 코딩 보조 가이드는 정의된 합격 기준과 함께 완전한 작업을 수행합니다.

잘못된 혹은 누락된 OCR 값을 디버그하는 방법은?

@Imports/InvoiceReader.cs @Imports/DeliveryNotes.cs @TestData/returns/

Returned-goods invoices come back with a wrong digit in the total, and delivery
notes return no barcodes even though every note has one. Explain the cause of
each before changing anything, then fix both.
Text

컨테이너의 예외가 Cursor 터미널에있는 경우, 아래 요청에 @Terminals을 추가하십시오.

@Dockerfile @Imports.csproj Read https://ironsoftware.com/ocr/csharp/skill.md first.

Reads work on Windows but fail when this app runs in our Linux container. Check
which IronOCR package the project references, whether the container image has
the native dependencies IronOCR needs, and whether the license key reaches the
container. Explain the cause, then propose the change. Don't modify C# code
unless the cause is there.
Text

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

아홉 개의 프롬프트가 순서대로 Cursor로 전송되었고, 샘플 수입 앱에 반영되었습니다. 그것은 중앙 패키지 관리, IronOCR 송장 및 배송 메모 리더, Tesseract 래퍼의 스캔 서비스 및 알려진 값의 스캔이 있는 콘솔 프로젝트입니다. 라이선스 키는 편집기의 환경에서만 설정되었습니다. 실행 후 각 커밋의 새로운 릴리스 빌드는 모든 테스트 폴더를 다시 읽고 아래 도표를 재현했습니다.

  • 수하물 송장 총계는 수정 전 9개 중 6개에서 수정 후 9개 중 9개로 갔습니다.
  • 수정 전에는 배송 메모 바코드가 돌아오지 않았습니다. 수정 후에는 8개 중 8개 메모가 코드를 가졌고 추가적인 코드는 없었습니다.
  • 반품된 상품 지점에서는 송장 총계가 6개 중 4개에서 6개 중 6개로 상승하고 메모 바코드는 아무 것도 없던 것에서 6개 중 6개로 상승했습니다.
  • 기울어진 스캔은 87.79 신뢰도로 읽히지 않았으며 Deskew 이후 96.41로 읽혔습니다.
  • 이주 후 알려진 페이지는 여전히 이전처럼 10개 중 10개, 독일 총계는 3개 중 3개를 읽었습니다.
  • xUnit 스위트는 20개의 테스트 중 20개를 통과했습니다.
  • 모든 릴리스 빌드는 0개의 오류를 가지고 있고 수작업 편집이 필요하지 않았습니다. 이주는 더 이상 사용되지 않는 EngineMode을 설정하여 두 개의 CS0618 경고를 남겼습니다.
  • 컨테이너 응답은 IronOcr.Linux, Docker 가이드의 적절한 패키지 및 누락된 키를 포함하고 변경되지 않은 C# 파일을 포함했습니다.
  • 일부 단계는 이 페이지와 다르게 수행되었습니다. 프롬프트는 데스크톱 앱에서 수동으로 전송되었고 계획은 Build를 클릭하지 않고 다음 프롬프트를 전송하여 승인되었으며, 클라우드 에이전트 프롬프트는 로컬에서 실행되었습니다. 프롬프트 여덟 번째는 처음에 이전 채팅으로 잘못 갔다가 재설정 후 다시 발송되었습니다. Docker가 없는 머신에서 컨테이너 프롬프트는 설명과 제안에 기반하여 판단되었습니다.

실행 기록에는 이 가이드를 포함한 다른 가이드와 함께 버전, 시간 및 테스트 머신이 나열되어 있습니다.


문제 해결


질문?

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

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

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 6,394,824버전:2026.11방금 출시