IronZIP을 Cursor와 함께 사용하는 방법

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

.NET 9 서비스인 ClientDrop은 이 가이드에서 각 클라이언트의 문서 폴더를 클라이언트가 다운로드하는 ZIP으로 패키징합니다. AES-256으로 모든 번들을 보호해야 한다고 요구하면서 비밀번호를 설정할 방법이 없는 System.IO.Compression으로 번들을 빌드합니다. 번들 코드는 IronZIP으로 이동해야 하며, AI 에이전트가 만든 이동은 더 보이지 않는 위험이 있습니다. IronZIP과 System.IO.Compression은 여전히 컴파일되는 세부정보에 대해 불일치합니다. System.IO.Compression은 패키징한 모든 파일의 폴더 경로를 유지하고 IronZIP의 Add는 파일 이름만 유지하므로 다른 달의 두 문장이 동일한 항목 이름을 받을 수 있습니다.

포트는 세 가지 Cursor 기능을 사용합니다. 커밋된 프로젝트 규칙은 삭제할 System.IO.Compression 습성을 명명하며, Plan Mode에서 에이전트는 파일이 변경되기 전에 매핑을 계획으로 작성하고 프롬프트와 규칙에 있는 문서 링크는 에이전트를 IronZIP의 페이지로 안내합니다. 각 ClientDrop 번들은 빌드될 때 암호화되고, 여전히 모든 파일을 보유하고 있는지 확인하기 위해 그 비밀번호로 추출되며, 테스트 시 항목을 계산할 때 그 비밀번호로 다시 열립니다.

빠른 시작
NuGetNuGet으로 설치

PM > Install-Package IronZip

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

Cursor에서 열린 ClientDrop과 함께, 이것을 에이전트에 붙여넣으세요. 그것의 두 언급은 번들 클래스와 한 클라이언트의 폴더를 첨부합니다.

@src/ClientDrop/Bundles/BundleBuilder.cs @TestData/clients/C-1042/

Fetch https://ironsoftware.com/zip/csharp/llms.txt first and read it before any edit.
BundleBuilder packs a client folder with System.IO.Compression.
Run dotnet test once and report the result.

Then make these changes:
1. Add the IronZIP package, version 2026.10.2, to src/ClientDrop.
2. Give Program.cs an "inspect <zip> [password]" command that opens a bundle with IronZIP.
3. Have inspect print each entry's name, size and whether it is encrypted.
4. Assign License.LicenseKey the value of IRONZIP_LICENSE_KEY.
5. Keep the key out of all output, and don't list the environment variables.
6. Keep BundleBuilder.cs unchanged.

Bundle C-1042 with the current code, run inspect on out/C-1042.zip and show me the output.
Text

inspect 명령은 오래된 번들을 읽고 7개의 항목을 폴더 경로와 함께 나열하며, 루트에 있는 contract.pdf에서 시작하여 statements/2026-05/statement.pdf까지 나열합니다. 이 중 아무 것도 암호화되지 않은 상태였습니다.

각 프롬프트에서 라이선스 키를 제외하세요. 에이전트 모드에서는 Cursor가 코드를 작성하고 터미널 명령을 실행하므로 대화에 입력된 키는 코드 또는 커밋 메시지로 복사될 수 있습니다. IRONZIP_LICENSE_KEY 환경 변수를 대신 설정하세요. IronZIP은 자체적으로 그 변수를 읽지 않으므로, 프롬프트가 그것을 License.LicenseKey에 할당하도록 코드를 작성합니다. 변수를 설정하고 할당을 하지 않은 프로브에서는 save 호출이 "Production License Required"라는 LicensingException 예외를 던졌습니다. 라이선스 키 가이드는 Git이 무시할 수 있는 appsettings.json 파일과 같이 IronZIP이 자체적으로 확인하는 곳을 다룹니다.



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

