AI Kodlama Asistanları ile IronZIP Kullanma

Curtis Chau
Curtis Chau
Güncellendi: 26 Ekim 2026

.NET'te dosyaları zip veya unzip yapmak için bir kodlama asistanına danışın, ve IronZIP, adını verebileceği kütüphanelerden biridir. IronZIP, Iron Software'ın ZIP, TAR, GZIP ve BZIP2 için arşiv kütüphanesidir. Ekim 2023'ten beri NuGet'te bulunmaktadır ve rehberleri ile kod örnekleri herkese açıktır.

Yalnızca isim, bir yardımcının kurulu sürümün nasıl davrandığını söylemez. IronZIP'in dokümantasyonunu okuyan bir yardımcı, temiz bir şekilde oluşturulan ve çıkarılan arşiv kodu yazabilir. Anıdan çalışan biri, diğer ZIP kütüphanelerine veya eski sürümlere ait çağrıları karıştırabilir. İlk isteği göndermeden önce dokümanları yükleyin.

Claude Code AI kodlama asistanı logosuChatGPT Codex AI kodlama asistanı logosuGitHub Copilot AI kodlama asistanı logosuCursor AI kod editörü logosuGoogle Antigravity AI kodlama ajanı logosu

Benim AI Asistanım ZIP Dosyalarını Kendi Başına Ele Alabilir mi?

IronZIP, araçların okumaları için yazılmış dokümantasyon yayınlar. Asistan, bir kez yüklediğinde, ZIP, TAR, GZIP ve BZIP2'yi hangi sınıfların ele aldığını ve her birinde hangi üyelerin olduğunu görebilir.

.NET zaten pol .ZIP, GZIP ve TAR okur ve yazar System.IO.Compression ve System.Formats.Tar aracılığıyla.

  • Açılan bir ZIP yine de hatalı olabilir. Eksik bir dosya veya aynı ada sahip iki girdi, hata vermeden açılan bir ZIP oluşturur.
  • .NET 9 ve .NET 10'da parola koruması eksik. ZIP sınıflarında parola seçeneği yoktur, ve ZipEncryptionMethod enumu yalnızca Microsoft's .NET 11 dokümanında geçmektedir. IronZIP, AES-128 ve AES-256 arşivler yazar.
  • BZIP2'nin .NET'te bir sınıfı yok. System.IO.Compression etki alanı BZIP2 türünü listelemez, bu yüzden kütüphane olmadan BZIP2, formatın manuel olarak yazılması anlamına gelir.
  • Paket ismi ve etki alanı büyüklük durumunda farklıdır. NuGet üzerindeki paket kimliği IronZIP iken etki alanı IronZip'dir. Bir asistanın uydurduğu paket ismi, saldırganların bilerek yüklediği bir taklitiyle eşleşebilir, buna slopsquatting denir. Yardıma tam ve doğru ismini verin.
  • Lisans yenileme ücreti yok. Her bir IronZIP ekip lisansı bir kez ödenir ve lisans sayfası her bir katmanın kaç geliştirici, konum ve projeyi kapsadığını belirler.

Adım 1: IronZIP'i Kur

Asistan, paketi eklesin, böylece yazarken IronZIP'in gerçek türlerini okuyabilsin.

Put IronZIP 2026.10.2 from NuGet into this project and restore it.
Afterwards, report the IronZIP version that the restore resolved.
Text

Bir terminalde, bu komut mevcut sürümü kurar.

dotnet add package IronZIP --version 2026.10.2
SHELL

IronZIP, .NET Standard 2.0 için oluşturulmuş tek bir paket olarak sunulmaktadır. Seçilecek ayrı bir Linux, macOS veya ARM paketi yoktur.


Adım 2: Lisans Anahtarınızı Uygulayın

Geçerli bir anahtar olmadan, bir IronZipArchive bellekte dosyaları kabul eder, ancak SaveAs IronSoftware.Exceptions.LicensingException fırlatır, ve mesajı Üretim Lisansı Gerekiyor şeklindedir. Bir arşivin çıkarılması ve açılması aynı istisnayı fırlatır. Yanlış yazılan bir anahtar, Lisans Anahtarı Tanınmıyor şeklinde hata verir. Aşağıdaki blok ücretsiz deneme anahtarı sunar.

