Google Antigravity와 IronZIP 사용 방법

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

고객에게 그들의 사례 문서를 비밀번호로 보호된 ZIP으로 제공하는 페이지는 깔끔하게 컴파일할 수 있지만, 파일이 누락된 압축 파일이나 일반적인 사례를 위한 오류 페이지, 또는 다른 사례의 문서를 보낼 수 있습니다.

Google Antigravity의 /browser 명령은 Chrome 브라우저 하위 에이전트를 시작하여 실행 중인 페이지를 제어할 수 있으며, 하나의 프롬프트로 비밀번호를 입력하고 모든 테스트 케이스에 대해 다운로드를 누르고 각 결과의 스크린샷을 유지할 수 있습니다. IronZIP는 서버에서 AES-256 암호화로 압축 파일을 생성하고 다시 추출하여 모든 문서가 바이트 단위로 다시 돌아왔음을 입증할 수 있습니다. 이 가이드는 IronZIP의 비밀번호 보호 예제를 시작으로 하여 ASP.NET Core MVC 앱에서 다운로드 페이지를 만드는 방법을 설명하고, 문서 및 SHA-256 해시가 미리 알려진 다섯 가지 사례를 통해 이를 검증합니다.

빠른 시작
NuGetNuGet으로 설치

PM > Install-Package IronZip

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

Antigravity에서 CaseDocs 폴더를 열고 다운로드 페이지를 설명하세요.

/plan CaseDocs is an ASP.NET Core MVC project that targets .NET 9.
Add the case document download that docs/case-download-rules.md describes.

The download works like this:

- A user opens /Cases/{id}, ticks documents and types a password.
- The user receives an AES-256 encrypted ZIP that the server builds with IronZIP.
- The NuGet package is IronZIP version 2026.10.2, and its namespace is IronZip.

Program.cs reads IRONZIP_LICENSE_KEY and assigns it once to IronZip.License.LicenseKey.
Confirm only that the variable exists and how many characters it holds.
Never print, log or write its value.

The Implementation Plan must state these answers:

- the entry name each document receives inside the archive
- the path the archive is saved to before the response, and when that file is deleted
- how the saved archive is compared with the ticked documents

Stop once dotnet build succeeds, and tell me the build result.
Text

코드가 변경되기 전에 이 세 가지 답변을 읽어보세요. 각각은 컴파일러 오류 없이 압축 파일이 잘못될 수 있는 방법을 설명합니다. 헤드리스 agy -p에서는 아무도 계획을 승인하지 않으므로, 설명된 코드 옆에 있는 아티팩트 계획을 읽어보세요.

프롬프트에서 변수를 명명하고 값을 붙여넣지 마세요. 대화에 입력된 모든 것은 소스 파일, 커밋 또는 터미널 전송 파일에 도달할 수 있습니다. IronZIP는 appsettings.json에서 IronZip.LicenseKey 항목도 수락하며, 커밋은 그 파일을 다른 항목과 함께 포함합니다. 모든 지원되는 위치는 라이선스 키 가이드에 나와 있습니다.



변경 사항을 수락하기 전에 무엇을 검토해야 하나요?

각 입력 항목의 이름이 어디에서 왔는지, 각 압축 파일이 저장된 폴더, 삭제하는 행, 그리고 압축 파일을 다시 읽는 코드를 확인하세요. 그런 다음 차이점을 API 레퍼런스와 비교하여 각 IronZIP 구성원을 확인하세요.

Antigravity는 스크린샷을 이미지 아티팩트로 저장하고 댓글을 수락합니다. 오류 페이지나 잘못된 문서 수를 보여줄 때 그 스크린샷에 댓글을 달고 새로운 프롬프트를 작성하지 마세요.

실제 브라우저에서 모든 다운로드를 어떻게 테스트하나요?

실제 다운로드만으로 채울 수 있는 결과 테이블을 요청하세요.

/browser Start CaseDocs in the background with dotnet run --launch-profile http.
That profile listens on http://localhost:5065.

For each row of TestData/expected.csv, do this:

1. Open /Cases/<case> and leave every checkbox as the page sets it.
2. Type the row's password and press Download.
3. Capture a screenshot of what follows.
4. When the answer is a file, take its name and size from the download or the response headers.

In the Walkthrough and in your reply, give one line per row with these parts:

- the case
- the documents the page listed, against the documents column
- the expected outcome
- what actually happened, as the file name and size or the message shown
- a PASS or FAIL verdict

For any failing row, cite the server log entry or error page text responsible.
Do that before you edit any code.
After every fix, restart the app and go through all six rows again.
Stop the app when you are done.
Text

입력 이름 수정은 이미 통과한 사례에서도 모든 압축 파일을 변경하므로 프롬프트는 모든 여섯 줄을 다시 실행합니다.

유의 사항: 단일 문서 사례의 스크린샷을 먼저 여세요. 다른 사례를 통과한 페이지도 여전히 그곳에서 오류 페이지를 반환할 수 있습니다.

불완전하거나 실패한 다운로드를 일으키는 원인은 무엇인가요?

우리의 보정에서는 비밀번호 보호 예제에서 코드가 다운로드 작업으로 이동했습니다. AES-256으로 전환했으며 생성자와 함께 열어 저장된 압축 파일의 항목 수를 계산했습니다. IronZIP 2026.10.2와 함께 헤드리스 Chrome이 모든 사례에 대해 다운로드를 눌렀습니다. 아래의 모든 실패는 경고 없이 컴파일되었습니다.

무슨 일이 발생했는지원인요청해야 할 것
여섯 개 문서 사례를 다운로드했지만 추출하면 3개의 파일만 나왔습니다.IronZIP는 각각의 항목을 단독 파일 이름으로 지정하므로 두 개의 letter.pdf, 두 개의 scan.jpg, 두 개의 summary.pdf 파일이 이름을 공유했습니다.상대 경로에서 생성된 항목 이름과 해당 이름 아래 저장된 복사본
단일 문서 사례는 오류 페이지를 반환했습니다.생성자 역독시 올바른 비밀번호로 "유효하지 않은 비밀번호!"를 던졌습니다.압축 파일을 추출하는 역독
빈 사례는 오류 페이지를 반환했습니다.항목이 없는 압축 파일 저장 시 "기존 압축 파일이 손상되었습니다!"를 던졌습니다.IronZIP가 실행되기 전에 선택 확인
체크박스 값이 ../C-1001/ledger.csv로 수정되어 다운로드에 다른 사례의 파일을 넣었습니다.작업이 게시된 경로를 신뢰했습니다.게시된 모든 경로가 확인되고 사례 폴더 내에 유지되었습니다.
네 개의 ZIP 파일이 임시 폴더에 남아 있었습니다.IronZIP는 경로에만 저장하며, 파일을 삭제하지 않았습니다.요청이 끝날 때 삭제되는 요청당 폴더

여섯 문서 사례의 항목 수 체크가 통과되었고, 압축 파일에는 여섯 항목이 들어 있었습니다.

Antigravity가 작업할 수 있는 프로젝트를 어떻게 설정하나요?

에이전트는 이미 로컬호스트에서 빌드하고 응답하는 앱이 필요합니다. dotnet new mvc --framework net9.0는 하나를 제공하며, 한번 실행하면 Properties/launchSettings.json에서 포트를 표시합니다. 포트는 프로젝트마다 다르며, /browser 프롬프트는 이를 이름으로 지정해야 합니다. 브라우저의 허용 목록 처음에는 로컬호스트만 보유합니다, 따라서 주소를 http://localhost:<port> 형식으로 유지하세요.

CaseFiles 아래에 사례 폴더, docs/case-download-rules.md의 규칙, 긴 문서와 모든 파일의 길이와 SHA-256을 포함한 manifest.csv, 각각의 사례와 비밀번호에 대한 결과를 가진 TestData/expected.csv를 커밋하세요. 다섯 개의 테스트 사례는 다섯 개의 평범한 문서, 하위 폴더에 세 개의 이름이 반복되는 여섯 개의 문서, 단일 진술, 악센트 및 일본어 이름을 가진 세 개의 문서, 및 어떤 문서도 포함되지 않은 사례를 포함했습니다. 그런 다음 에이전트에게 패키지 및 키를 감사하도록 하세요.