Composer는 Cursor의 독자적 에이전트 모델입니다. 모델 선택자는 또한 Cursor와 공동 개발한 SpaceXAI의 Grok 모델 및 OpenAI, Anthropic, Google 기타 실험실의 모델을 제공합니다. 이 가이드에서 사용하는 런은 Grok 4.7을 사용했습니다. 어느 모델을 선택하든, 프롬프트에 파일, 테스트 및 예상 카운트를 기입하세요.

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

IronZIP의 llms.txt는 예제와 튜토리얼을 간단한 요약과 함께 나열하는 단일 페이지입니다. 2026년 10월 기준으로, Cursor의 @ 메뉴는 브라우저, Git 차이, 터미널, 과거 채팅, 파일 및 폴더를 제공합니다. 문서에 대한 항목은 없으므로 프롬프트는 IronZIP의 문서를 링크로 제공합니다.

포트는 폴더 경로가 어디로 가고 언제 IronZIP이 비밀번호를 확인하는지에 따라 달라집니다. 다음 프롬프트는 페이지에서 모든 것을 답변하도록 Cursor에게 요청하고, 어떤 페이지도 특정 포인트를 다루지 않을 때 그것을 말하게 합니다.

@src/ClientDrop/Bundles/BundleBuilder.cs

Your only source is https://ironsoftware.com/zip/csharp/llms.txt plus the example pages it links.
Do not edit files.
List each System.IO.Compression call in BundleBuilder.
Next to each call, name the IronZIP member that would replace it.

Then answer three questions:
1. Does Add keep the folder path of the file it is given?
2. Which call encrypts a new archive with AES-256?
3. For an existing protected archive, is the password checked at the constructor or at extraction?

Cite the page URL behind every answer, and say plainly when no page covers a point.
Text

페이지는 암호화 질문에 대해 두 가지로 대답합니다. 암호 예제는 Encrypt에 EncryptionMethods.Traditional로 호출하고, 접근 예제는 동일한 호출을 AES-256로 전환합니다. 어떤 페이지도 Add가 폴더 경로와 함께 무엇을 하는지 설명하지 않습니다. 두 페이지는 오해를 초래합니다. 접근 예제는 잘못된 비밀번호가 작업에 실패하게 만든다고 말하지만, 이는 추출에만 해당되었습니다. 파일 추가 예제는 FromFile로 기존 ZIP을 열며, 이는 새로운 아카이브를 만들어 그 ZIP을 단일 항목으로 보유합니다. IronZipArchive 참조 문서는 예제 페이지에 표시되지 않는 SetPassword 및 RemoveEncryption와 같은 멤버를 문서화합니다.

유의 사항: IronZIP는 또한 기술 파일을 게시하며, 프런트매터에서 해당 파일을 ironzip으로 명명합니다. .cursor/skills/ironzip/SKILL.md로 저장되어 Cursor가 시작될 때 발견되며, Agent에서 /ironzip를 입력하면 한 메시지에 첨부됩니다.

IronZIP의 규칙을 인코딩하는 프로젝트 규칙을 어떻게 작성합니까?

프로젝트 규칙은 .cursor/rules 아래에 .mdc 파일로, 코드와 함께 커밋됩니다. 각 규칙은 프론트매터 블록과 함께 마크다운입니다. 규칙 시스템은 .cursor/rules 아래의 일반 .md 파일을 건너뜁니다. 그런 파일은 프론트매터가 없기 때문입니다. description, globs 및 alwaysApply 필드는 Cursor가 규칙을 적용할 시기를 결정합니다.

이 규칙은 글로브로 범위가 지정되므로, 서비스나 그 테스트에서 파일이 존재하는 컨텍스트의 모든 요청에 Cursor가 이를 적용하고, @ironzip-bundles은 이름으로 그것을 첨부합니다. 여러 패턴이 하나의 줄에 쉼표로 분리되어 사용됩니다. .cursor/rules/ironzip-bundles.mdc로 저장합니다.