IronZIP'u projenizde kullanmaya bugün ücretsiz deneme sürümüyle başlayın.

İlk Adım:
arrow pointer

Anahtarı uygulama başlangıcında, diğer IronZIP çağrılarından önce uygulayın. Bir ortam değişkeni, anahtarı kaynak kontrolünün dışında tutar.

IronZip.License.LicenseKey = Environment.GetEnvironmentVariable("IRONZIP_LICENSE_KEY");
C#

Temassız uygulama atayacak geçerli bir anahtar tanımlandıktan sonra IronZip.License.IsLicensed true olur, ve IronZip.License.IsValidLicense bir anahtarı atmadan test eder. IronZIP, kendi başına IRONZIP_LICENSE_KEY'ü okumaz. Ayar yapıldığında ve atama olmadığında, bu makalenin probunda IsLicensed hep yanlış kalmış, böylece SaveAs anahtarsız olduğunda başarısız olur.

Lütfen dikkat: IronZIP Lisans Anahtarları, bir anahtarın gidebileceği diğer yerleri kapsar, örneğin Web.config ve appsettings.json.

Adım 3: Asistanınızı IronZIP'in LLM Dokümantasyonuna Yönlendirin

  • llms.txt, IronZIP dokümantasyonunu her sayfa için tek satır özeti ile dizinler.
  • llms-full.txt bir dosyada her sayfanın özetini toplar, ancak bazı özetler başka bir kütüphaneyi tanımlar, bu yüzden kodu sayfaların kendilerinden alın.
  • llms-full-catalog.txt blog yazılarını da ekler, öğreticiler ve karşılaştırmalar için.
  • IronZIP obje referansı IronZIP'in etki alanlarını ve sınıflarını, belgelenmiş metod ve özellikleriyle birlikte listeler.
  • Yetenek dosyalarını kabul eden asistanlar skill.md'yi yükleyebilir, kurulum adımları, lisanslama, tarifler ve düzeltmelerle.
  • AI Ürün Bilgi Formu bir sayfa arka plan bilgisi verir.

Dizinin yanına net bir talimat ekleyin.

Read https://ironsoftware.com/zip/csharp/llms.txt ahead of any IronZIP code you write.
Use only APIs that those pages document.
An archive is an IronZipArchive, filled by Add and written by SaveAs.
Confirm anything else against https://ironsoftware.com/zip/csharp/object-reference/api/.
If you cannot confirm a member exists, say so instead of guessing.
Then list the IronZIP members this project calls.
Text

"Belirtilmemiş" yanıtı kabul edilen bir asistan, metod uydurmanın dışında bir seçeneğe sahiptir.


Adım 4: Projenize IronZIP Bağlamı Ekleyin

Bir sohbete yazılan kurallar oturumla sona erer, ancak bir proje dosyası her seferinde yeniden yüklenir. Dosya adı araca bağlıdır. Claude Kod CLAUDE.md dosyasını yükler, ve GitHub Copilot .github/copilot-instructions.md dosyasını yükler. ChatGPT Codex, Cursor ve Google Antigravity hepsi AGENTS.md dosyasını okur. Cursor ayrıca .cursor/rules/içindeki .mdc kural dosyalarını yükler, ve Antigravity ayrıca GEMINI.md'yi okur. Kural metni tüm dosyalarda aynıdır ve bir Cursor kural dosyası MDC ön bilgisi ekler. Bu bloktan başlayın.

All archive work in this project uses IronZIP, for ZIP, TAR, GZIP, and BZIP2.
The NuGet package is `IronZIP`, and the namespace is `IronZip`.