Which IronZIP version does CaseDocs.csproj reference? Quote its PackageReference line.
Then show the line in Program.cs that assigns the license key.
Add either line if it is missing.

IRONZIP_LICENSE_KEY is the only allowed source of that key.
Search these files for an IronZip.LicenseKey entry or a key value, and remove any you find:

- appsettings.json
- appsettings.Development.json
- Properties/launchSettings.json

When the variable is missing at startup, the app logs a single warning.
That warning mentions IRONZIP_LICENSE_KEY and contains no value.
Add it only if it is absent, and leave every other file alone.
Tell me what you found and what you changed.
Text

나중에 프롬프트가 프로젝트나 패키지를 추가할 때마다 그 버전 번호를 반복하여 모든 프로젝트가 동일한 IronZIP 릴리즈에 대해 빌드되도록 하세요. 메모리에서 패키지 이름을 작성하는 에이전트는 허상 이름으로 게시된 악성 패키지를 설치할 수 있으며, 이를 슬롭스쿼팅 공격이라고 합니다. 패키지는 IronZIP 이며 네임스페이스는 IronZip입니다.

변수가 설정되고 License.LicenseKey이(가) 할당되지 않은 상태에서 캐버레이션 페이지는 모든 네 가지 압축 파일 사례에 대해 저장 호출에서 실패했습니다. 각 사례 오류로 "생산 라이선스가 필요함"이라는 LicensingException이 발생했습니다. IronZIP는 자체적으로 IRONZIP_LICENSE_KEY를 읽지 않았으므로 앱이 IronZip.License.LicenseKey를 할당해야 합니다. IronZIP의 에이전트 문서 파일 및 단일 프롬프트 수락 테스트는 AI 코딩 도우미 가이드를 참조하세요.

IronZIP에 문서를 전달하는 방법은?

Add, AddArchiveEntry 및 FromFiles는 모두 상대 경로(예: 2025/letter.pdf)에서 폴더를 탐지했으며 추출은 동일 이름의 두 항목 중 마지막 항목을 유지했습니다. 폴더 경로를 추가하면 UnauthorizedAccessException이 발생했습니다. 서비스는 따라서 각 문서를 규칙이 지정한 이름 아래 임시 폴더로 복사하고 복사본을 추가합니다.

생성자 실패는 스트림, 바이트 배열 및 FromArchive 오버로드가 같은 System.Exception을 던졌으므로 단일 항목 AES-256 압축 파일을 여는 모든 방법을 다룹니다. 두 개 이상의 AES-256 항목이 있는 경우 생성자는 잘못된 비밀번호로도 항목을 나열했으며, 전통적인 압축 파일은 생성자에서 ZipException을 던졌습니다. 추출은 단일 항목 압축 파일을 온전한 상태로 반환하고, 잘못되거나 비어 있거나 누락된 비밀번호는 "유효하지 않은 비밀번호!"를 던졌습니다.

IronZIP 2026.10.2에서는 ZIP 압축 레벨이 차이를 만들지 않았습니다. 레벨 0, 1, 6 및 9는 같은 970,545바이트 크기의 압축 파일을 1,042,684바이트의 탐지 문서로부터 생성했으며 각 빌드에는 119에서 121ms가 걸렸습니다.

/plan Draft the Implementation Plan for this change, and wait for review before you edit anything.
Move every IronZIP call out of the controller into Services/CaseArchiveBuilder.cs.
Register it in DI as a singleton.
Given the case folder, the ticked relative paths and the password, it returns the ZIP bytes.

The service works in this order:

1. It copies each document into a new folder under the system temp path.
2. Each copy gets the entry name from the rules.
3. It adds those copies and saves the archive beside that folder.
4. It extracts that archive with the same password into a second folder.
5. It compares the SHA-256 of every extracted file with its source.
6. On any difference, it throws with the document's entry name.