---
description: Move ClientDrop bundle code from System.IO.Compression to IronZIP
globs: src/ClientDrop/**/*.cs, tests/ClientDrop.Tests/**/*.cs
alwaysApply: false
---

ClientDrop writes bundles with IronZIP and follows these rules:
- Use IronZIP only. Its package ID is IronZIP and its namespace is IronZip.
- Remove System.IO.Compression from src/ClientDrop.
- Do not add SharpZipLib, DotNetZip or another archive package.
- IronZIP's docs start at https://ironsoftware.com/zip/csharp/llms.txt.
- Set License.LicenseKey from IRONZIP_LICENSE_KEY.
- Never write a license key or a bundle password into code, tests or logs.
- Encrypt every bundle with EncryptionMethods.AES256 and BundleOptions.Password.
- Open an existing bundle with new IronZipArchive(path, password).
- FromFile, FromFiles and FromDirectory build a new archive instead.
- Do not invent IronZIP members. For a member no page documents, say so and cite the page searched.
Markdown

FromFile 라인은 FromFile으로 번들을 열 때 오류가 발생하지 않기 때문이며, 원래 번들은 변경되지 않은 상태로 남습니다.

규칙은 에이전트 요청에만 영향을 미칩니다. Cursor의 규칙 페이지의 FAQ에 따르면, 탭 완성은 규칙을 무시하고, 인라인 편집(Ctrl+K)은 사용자 규칙을 무시합니다.

System.IO.Compression 호출을 IronZIP과 어떻게 매핑합니까?

"IronZIP 사용"만 언급하는 규칙은 모델이 각 호출이 무엇이 되는지 알아내게 만듭니다. 각 IronZIP 결과는 클라이언트 C-1042에서 IronZIP 2026.10.2로 측정되었으며, 그 폴더에는 7개의 문서가 보관되고 있으며, 그 중 세 개는 statement.pdf라는 이름이고 두 개는 다른 달의 폴더에 있는 invoice.pdf라는 이름입니다.

System.IO.Compression 호출예상되는 결과IronZIP
ZipFile.CreateFromDirectory폴더 유지, 7개의 항목FromDirectory, 기술 파일에 나와 있으며 contract.pdf만 패키징됨
각 파일에 대해 CreateEntryFromFile파일당 하나의 항목Add은 네 개의 이름 아래에 일곱 개의 항목을 저장했고, 추출은 네 개의 파일을 남겼습니다.
업데이트 모드에서 Delete와 CreateEntryFromFile재발행된 문서는 이름을 유지함ReplaceEntry은 주어진 경로로 새 항목의 이름을 지정했습니다. 여기서는 ZipWork/cursor/repo-baseline/TestData/reissue/C-1042/contract.pdf
테스트에서 ZipFile.OpenRead모든 항목 읽기 가능AES 항목이 나열되었으며, 하나를 읽으면 잘못된 데이터 예외 "지원되지 않는 압축 방식"을 던졌습니다.

중복 이름이 있는 번들에서, ReplaceEntry은 이름을 바꾸기 전에 실패했습니다. 두 개의 invoice.pdf 항목에 대해 "같은 키가 이미 추가되었습니다"라는 ArgumentException 예외가 던져졌습니다. 암호화 자체는 작동했습니다. Encrypt과 EncryptionMethods.AES256은 일곱 개의 모든 항목을 암호화된 것으로 표시했으며, 고유 평면 이름 하에 있는 폴더의 대기 사본, 예를 들어 statements_2026-03_statement.pdf, 를 일곱 개의 파일로 추출하여 SHA-256으로 원본과 일치했습니다. 중복 이름은 잡기 가장 어려운 문제입니다. 번들이 진술을 잃더라도 여전히 일곱 개의 항목을 보유하므로, 카운트 확인이 통과하며 클라이언트는 네 개의 문서를 다운로드합니다.

번역을 규칙에 추가하세요.