Follow these rules for every archive:
- Docs index: https://ironsoftware.com/zip/csharp/llms.txt
- IronZIP skill: https://ironsoftware.com/zip/csharp/skill.md
- Create ZIP files with `new IronZipArchive()` and `Add`.
- Open existing ones with `new IronZipArchive(path, password)`.
- Extract with `IronZipArchive.ExtractArchiveToDirectory`.
- `Add` stores each file under its bare file name.
- Give files from different folders unique names before adding them.
- Do not use `FromDirectory`, which leaves out files in subfolders.
- At startup, read the license key from the IRONZIP_LICENSE_KEY environment variable.
- The key is never inlined in code.
- Extract every archive to a fresh folder before it ships.
- Compare the extracted files with the originals.
- Do not add another compression library. If IronZIP cannot do something, say so.
Markdown

Yetenek dosyasında iki boşluk vardır. Tek dosya örneği IronZIP 2026.8.2'yi sabitlemiş, NuGet'teki 2026.10.2 paketinin iki sürüm gerisinde. Ayrıca bir klasörü ziplemek için IronZipArchive.FromDirectory önerir. 2026.10.2'de bu metod, 30 dosyalık bir test klasöründe sadece en üstteki 4 dosyayı zipledi ve alt klasörlerdeki 26'sını dışarıda bıraktı, hata vermeden.


5. Adım: Anında Kurulum Komutu

Adımlar 1'den 4'e kadar bu tek isteme sığar. Proje başladığında veya yeni bir oturum başladığında gönderin.

Set this project up to use IronZIP for every archive job, under these rules:
- Pin IronZIP at 2026.10.2 from NuGet.
- Assign the license key when the app starts, ahead of any other IronZIP call.
- Take it from the IRONZIP_LICENSE_KEY environment variable.
- The key never goes into source code or a committed file.
- Start from https://ironsoftware.com/zip/csharp/llms.txt, and code only against APIs it documents.
- Look up unfamiliar members in the API reference.
- Load https://ironsoftware.com/zip/csharp/skill.md as a skill file when your tool allows it.

Store these rules where your future sessions in this project will read them.
Tell me which file you saved them to.
Text

6. Adım: Çalışan Kod Üreten Talimat Desenleri

Bu üç alışkanlık, asistanın kendi başına daha az şey kararlaştırmasına yol açar.

Formatın, sınıfın ve korumanın adını verin. IronZIP her format için bir sınıfa sahiptir, ve sadece ZIP sınıfı parola alır. Hangisine ihtiyacınız olduğunu söyleyin.

Belirsiz IronZIP ile raporları zip.

Daha İyi IronZipArchive'i Encrypt ve EncryptionMethods.AES256 ile kullanarak, raporlar klasöründeki her PDF'yi reports.zip'e ekleyin, sonra onu geçici bir klasöre çıkarın ve her dosyanın orijinaliyle eşleştiğini onaylayın.

Sürümü ve çerçeveyi sabitleyin. Bir üye bir sürümden diğerine değişebilir. Sabitlenmiş bir sürüm, asistanın karşı çalışacağı tek API'yi verir.

Daha İyi .NET 9 ve IronZIP 2026.10.2'yi hedefleyin. İlk arşiv çağrısından önce IronZIP_LICENSE_KEY'den lisans anahtarını atayın.

Tam bir dosya isteyin. Bir snippet using satırını kaybedebilir, ve şifreleme enumu arşiv sınıflarından ayrı olan IronZip.Enum etki alanına aittir.

Daha İyi Tüm using direktifleri ve anahtar kurulumu ile, olduğu gibi derlenecek tam Program.cs'yi verin.


7. Adım: Geri Aldığınız Şeyi Doğrulayın

Üretilen kodu önce üç kontrolle gözden geçirin.

  1. Derlemesi tamamlanır. Release derlemesi hatasız biter.
  2. Anahtar önce ayarlandı. Anahtar satırından önce çalışan bir IronZIP kaydetme veya çıkarma LicensingException fırlatır.
  3. Her arşiv aynı dosyalara çıkar. Boş bir klasöre çıkarın ve özetleri orijinallerle karşılaştırın.

