Google Antigravityを使用したIronZIPの使い方
クライアントにケースのドキュメントをパスワード保護されたZIPとして渡すページは正常にコンパイルされるが、ファイルが欠けたアーカイブ、通常のケースのエラーページ、別のケースのドキュメントを送信する可能性があります。
Google Antigravityの/browserコマンドはChromeブラウザのサブエージェントを開始します。このサブエージェントは実行中のページを操作でき、1つのプロンプトでパスワードを入力し、すべてのテストケースのダウンロードを押し、各結果のスクリーンショットを保持することができます。 IronZIPはサーバー上でAES-256暗号化を使用してアーカイブを作成し、再度抽出します。そのため、すべてのドキュメントがバイトごとに戻ってきたことを証明できます。 このガイドは、IronZIPのパスワード保護の例から始めて、ASP.NET Core MVCアプリでそのダウンロードページを構築し、事前にドキュメントとSHA-256ハッシュが知られている5つのケースに対してそれを確認します。
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.
コード変更の前にそれらの3つの回答を読みます。 それぞれの回答は、コンパイラエラーなしにアーカイブが誤る可能性のある方法をカバーしています。 無人のagy -pでは誰も計画を承認しないため、それが説明するコードの横にある計画アーティファクトを読みます。
プロンプトで変数に名前を付け、その値を貼り付けないでください。 会話に入力されたものはすべて、ソースファイル、コミット、またはターミナルの記録に到達する可能性があります。 IronZIPはappsettings.jsonにもIronZip.LicenseKeyエントリを受け入れ、コミットには他のすべてとそのファイルが含まれています。 サポートされているすべての場所はライセンスキーガイドにあります。
最小限のワークフロー(5ステップ)
- NuGetからC# ZIPライブラリをダウンロード
- 最初のプロンプトの前にlocalhostでASP.NET Core MVCアプリを実行します
- ダウンロードルールと各ドキュメントのSHA-256を含むマニフェストをコミットします
- 各ケースに対し
/browserがダウンロードを押し、結果をスクリーンショットに収めます - 各アーカイブをそのパスワードで抽出し、すべてのファイルをハッシュし、APIリファレンスでIronZIPメンバーを確認します
変更を承認する前に何を見直すべきですか?
各エントリ名がどこから来るか、各アーカイブが保存されるフォルダー、それを削除する行、およびアーカイブを読み戻すコードを確認します。 次に、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.
エントリ名の修正は、すでに通過したケースでもすべてのアーカイブを変更します。そのため、プロンプトは6つの行すべてを再実行します。
不完全または失敗したダウンロードを引き起こすのは何ですか?
当社のキャリブレーションでは、パスワード保護の例からのコードがダウンロードアクションに移動しました。 AES-256に切り替え、コンストラクタを使って保存されたアーカイブのエントリを数えました。 無人のChromeがIronZIP 2026.10.2で各ケースごとにダウンロードを押しました。以下のすべての失敗は警告なしにコンパイルされました。
| 何が起こったか | 原因 | 何を求めるべきか |
|---|---|---|
| 六文書のケースがダウンロードされましたが、抽出すると3ファイルになりました | IronZIPはファイル単独で各エントリに名前を付けるため、二つのletter.pdf、二つのscan.jpg、二つのsummary.pdfファイルが名前を共有しました | 相対パスから構築されたエントリ名で、コピーがそれらの名前の下に保存されました |
| 一文書のケースがエラーページを返しました | コンストラクタの読み戻しで、正しいパスワードで「無効なパスワード!」と表示されました | アーカイブを抽出する読み戻し |
| 空のケースがエラーページを返しました | エントリがないアーカイブの保存で「既存のアーカイブが壊れています!」とスローされました | IronZIP実行前の選択チェック |
| 編集された../C-1001/ledger.csvのチェックボックスの値で、別のケースのファイルがダウンロードに入れられました | 投稿されたパスを信頼するアクション | すべての投稿されたパスが解決され、ケースフォルダーの中に保持されました |
| 四つのZIPファイルが一時フォルダに滞在していました | IronZIPはパスにしか保存せず、誰もファイルを削除しませんでした | 要求ごとのフォルダー、要求の終了時に削除されます |
六文書のケースでエントリカウントチェックが成功しました。アーカイブには六つのエントリが含まれていたためです。
Antigravityで作業できるプロジェクトをどのように設定するのか?
エージェントはすでにローカルホストでビルドし、応答するアプリを必要としています。dotnet new mvc --framework net9.0はその1つを提供し、一度実行すると、Properties/launchSettings.jsonでポートを示します。 ポートはプロジェクトによって異なり、/browserプロンプトはそれを名前付けする必要があります。 最初はブラウザの許可リストにはローカルホストしか含まれていないので、http://localhost:<port>フォームにアドレスを保持します。
CaseFilesの下にケースフォルダー、docs/case-download-rules.mdにルール、各ケースとパスワードの結果を含むTestData/expected.csv、各ドキュメントのエントリ名、サイズ、SHA-256を持つTestData/manifest.csvをコミットします。5つのテストケースには、5つの通常文書、サブフォルダー全体で3つの名前が繰り返される6文書、単一の文、アクセントと日本語の名前を持つ3文書、ドキュメントが全くないもの含まれていました。 その後、エージェントにパッケージとキーを監査させます。
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.
後のプロンプトがプロジェクトまたはパッケージを追加するたびにそのバージョン番号を繰り返し、すべてのプロジェクトが同じIronZIPリリースに対してビルドされるようにします。 メモリからパッケージ名を書くエージェントは、ハルシネーションされた名前の下で公開された悪意のあるパッケージをインストールすることができます。この攻撃をslopsquattingといいます。 パッケージはIronZIPで、名前空間はIronZipです。
変数が設定され、License.LicenseKeyが割り当てられなかった状態で、キャリブレーションページはすべての4アーカイブケースの保存呼出しで失敗しました。 それぞれ、「Production License Required」を読み取る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をスローしました。 抽出は単一エントリアーカイブをそのまま返し,不正な、空のまたは欠落したパスワードごとに「無効なパスワード!!」とArgumentExceptionをスローしました。
IronZIP 2026.10.2ではZIP圧縮レベルが違いを生みませんでした。レベル0、1、6および9は,1,042,684バイトのプローブ文書から同じ970,545バイトのアーカイブを生成し,各ビルドは119から121ミリ秒を要しました。
/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.
エージェントサービスをこちらのものと比較してください。 IronZIP 2026.10.2に対してビルドしたもので,4つのアーカイブすべてを完全な状態で返し,後には一時フォルダを残しませんでした。
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);
}
}
}
各アーカイブが正しいファイルを保持していることをどのように証明しますか?
目標が達成されるまで/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.
.NET自体のリーダーはこのチェックを行うことができません。 キャリブレーションAES-256アーカイブのエントリ名をSystem.IO.Compressionがリストしましたが、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.
その後、ファイルの最初の行を読み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.
WebApplicationFactoryを通じてフォームを投稿するテストにはブラウザーと開いたポートは不要で、数秒で破損したエントリ名をキャッチします。
プロンプトが実運用で生成したものは何ですか?
7つのプロンプトが一つのAntigravity CLI会話で順番にキーボードの前にいなくても、新しい.NET 9 MVCアプリで全ての5つのケース、ルールおよび両方のCSVファイルを含んで実行されました。 以下の数値は私たちのリリースビルド、ヘッドレスChromeのダウンロードおよびIronZIPの抽出からのもので、エージェントの応答ではありません。
- プロンプト01の後と最終アプリで独立したブラウザーパスでコードが意図された6つのexpected.csv行すべてと一致し、編集されたパスに対して400で応答しました。
- 両方のポイントで各ダウンロードのIronZIP抽出は5つのうち5つ、6つのうち6つ、1つのうち1つおよび3つのうち3つのドキュメントのマニフェストの名前とSHA-256値を返しました。
- 両方のポイントで、間違ったパスワードで抽出は「無効なパスワード!!」とスローしました。
- 最終アーカイブサイズは979,949、779,422、3,637および154,332バイトに及び、上記のサービスが生成するものと同じサイズでした。
- 最終ダウンロードパスで一時フォルダーにCaseDocsファイルを残しませんでした。
- アプリ、監査ツールおよびテストプロジェクトのリリースビルドは警告0およびエラー0を報告しました。
- xUnitスイートは2秒で7つのうち7つを通過しました。
- プロンプト01で読み戻しを書く前に、IronZIPがスクラッチコンソールプロジェクトでテストされ、単一エントリの失敗を突きました。
- プロンプト01のコントローラーが複数のドキュメントがチェックされている場合にのみコンストラクタでアーカイブを開きました。
- 単一文書では、そのコントローラーがSystem.IO.Compressionでエントリをリストしました。
- プロンプト04がそれを抽出とSHA-256比較で置き換えました。
- /goalの監査が初回実行で修正なしに合格しました。
- /learnがmodel_decisionトリガーで68行のルールを書きました。
- プロンプト03でエージェントがネストされたpowershell -CommandでIRONZIP_LICENSE_KEYの展開をして欠落したキー警告をテストしました。
- 結果的なエラーメッセージは、モデルにキー値を運び、Antigravityの.gemini/antigravity-cliの下の記録ファイルに入りましたが、リポジトリファイルは保持していませんでした。
- 一部のステップはページと異なる方法で実行されました。 ブラウザーサブエージェントがテスト機でChromeに接続できなかったので(「DevToolsActivePortが見つかりませんでした」)、エージェントがすべてのブラウザパス、スクリーンショット、および両方の録音に対して独自のPlaywrightスクリプトでヘッドレスChromeを操作しました。 返答はまだブラウザサブエージェントにクレジットを与えていました。 プロンプト01、04および06はそれぞれレビュー待ちと述べた後、同じターンで編集されました。 CLIは会話全体のために1つの計画と1つのウォークスルーを保持し、後続のプロンプトが両方を上書きしたため、初期テーブルを保持したのは応答だけでした。 /learnルールではIronZIPをデコンパイルして得た原因を述べ、System.IO.Compressionをこれらのアーカイブを抽出する方法として名付けました。 1つのエージェントが同じ会話の1ターンで2エージェントのプロンプトの両方の半分をしました。 監査ツールは.NET 10をターゲットにしており、すべての許可プロンプトがスキップされました。
ChatGPT Codexガイドがアーカイブ受入ジョブをエクスプローラーおよびワーカーエージェント間で分割し、その実行が4つのエージェントスレッドを生成しました。 Claude Codeガイドでは、ここで/planプロンプトが行うように、プランモードで暗号化されたケースアーカイブのインプレースアップデートを計画しています。 ハブの実行記録には、Antigravityのバージョン、モデル、プロンプトの持続時間およびテスト機が示されています。
トラブルシューティング
- 例としてこのページが始まるパスワードでZIPを保護
- すべてのチェックが依拠する抽出呼び出し用の保護されたZIPを抽出
- 抽出せずにエントリ名とサイズが必要なときのアーカイブエントリを見る
- すべてのダウンロードがLicensingExceptionで終了する場合のIronZIPライセンスキー
- 4GBまたは65,535ドキュメントを超えたケースを提供する前のIronZIPファイルとアーカイブサイズの制限
質問ありますか?
質問がある場合は、support@ironsoftware.com にお問い合わせください。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。