The port translates System.IO.Compression habits this way:
- Add keeps only the file name.
- Copy each file to a staging folder under a name unique in the bundle, and add the copy.
- One such name is statements_2026-03_statement.pdf.
- ReplaceEntry names the new entry after the path it is given.
- To swap a document, Delete the entry and Add a staged copy named like the old entry.
- System.IO.Compression cannot read AES entries. Tests open bundles with IronZIP.
Markdown

IronZIP로의 마이그레이션을 어떻게 계획하고 실행합니까?

다음 프롬프트를 보내기 전에 Shift+Tab을 사용하여 채팅 입력을 Plan Mode로 회전시킵니다. Plan Mode에서 에이전트는 코드를 조사하면서 명확한 질문을 할 수 있습니다.

@src/ClientDrop/ @tests/ClientDrop.Tests/ @ironzip-bundles

Plan the move of BundleBuilder from System.IO.Compression to IronZIP.
Every bundle is encrypted with AES-256 using BundleOptions.Password.
Map each System.IO.Compression call to the IronZIP member that replaces it.
For each call, name the file it lives in.
Public method signatures on BundleBuilder stay as they are.
No test is renamed or loses an assertion.
Write no code yet.

In the plan, tell me how each of these works:
- The three files called statement.pdf in different folders all survive.
- The tests read an encrypted bundle.
- Reissue swaps a document without renaming it.
Text

계획은 수정할 수 있는 마크다운 파일이므로, 잘못된 매핑은 어떤 것이 구축되기 전에 수정될 수 있습니다. 계획이 올바르면 Plan Mode에서 그것을 구축하거나 다음 프롬프트로 에이전트 모드로 돌아가 체크를 추가합니다.

Build the approved plan with @ironzip-bundles attached.
Remove every System.IO.Compression call from src/ClientDrop.
In the tests, change only BundleReader.
Set CLIENTDROP_BUNDLE_PASSWORD to a throwaway value inside each command you run.

After the build, carry out these steps in sequence:
1. Build and run the tests.
2. Run "bundle C-1042", then run "inspect" on the result with that password.
3. Extract that bundle with IronZIP to an empty folder.

Report how many tests pass now and how many passed at the start.
Also report how many files the client folder and the extracted folder each hold.
Text

우리의 보정에서는 각 호출을 가장 가까운 IronZIP 구성원으로 교체한 직선 번역이 깨끗하게 컴파일되고 6개 중 4개의 테스트를 통과했습니다. 두 번 실패한 것은 추출 확인과 재발행이었습니다. 규칙을 따른 포트는 여섯 개 모두 통과했습니다.

보호된 번들에서 하나의 문서를 어떻게 꺼냅니다?

BundleBuilder는 또한 다운로드되지 않은 번들에서 하나의 문서를 제거하는 방법이 필요합니다. BundleBuilder.cs에서 Reissue 메서드를 전체 강조 표시하고 Ctrl+Shift+L을 눌러 열린 채팅에 추가한 다음 에이전트 모드에서 요청을 보냅니다.

Below the highlighted Reissue, add Withdraw(string bundlePath, string entryName).
It takes one document out of an existing bundle and keeps the rest encrypted.
For a name the bundle lacks, it throws KeyNotFoundException, as Reissue does.
Add a "withdraw <zip> <entry>" command to Program.cs.
Try it on a fresh C-1042 bundle, with CLIENTDROP_BUNDLE_PASSWORD set inside each command.
Show me what each command prints.
Text

결과물 Withdraw는 Contains 가드, 그리고 Delete Encrypt EncryptionMethods.AES256와 Save입니다. 암호로 열린 아카이브에서. C-1042에서 contract.pdf를 철회하니 여섯 항목이 남았으며, 여전히 암호화되어 있었습니다. 우리의 보정에서는 두 문서의 번들이 하나를 보유했고, 생성자가 번들을 열지 못했습니다.

왜 하나의 문서 번들이 자신의 비밀번호를 거부합니까?