Üretilmiş IronZIP kodunda bunlara dikkat edin.

  • FromFile ile açılan bir arşiv. IronZipArchive.FromFile("existing.zip"), ZIP dosyasını içeren yeni bir arşiv oluşturur. Var olan bir arşivi new IronZipArchive(path, password) ile açın.
  • Async arşiv çağrıları. Hiçbir IronZIP arşiv sınıf hen member biten bir çağrıya başlamaz Async, dolayısıyla SaveAsAsync derlemez. Sunucu, isteğin iş parçacığı dışında ihtiyaç duyuyorsa, çağrıyı Task.Run ile sarın.
  • Akışa kaydetme. Bir akıştan veya byte dizisinden bir arşiv açılabilir, ancak hiçbir kaydetme metodu bir akışa yazmaz veya byte döndürmez. Yanıt ihtiyaç duyarsa, bir geçici dosyaya kaydedin ve byte'ları geri okuyun.

Ajanın Kendi Çalışmasını Doğrulamasına İzin Verin

Komutlar çalıştıran bir asistan aynı incelemeyi yapabilir.

Do a Release build of this project and run it.

Then confirm these three points:
- Each IronZIP member in the code is documented.
- IronZip.License.IsLicensed returns true.
- Every archive you saved extracts to files identical to the originals.

Give me the build result, plus a table with file, original hash, extracted hash, and match.
Text

IronZIP ile Girdi İsimleri

Add, ZIP ve TAR arşivlerinde her bir dosyayı çıplak dosya adının altında saklar. Farklı klasörlerden aynı isme sahip iki dosya, çoğaltılmış girişler olur ve çıkarma, son yazılanı saklar, hatasız. Bir dosya ekleyen hiçbir IronZIP metodu girdi ismi almaz. Her dosyayı, içinde olduğu yolun göreceli kısmından türemiş benzersiz bir isim altında bir hazırlık klasörüne kopyalayın ve kopyaları ekleyin.


IronZIP ile Parola Kontrolleri

AES ile şifrelenmiş bir arşiv açmak, parolasını test etmez. new IronZipArchive(path, password) yanlış bir parolayla 30 girdi olan AES-256 test arşivini açtı ve tüm 30 girdiyi saydı. Parola çıkarma sırasında kontrol edilir. ExtractArchiveToDirectory yanlış bir parolayla ArgumentException fırlatır ve mesajı Geçersiz parola!! olur ve hiçbir dosya yazmaz. Tek bir girişe sahip korumalı bir arşiv, 2026.10.2'de tersini gösterir. Yapıcı doğru bir parola ile bile Geçersiz Parola! fırlatır ve çıkarma çalışır.


Yenileyebileceğiniz Bir Sonuç

Boş bir klasörde yeni bir oturum açın ve istemi yapıştırın. Asistan programın her satırını yazar ve aşağıdaki geçiş listesi doğru bir sonucu tanımlar.

Lütfen dikkat: .NET 9 SDK'sına, internet erişimine, terminal erişimi olan bir asistana ve IRONZIP_LICENSE_KEY'de bir IronZIP deneme veya üretim anahtarına ihtiyacınız var.

İstem

Write a .NET 9 console app to archive legal case files.
If this folder holds a project or source code, report that and stop.
Don't ask questions. Keep all outputs in the project directory.

Follow this order:
1. Add the IronZIP NuGet package at version 2026.10.2 exactly, as the only archive package.
2. IronZIP writes and extracts every archive, using only members its docs show:
- https://ironsoftware.com/zip/csharp/llms.txt with its pages, skill.md included.
- The listed API reference wins any conflict.
3. At startup the program reads IRONZIP_LICENSE_KEY itself and sets IronZip.License.LicenseKey:
- Never print, echo or write the key, or list environment variables.
- Quit with a message if IronZip.License.IsLicensed is false.
4. If casefiles/ is missing, generate it with random seed 2026:
- 30 random-byte files exactly, deepest three folders down, cover-letter.txt on top.
- Sizes 1,024 to 2,097,152 bytes, but exactly 1 empty file.
- summary.txt in three different subfolders, exhibit-a.pdf twice.
- At least two names with a non-ASCII character.
- manifest.csv beside casefiles/, not inside, from the generator's records.
- Rows: forward-slash path, size in bytes, hex SHA-256.
5. Before archiving, measure casefiles/ on disk against those figures:
- If one is off, fix the generator, delete casefiles/ and regenerate.
- After the first archive, casefiles/ stays in place, unchanged.
6. Write these archives:
- bundle.zip: all 30 files, AES-256, password Case-2026.
- bundle.tgz: all 30 files, gzip-compressed TAR.
- cover.zip: cover-letter.txt alone, same password and encryption.
- Each entry name must let a recipient rebuild the relative path.
7. The packing code walks casefiles/ at run time:
- Only step 9 checks read manifest.csv.
- Its only case file literal is cover-letter.txt, and no other file is handled by name.
8. Build in Release and run it.
9. Check the saved archives with code that writes roundtrip.md from measurements:
- Extract each archive into its own kept folder, emptied each run, named in roundtrip.md.
- Extract bundle.zip with password Case-2025 into another such folder, never cleared afterwards.
- Count ZIP names and distinct names with System.IO.Compression.
- Count bundle.tgz likewise with System.Formats.Tar through a GZipStream.