Both folders are removed in a finally block.
The controller keeps the password, selection and path checks.
Afterward, repeat the /browser pass over TestData/expected.csv and report each row.
Text

에이전트의 서비스와 이 서비스를 비교하세요. IronZIP 2026.10.2와 빌드되었고, 모든 네 개의 압축 파일을 온전하게 반환했으며 임시 폴더에는 아무것도 남기지 않았습니다.

using System.Security.Cryptography;
using IronZip;
using IronZip.Enum;

public sealed class CaseArchiveBuilder
{
    public byte[] Build(string caseFolder, IReadOnlyList<string> relativePaths, string password)
    {
        var work = Path.Combine(Path.GetTempPath(), "case-" + Guid.NewGuid().ToString("N"));
        var staged = Path.Combine(work, "staged");
        var check = Path.Combine(work, "check");
        Directory.CreateDirectory(staged);
        try
        {
            var sources = new Dictionary<string, string>();
            foreach (var relativePath in relativePaths)
            {
                var entryName = relativePath.Replace('/', '_');
                var source = Path.Combine(caseFolder, relativePath);
                File.Copy(source, Path.Combine(staged, entryName));
                sources.Add(entryName, source);
            }

            var zipPath = Path.Combine(work, "case.zip");
            using (var archive = new IronZipArchive())
            {
                archive.Encrypt(password, EncryptionMethods.AES256);
                foreach (var entryName in sources.Keys)
                    archive.Add(Path.Combine(staged, entryName));
                archive.SaveAs(zipPath);
            }

            IronZipArchive.ExtractArchiveToDirectory(zipPath, check, password);
            if (Directory.GetFiles(check).Length != sources.Count)
                throw new InvalidOperationException("The archive does not hold one entry per document.");
            foreach (var (entryName, source) in sources)
            {
                var extracted = Path.Combine(check, entryName);
                if (!File.Exists(extracted) ||
                    !SHA256.HashData(File.ReadAllBytes(extracted)).SequenceEqual(SHA256.HashData(File.ReadAllBytes(source))))
                    throw new InvalidOperationException($"{entryName} did not come back from the archive intact.");
            }
            return File.ReadAllBytes(zipPath);
        }
        finally
        {
            Directory.Delete(work, recursive: true);
        }
    }
}
C#

각 ZIP 파일이 올바른 파일들을 포함하는지 어떻게 증명하나요?

/goal는 목표를 달성할 때까지 실행되며, 중간에 확인을 요청하지 않습니다.

/goal Every archive the download page produces matches TestData/manifest.csv.

Create a console project at tools/ArchiveAudit that meets these conditions:

- It references IronZIP 2026.10.2.
- The web project's compile items exclude it.
- Its startup copies IRONZIP_LICENSE_KEY into IronZip.License.LicenseKey.

Start CaseDocs with dotnet run --launch-profile http before the first post.
Stop it once the audit passes.

For each expected.csv row with the outcome zip, the audit does this:

1. Post that case page's form with every document ticked and the row's password.
2. Store the response as audit-output/<case>.zip.
3. Extract it with IronZipArchive.ExtractArchiveToDirectory and the password.
4. Confirm that the entry names and SHA-256 values equal that case's manifest rows.

Confirm too that extraction with a wrong password throws.
Keep fixing the app and rerunning the audit until all four archives pass.
Then put the results table in the Walkthrough and in your reply.
Text

.NET의 자체 리더는 이 확인을 수행할 수 없습니다. System.IO.Compression은 보정 AES-256 압축 파일의 항목 이름을 나열했지만 모두 15개 항목의 내용에 대해 "지원되지 않는 압축 방법"이라는 InvalidDataException을 던졌습니다. 따라서 이에 기반한 테스트는 바이트를 읽지 않고도 항목을 열거할 수 있습니다.

다운로드 규칙을 이후 작업에 적용하는 방법은?