IronZipArchive 생성자는 보호된 아카이브가 정확히 하나의 항목을 보유할 때 정확한 비밀번호를 거부합니다. IronZIP 2026.10.2에서는 AES-256, AES-128 및 전통적 암호화를 사용하여 암호화된 단일 항목 아카이브에 대해 "잘못된 비밀번호!"라는 예외를 던졌으며, 바이트 배열 과부하 및 FromArchive가 동일한 작업을 수행했습니다. 같은 비밀번호로 ExtractArchiveToDirectory이 파일을 추출하는데 오류가 없었고, 두 개 이상의 항목이 정상적으로 열렸습니다.

클라이언트 C-1077은 환영 편지 한 장을 가지고 있습니다. 그의 폴더, 수정된 편지 및 프로그램을 함께 언급하세요.

@TestData/clients/C-1077/ @TestData/reissue/C-1077/ @src/ClientDrop/Program.cs

Client C-1077 has a single document.
Set the same throwaway CLIENTDROP_BUNDLE_PASSWORD inside each command.

Run these three steps in order:
1. Run bundle C-1077.
2. Run list on out/C-1077.zip.
3. Reissue its welcome-letter.pdf from TestData/reissue/C-1077/.

If any step throws, find the cause and fix it in BundleBuilder.
Don't catch and hide the exception.
If a line of @ironzip-bundles led to it, change that line too.
Then run all three steps again.
Show me the error you hit and the list output after the reissue.
Text

우리의 보정에서 번들은 작성된 후 목록과 재발행이 실패했고, 번들 명령 자체가 실패하였으며, 이는 새로운 번들을 목록하는데 열리지 않았습니다. 번들을 임시 폴더에 추출하여 읽고, 재발행 또는 철회를 위한 폴더에서 다시 작성하여 2,643 바이트의 편지를 나열하고 수정된 것으로 교체했습니다. 이 블록을 번역 아래에 추가합니다.

One-document bundles follow this rule:
- On a protected one-entry bundle, the IronZipArchive constructor rejects the correct password.
- List, reissue and withdraw such a bundle by extracting it with ExtractArchiveToDirectory.
- Then pack the extracted folder again.
Markdown

번들에 대해 회귀 테스트를 어떻게 작성합니까?

클라우드 에이전트는 회귀 스위트를 작성할 수 있습니다. 연결된 소스 제어에서 저장소를 복제하므로 먼저 포트를 내보내고, 시작하기 전에 Cloud Agents 대시보드에 IRONZIP_LICENSE_KEY를 비밀로 추가하세요.

@tests/ClientDrop.Tests/ @TestData/

Extend BundleBuilderTests for the IronZIP port with tests for these cases:
- The three statement.pdf documents from different C-1042 folders all survive a round trip.
- Those three documents keep distinct entry names.
- Every entry in the C-1042 bundle is encrypted.
- A wrong password fails when the bundle is extracted.
- A one-document bundle can be listed, reissued and extracted.
- Withdraw removes exactly one document.
- Withdraw throws KeyNotFoundException for an unknown name.

Compare extracted files by SHA-256, never archive bytes.
Run dotnet test and report how many tests pass and fail.
Text

잘못된 비밀번호 테스트는 번들을 추출해야 합니다. 세 개의 항목이 있는 번들에서 생성자는 오류 없이 잘못된 비밀번호를 받아들이며, 항목 수, 항목 목록 및 이름 조회는 모두 올바르게 답변했습니다. 처음으로 거부한 호출은 ExtractArchiveToDirectory로, ArgumentException "Invalid password!!"를 던졌습니다. 따라서 항목을 나열하는 포트는 첫 번째 읽기에서 잘못된 비밀번호를 거부합니다.

IronZIP의 AI 코딩 도우미 가이드는 하나의 IronZIP 작업을 정의된 패스 기준에 대한 단 끝까지 실행합니다.

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