roundtrip.md holds, in order:
- The step 5 figures, the naming rule, then a one-row-per-file table.
- Columns: path, size, manifest SHA-256, zip entry, zip SHA-256, tgz entry, tgz SHA-256, match.
- Extracted hashes come from files your rule finds. match is yes only if all three agree.
- Entry counts, and cover-letter.txt's manifest SHA-256 beside its cover.zip SHA-256.
- The Case-2025 exception type, message and folder file count.

10. You're done when all 30 rows match and each archive has one distinct entry name per file:
- cover.zip returns cover-letter.txt unchanged.
- The Case-2025 attempt throws and leaves its folder empty.
- Until then, fix the packing or checking code, rebuild and rerun over old outputs.
- After six failed runs, stop. Report failing checks, packing approaches tried and the cause.
11. Report the Release build, rows matched per archive, naming rule, step 5 figures, assumptions.
Text

IronZIP 2026.10.2 üzerindeki referans program istemi kalibre etti. Her arşivdeki 30 giriş arasında kendi klasöründen her dosya eklemek 27 farklı isim sağladı ve başlangıçta benzersiz isimlendirilmiş kopyalar, tohumlar 2026, 77 ve 4101'de 30'dan 30'unu eşleştirdi.

Çıktı

Entry list of the AES-256 bundle.zip from the acceptance run, read back with IronZIP, showing encoded entry names, sizes, and a 256-bit AES key on every entry

Resim, IronZIP'in Entries metodunun okuduğu çalışma bundle.zip'in giriş listesini gösterir. İşlenmemiş gidiş-dönüş tablosu, programın ölçtüğü her değeri saklar.

  • net9.0 Release derlemesi hiçbir uyarı ve hata vermedi.
  • Claude Code programın ilk yürütülmesinde her iki arşivde de tüm 30 satırı eşleştirdi, böylece onarım döngüsü hiç çalışmadı.
  • Kodlamadan önce çalıştırılan bir probe, Add'in casefiles/a/mid.txt'yi mid.txt olarak sakladığını gösterdi.
  • Program, her dosyayı göreli yolunda oluşturdu, % %25 olarak ve / %2F olarak yazıldı.
  • Test seti 30 dosya ve 6,762,825 byte içermekteydi.
  • İki dosya ismi ve bir klasör ismi ASCII olmayan bir karakter taşıyordu.
  • Bir dosya boştu ve en derin dosya üç klasör aşağıda, casefiles altındaydı.
  • Her iki demet de 30 farklı giriş ismi tuttu.
  • Her iki ZIP dosyasındaki her giriş WinZip AES kuvvet 3, AES-256 ayarını taşıyordu.
  • cover-letter.txt, cover.zip'ten değişmeden geri geldi.
  • Case-2025 girişimi ArgumentException fırlattı ve klasöründe 0 dosya bıraktı.
  • Bağımsız bir kontrol, her arşivi sadece Python ile, pyzipper ve tarfile aracılığıyla okudu ve 30'dan 30 kontrolü geçti.
  • Lisans anahtarı hiçbir proje dosyasında ve oturum transkriptinde hiçbir yerde görünmedi.
  • Adım 1 istemine cevaben, noktagit paket ismi büyüklük uyumsuzluğu nedeniyle obj silinene ve tekrar yüklene kadar başarısız oldu.
  • Kurulum isteğine cevaben, Claude Code kurallarını yeni bir CLAUDE.md dosyasına ve değişmemiş bir skill.md kopyasına bir proje becerisi olarak kaydetti.
  • Öz kontrolünde, Claude Code programın tüm 16 IronZIP üyesini belgelenmiş olarak raporladı.
  • Bazı adımlar sayfadan farklı çalıştı. Claude Code, kabul isteminden sonra Adım 1, Adım 3, Adım 5 ve Adım 7 istemlerini tek bir oturumda aldı. API probeleri, oturumun geçici klasöründe, proje dizini dışında bir scratch projesinde çalıştı. Jeneratör 30 yolun sabit bir listesini izledi ve tohumdan sadece boyutlar ve byte'ları aldı.