Antigravity의 규칙 문서에 따르면 규칙은 AGENTS.md, GEMINI.md 및 수정된 파일 폴더에서 작업 공간 루트까지의 모든 폴더에 있는 .agents/rules/*.md 파일에서 가져옵니다. .agents/rules의 파일은 유효한 trigger이름을 지정하는 YAML 앞말로 열려야 하며, 누락되거나 인식되지 않는 트리거는 Antigravity가 메시지 없이 규칙을 버립니다. model_decision이 있는 경우 규칙의 경로와 설명만 프롬프트에 입력되며, 에이전트는 임무가 설명에 맞을 때 전체 텍스트를 불러옵니다.

/learn는 세션에서 교정을 규칙이나 기술로 변환합니다. 슬래시 명령 페이지는 그것이 AGENTS.md, GEMINI.md 또는 .agents/rules 내의 파일을 쓸 수 있다고 말하므로, 프롬프트에 규칙의 경로를 지정하세요.

/learn Turn what this session established about case downloads into a rule.
Write it at .agents/rules/case-archives.md.
Start the file with YAML frontmatter that sets trigger: model_decision.
Add a description saying the rule applies to work on case downloads or IronZIP archives.

The rule covers these points:

- how entry names are formed, and why
- how the saved archive is verified
- which temporary folders each request creates, and when they are deleted
- the messages for a short password and an empty selection
- that no change to the download is finished until two checks succeed

Those two checks are the expected.csv browser pass and the tools/ArchiveAudit run.
Record only what this session verified, and list anything unproven as open.
Text

그 후, 파일의 첫 줄을 읽고, 앞말이 스네이크 케이스로 트리거 model_decision을 올바르게 철자했는지 확인하세요.

언제 한 에이전트 이상을 파견해야 하나요?

자동화된 테스트를 한 에이전트에게 주고 브라우저 증거를 다른 에이전트에게 주세요.

Split this work between Agent A and Agent B.

Agent A creates CaseDocs.Tests, an xUnit project that references IronZIP 2026.10.2.
Keep it outside the web project's build.
The tests work like this:

- They start the app with WebApplicationFactory<Program>.
- They post the download form for every expected.csv row and assert the outcome.
- For zip rows, they extract the response with IronZIP into a temporary folder.
- They compare the names and SHA-256 values with manifest.csv.
- One test shows that a path outside the case folder gets a 400 response.
- They assert on extracted files, never on archive bytes.

Agent B starts once Agent A's suite passes:

1. Start the app with dotnet run --launch-profile http (http://localhost:5065).
2. Use /browser to download C-1002 and C-1003 from their case pages, and record each session.
3. Read each file's name and size from what the browser receives or from the response headers.
4. Stop the app.
5. Add the two recordings and one screenshot per finished page to the Walkthrough.

If there is no Walkthrough, save them under audit-output/ instead.
List them with those names and sizes in your reply.
If Agent A's suite does not pass, report the failing tests instead.
Text

WebApplicationFactory을 통해 양식을 게시하는 테스트에는 브라우저와 열린 포트가 필요하지 않으므로 몇 초 안에 잘못된 항목 이름을 잡아낼 수 있습니다.

유의 사항: 데스크톱 앱에서 에이전트 A와 에이전트 B는 개별 백그라운드 에이전트로 실행될 수 있습니다. 동일한 커밋에서 먼저 에이전트 A의 스위트가 통과된 경우에만 에이전트 B의 녹음을 신뢰하세요.

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

모든 7개의 프롬프트는 새로운 .NET 9 MVC 앱에서 아무도 키보드에 없는 상태에서 순서대로 Antigravity CLI 대화에서 실행되었으며, 다섯 사례, 규칙 및 두 CSV 파일을 보유하고 있었습니다. 아래 수치는 에이전트의 응답이 아닌 우리의 자체 릴리즈 빌드, 헤드리스 Chrome 다운로드 및 IronZIP 추출에서 나왔습니다.

  • 프롬프트 01 이후와 최종 앱에서 이 코드는 독립적인 브라우저 패스에서 예상된 6개 행과 일치했으며, 편집된 경로에 400으로 응답했습니다.
  • 두 지점 모두에서 IronZIP 추출은 각각 5개, 6개, 1개, 3개의 문서에 대해 모든 다운로드에서 매니페스트 이름 및 SHA-256 값을 반환했습니다.
  • 두 지점 모두에서 잘못된 비밀번호로 추출할 때 "유효하지 않은 비밀번호!!"를 던졌습니다.
  • 최종 압축 파일은 979,949, 779,422, 3,637 및 154,332바이트에 도달했으며, 이는 위의 서비스가 생성하는 크기와 동일했습니다.
  • 최종 다운로드 패스는 임시 폴더에 CaseDocs 파일을 남기지 않았습니다.
  • 앱, 감사 도구 및 테스트 프로젝트의 릴리즈 빌드는 0개의 경고 및 0개의 오류를 보고했습니다.
  • 2초 만에 xUnit 스위트가 7개 중 7개를 통과했습니다.
  • 역독을 쓰기 전 프롬프트 01은 임시 콘솔 프로젝트에서 IronZIP를 테스트하며 하나의 항목 실패를 만났습니다.
  • 프롬프트 01의 컨트롤러는 하나 이상의 문서가 체크되었을 때만 생성자로 압축 파일을 열었습니다.
  • 하나의 문서만 있을 때, 그 컨트롤러는 System.IO.Compression을 사용하여 항목을 나열했습니다.
  • 프롬프트 04는 그 체크를 추출 및 SHA-256 비교로 대체했습니다.
  • 첫 실행에서 아무 것도 수정할 필요 없이 /goal 감사가 통과되었습니다.
  • /learn은 model_decision 트리거와 함께 68줄 규칙을 작성했습니다.
  • 프롬프트 03에서 에이전트는 중첩된 powershell -Command로 IronZIP의 누락된 키 경고를 테스트했고, 이중 따옴표는 IRONZIP_LICENSE_KEY를 확장했습니다.
  • 결과 오류 메시지는 모델과 Antigravity의 .grmn/antigravity-cli 파일 및 대화 기록 파일에 키 값을 전달했습니다.
  • 일부 단계는 페이지와 달리 작동했습니다. 브라우저 하위 에이전트는 테스트 머신에서 Chrome에 연결할 수 없었습니다("DevToolsActivePort를 찾을 수 없습니다"), 따라서 에이전트는 사용자의 Playwright 스크립트를 사용하여 각 브라우저 패스, 스크린샷, 및 두 기록을 위한 헤드리스 Chrome를 실행했습니다. 답장은 여전히 브라우저 하위 에이전트에 크레딧을 주었습니다. 프롬프트 01, 04 및 06은 각각 검토를 기다리고 있다고 말한 후 같은 턴에서 편집되었습니다. CLI은 대화 전체에 대해 하나의 계획과 하나의 워크스루를 유지하여 나중의 프롬프트가 둘 모두를 덮어쓴 결과만 답변에서 전에 있는 테이블을 유지할 수 있었습니다. /learn 규칙은 IronZIP를 역컴파일하여 원인을 찾았으며, System.IO.Compression을 사용해 이러한 압축 파일을 추출하는 방법으로 명명했습니다. 한 에이전트가 두 에이전트 프롬프트의 두 절반을 같은 대화의 한 턴에서 수행했습니다. 감사 도구는 .NET 10을 대상으로 하며 모든 권한 프롬프트를 건너뜁니다.

ChatGPT Codex 가이드는 탐색 및 작업자 에이전트 사이에 압축 파일 수집 작업을 분할하고, 실행은 네 개의 에이전트 스레드를 생성했습니다. Claude Code 가이드는 계획 모드에서 암호화된 사례 아카이브의 현장 업그레이드를 계획하여, 이 계획 프롬프트가 수행하는 작업을 합니다. 허브의 실행 기록은 Antigravity 버전, 모델, 프롬프트 지속 시간 및 테스트 머신을 제공합니다.


문제 해결


질문?

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

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

더 읽기

시작할 준비 되셨나요?

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