일곱 개의 프롬프트는 한 채팅에서 순서대로 Cursor로 보내졌으며, 이 가이드를 위해 만든 ClientDrop 저장소의 복사본에서 작동했습니다. 이 복사본에는 System.IO.Compression BundleBuilder, System.IO.Compression으로 번들을 읽는 여섯 개의 xUnit 테스트, 그리고 클라이언트 C-1042가 포함되어 있었습니다. 규칙 파일과 클라이언트 C-1077은 그들을 사용하는 프롬프트 직전에 추가되었고, 라이선스 키는 환경 변수로만 설정되었습니다. 아래의 모든 도표는 채팅이 끝난 후 커밋된 코드를 빌드하고 실행한 결과입니다.

  • 모든 6개의 테스트는 포트 이전에 통과했고, 같은 6개가 포트 이후에도 통과했습니다.
  • 이식된 C-1042 번들은 고유한 평면 이름 아래에 7개의 항목을 보유했습니다.
  • IronZIP은 번들에서 폴더에 보관된 파일과 동일한 수의 7개의 파일을 추출했습니다.
  • IronZIP과 코드가 연결되지 않은 Python ZIP 리더인 pyzipper는 모든 7개의 항목에 AES-256 암호화를 발견했습니다.
  • 추출된 모든 7개의 파일이 SHA-256을 통해 클라이언트 폴더 내의 파일과 일치했습니다.
  • IronZIP이 비밀번호를 확인하는 위치를 물어본 결과로, Cursor는 생성자와 접근 예제를 이름으로 지정했습니다.
  • 철회는 번들이 부족한 이름에 대해 KeyNotFoundException을 던졌습니다.
  • 수정하기 전, C-1077의 번들, 목록 및 재발행 단계는 IronZipArchive 생성자에서 "잘못된 비밀번호!" 예외를 각각 던졌습니다.
  • 수정 후, 리스트는 2,643 바이트의 welcome-letter.pdf를 보여주었고, 재발행 후 2,761 바이트였습니다.
  • pyzipper가 추출한 재발행된 편지는 SHA-256을 수정된 파일과 일치했습니다.
  • 각 C-1077 번들도 __bundle_keep이라는 빈 항목을 포함하고 있으며, 추출은 두 번째 파일로 썼습니다.
  • 최종 코드에서, 두 개의 문서 번들에서 하나의 문서를 철회하면 하나의 항목이 남아 있어, 목록은 "잘못된 비밀번호!" 예외를 던졌습니다.
  • 테스트 프롬프트는 6개의 테스트를 추가하였으며, 모든 12개의 테스트가 통과했습니다.
  • IronZIP 2026.10.2는 이 서비스에서 유일한 패키지였으며, System.IO.Compression 호출은 남아 있지 않았습니다.
  • 각 프롬프트 후의 릴리스 빌드는 경고나 오류 없이 완료되었습니다.
  • 일부 단계는 페이지와 달리 작동했습니다. Plan Mode에서, Cursor는 규칙 파일을 열기 전에 저장소 외부의 ironzip-bundles 폴더를 검색했습니다. C-1077의 경우 Cursor는 __bundle_keep 항목을 한 문서 번들에 추가하고 추출로 읽는 대신 그것을 규칙에 작성했습니다. 클라우드 에이전트 프롬프트는 동일한 채팅 내에서 에이전트 모드에서 로컬로 보내졌으며, 클라우드 에이전트로 보내지지 않았습니다.

Claude Code 가이드에서 어떤 코드도 작성하기 전의 계획 승인은 추출한 사본에서 각 아카이브를 재구성하고 단일 항목 아카이브를 처리한 계획을 사용합니다. GitHub Copilot 가이드는 로그 기록기와 테스트를 TAR 규칙에 제한하고, 경로별 지침 파일의 applyTo 값을 통해 글로브가 이 규칙을 동일한 방식으로 제한합니다. 실행 기록은 Cursor 버전과 모델을 명시하며, 총 프롬프트 시간 및 테스트 머신의 하드웨어 정보를 제공합니다.


문제 해결


질문?

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

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

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 25,383버전:2026.11방금 출시