Geçen şeyler

  • Proje, manuel kod değişiklikleri olmadan Release'te derlenir.
  • Adım 5, roundtrip.md'deki rakamlar, düzgün tekrar ölçüldüğünde olduğu gibi devam eder.
  • roundtrip.md'nin tüm 30 satırı, çıkartılan özetler dosyalardan yeniden hesaplanarak eşleşir ve bundle.zip ile bundle.tgz her biri 30 farklı giriş ismi tutar.
  • cover.zip, cover-letter.txt'i değişmeden geri verir ve Case-2025 ile bundle.zip'i çıkarmak fırlatma yapar ve arkada dosya bırakmaz.
  • Proje klasörü araştırması, lisans anahtarını hiçbir dosyada bulmaz.
Lütfen dikkat: Adım 1'de sürümü değiştirmek başka bir sürümü test eder. IronZIP değişim günlüğü her sürümde neyin değiştiğini listeler.

Çalıştırma kaydı

  • Tüm çalıştırmalar, Core i9-14900KF ve 64 GB belleğe sahip bir Windows 11 x64 masaüstü kullanmıştır.
  • Her çalışma IronZIP 2026.10.2 kurdu, ve her proje .NET 9'u hedefliyor, Google Antigravity çalışmasındaki .NET 10 denetim aracı dışında.
  • Bir kılavuzun süresi, sayfasındaki istemlerin kaydedilmiş sürelerinin toplamıdır ve bu kılavuzun satırı sadece kabul uyarısını sayar.
  • Tablo tablo her aracın kendi oturum dosyaları ve çalıştırma kayıtları gelmiş ve ayrı bir sürüm kontrolu yapılmamıştır.
  • Son test Ekim 26, 2026 bu rehber için, Ekim 11 Google Antigravity için, Ekim 12 ChatGPT Codex ve GitHub Copilot için, Ekim 13 Claude Code için ve Ekim 15 Cursor için.
KılavuzAsistan ve versiyonModelSüre (dakika)
Bu kılavuzClaude Code 2.1.277, tek oturum, izin uyarıları kapalıClaude Opus 510.1
Claude CodeClaude Code 2.1.277, plan modunda uyarı 3Claude Sonnet 5, Claude Opus 5 ile opusplan aracılığıyla istem 3 planı için32.8
ChatGPT CodexCodex CLI 0.160.0, bir devam eden oturumGPT-6 Luna39.4
GitHub CopilotGitHub Copilot CLI 1.0.95, plan modunda istem 3GPT-6 Luna, Auto ile yönlendirilen9.3
CursorCursor 3.23.23 masaüstü uygulaması, Plan Modu ile 3. uyarıGrok 4.757.4
Google AntigravityAntigravity CLI 1.3.2, istem 1'den sonra 1.3.3'e güncellendi, izin istemleri /plan üzerinden atlandıGemini 3.8 Flash (Yüksek)27.5

Ajan'a Özgü Kılavuzlar

Her rehber, yukarıdaki adımları bir araca ve bir arşiv işine uygular.


Hata Ayıklama


Sorular?

Herhangi bir sorunuz varsa, support@ironsoftware.com adresinden bize ulaşın

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

Daha Fazla Oku

Başlamaya Hazır mısınız?

NuGet İndirmeleri 25,383Sürüm:2026.11yeni çıktı