IronZIP'i Cursor ile Nasıl Kullanırsınız

Curtis Chau
Curtis Chau
Güncellendi: 26 Ekim 2026

.NET 9 hizmeti olan ClientDrop, bu kılavuzda her müşterinin belge klasörünü indirilen ZIP dosyasına sıkıştırır. System.IO.Compression ile birleşimleri oluşturur, bu da şifre belirleme yolu olmayan AES-256 ile korunması gereken tüm birleşimleri istemeyen bir uyumluluk sağlamak zorundadır. Birleşim kodu, IronZIP'e taşınmalı ve bir AI ajanı tarafından yapılan bir taşıma daha az görünür bir risk taşır. IronZIP ve System.IO.Compression, derlenmeye devam eden detaylarda anlaşamıyor. System.IO.Compression, sıkıştırdığı her dosyanın klasör yolunu tutarken, IronZIP'in Addi yalnızca dosya adını tutar, böylece farklı aylardan iki beyan aynı giriş adını alabilir.

Bağlantı, üç Cursor özelliği kullanır. Taahhüt edilen bir proje kuralı, System.IO.Compression alışkanlıklarını bırakmayı belirtir, Plan Modu'nda ajan, dosya değişikliklerinden önce haritalandırmayı bir plan olarak yazar ve istemler ve kuraldaki document linkleri ajanı IronZIP sayfalarına yönlendirir. Her ClientDrop birleşimi oluşturulduğunda şifrelenir, bu şifre ile çıkarılır ve hala her dosyayı içerdiğini kanıtlamak için şifre ile tekrar açılır.

Hızlı Başlangıç
NuGetNuGet ile Yükle

PM > Install-Package IronZip

Yukarıdaki komutu NuGet Paket Yöneticisi Konsolunda çalıştırarak veya NuGet Paket Yöneticisinde arama yaparak IronZIP'u yükleyin.

Cursor'da açık olan ClientDrop ile, bunu Agent'a yapıştırın. İki anlaşılan, birleşim sınıfına ve bir müşterinin klasörüne bağlanır.

@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

İnceleme komutu eski paketi okur ve kökteki contract.pdf'ten statements/2026-05/statement.pdf'e kadar, klasör yollarıyla yedi giriş görüntüler ve hiçbiri şifrelenmez.

Her istekte lisans anahtarını dışarıda bırakın. Ajan modunda Cursor, kod yazar ve terminal komutlarını yürütür, böylece bir konuşmaya yazılan anahtar, koda veya bir taahhüt mesajına kopyalanabilir. Bunun yerine IRONZIP_LICENSE_KEY ortam değişkenini ayarlayın. IronZIP bu değişkeni kendi başına okumaz, bu yüzden istemdeki kod onu License.LicenseKey'ye atar. Değişkeni ayarlayan ve hiçbir atama yapılmayan bir sondada, 'Üretim Lisansı Gerekli' okuyan LicensingException hatası fırlatıldı. Lisans anahtarı kılavuzu, IronZIP'in kendi başına kontrol ettiği yerleri kapsar, örneğin Git'in yok sayabileceği bir appsettings.json dosyası.



IronZIP çalışmaları için hangi Cursor modelini kullanmalısınız?

Composer, Cursor'un kendi agentik modelidir. Model seçici ayrıca Cursor tarafından ortak geliştirilen SpaceXAI'nın Grok modellerini ve OpenAI, Anthropic, Google ile diğer laboratuvarların modellerini sunar. Bu kılavuzdaki çalıştırma Grok 4.7 kullanıldı. Hangi modeli seçerseniz seçin, dosyaların adını, testleri ve beklenen sayıları istemde belirtin.

Cursor'a IronZIP belgelerini nasıl verirsiniz?

IronZIP'in llms.txti, her birinin kısa bir özeti ile örneklerini ve öğreticilerini listeleyen tek bir sayfadır. Ekim 2026 itibariyle, Cursor'da @ menüsü tarayıcıyı, Git farklılıklarını, terminalleri, geçmiş sohbetleri, dosyaları ve klasörleri sunar, belgeleri için bir giriş yoktur, bu nedenle istem, IronZIP belgelerini bağlantı olarak verir.

Bağlantı, klasör yollarının nereye gittiğine ve IronZIP'in bir şifreyi ne zaman kontrol ettiğine bağlıdır. Bir sonraki istem, Cursor'dan sayfalardan hem yanıt vermesini hem de bir nokta için kapaklı bir sayfa olmadığını belirtmesini ister.

@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

Sayfalar, şifreleme sorusuna iki yarıda yanıt verir. Parola örneği Encrypt işlevini EncryptionMethods.Traditional ile çağırır ve erişim örneği aynı çağrıyı AES-256'ya çevirir. Hiçbir sayfa Add işlevinin bir klasörle ne yaptığını belirtmez. İki sayfa yönlendirme içerir. Erişim örneği, yanlış bir şifrenin işlemi başarısız kıldığını söyler, bu yalnızca çıkarma için tutulurdu ve dosya ekleme örneği, mevcut bir ZIP'i FromFile ile açar, bu da o ZIP'i tek bir giriş olarak tutan yeni bir arşiv oluşturur. IronZipArchive referansı, hiçbir örnek sayfasının göstermediği üyeleri belgelir, örneğin SetPassword ve RemoveEncryption.

Lütfen dikkat: IronZIP ayrıca içindekiler kısmında adını ironzip olarak belirten bir beceri dosyası yayınlar. .cursor/skills/ironzip/SKILL.md olarak kaydedildiğinde, Cursor başladığında keşfedilir ve Agent'e /ironzip yazılması, onu bir mesaja ekler.

IronZIP geleneklerinizi şifreleyen proje kurallarını nasıl yazarsınız?

Proje kuralları, kodla taahhüt edilen, her biri Markdown ve bir ön bilgi bloğu olan .mdc dosyalarıdır .cursor/rules altında. Kurallar sistemi, sıradan bir .md dosyasını ön bilgi içermediği için .cursor/rules altında atlar. description, globs ve alwaysApply alanları, Cursor'un kuralları ne zaman uygulayacağına karar verir.

Bu kural, globlarla sınırlandırılmıştır, bu nedenle Cursor, bir hizmet veya testlerinde bir dosya ile istenen herhangi bir talebe bunu uygular ve @ironzip-bundles ad ile ekler. Bir satıra, virgüllerle ayrılmış birkaç desen gider. .cursor/rules/ironzip-bundles.mdc olarak kaydedin.

---
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 satırı, FromFile ile bir paketin açılması hataya neden olmadığı ve orijinal paketin değişmediği için oradadır.

Kural yalnızca Agent taleplerini etkiler. Cursor'un kurallar sayfasındaki SSS'ye göre, Sekme tamamlama kuralları göz ardı eder ve satır içine düzenleme (Ctrl+K) kullanıcı kurallarını göz ardı eder.

System.IO.Compression çağrılarını IronZIP'e nasıl haritalandırırsınız?

Sadece 'IronZIP kullanın' diyen bir kural, modelin her çağrının neye dönüşeceğini çalıştırmasını sağlar. Her IronZIP sonucu, IronZIP 2026.10.2 ile ölçülmüştür, bu da, farklı ay klasörlerinde üçü statement.pdf ve ikisi invoice.pdf adlarına sahip yedi belgeyi barındıran C-1042 müşteri klasörünü tutar.

System.IO.Compression çağrısıBeklenenIronZIP
ZipFile.CreateFromDirectoryYedi giriş, klasörler tutulduBeceri dosyasında gösterilen FromDirectory, yalnızca contract.pdf'i paketledi
Her dosya için CreateEntryFromFileHer dosya için bir girişAdd dört ad altında yedi girişi sakladı ve çıkartma dört dosya bıraktı
Güncelleme modunda Delete ve CreateEntryFromFileYenilenmiş belge adını korurYeni girişi, verildiği yol adıyla adlandırarak ReplaceEntry, burada ZipWork/cursor/repo-baseline/TestData/reissue/C-1042/contract.pdf
Testlerde ZipFile.OpenReadHer giriş okunabilirAES girişleri listelendi ve birini okumak UnsupportedCompressionMethod 'desteklenmeyen sıkıştırma yöntemi' InvalidDataException hatası fırlattı

Yinelenen adlarla paket üzerinde, ReplaceEntry herhangi bir yeniden adlandırmadan önce başarısız oldu. İki invoice.pdf girişi üzerinden 'Aynı anahtara sahip bir öğe zaten eklendi' ArgumentException hatası fırlattı. Şifreleme işlemi çalıştı. Encrypt ile EncryptionMethods.AES256 yedi girişin hepsini şifreli olarak işaretledi ve statements_2026-03_statement.pdf gibi benzersiz düz isimlerle bir klasörün düzenlenmiş kopyası, SHA-256 ile orijinalleriyle eşleşen yedi dosyayı çıkardı. Yinelenen adlar en zor sorunu yakalayarak, bir beyanı kaybeden bir paket hala yedi girişi tuttuğundan, bir kontrol kontrolü geçebilirken müşteri dört belgeyi indirir.

Çevirileri kurala ekleyin.

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'e geçişi nasıl planlar ve yürütürsünüz?

Bir sonraki istemi göndermeden önce sohbet girişini Plan Modu'na Shift+Tab ile döndürün. Plan Modu'nda Agent, kodu araştırırken açıklayıcı sorular sorabilir.

@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, düzenleyebileceğiniz bir Markdown dosyasıdır, bu yüzden yanlış bir haritalama, herhangi bir şey inşa edilmeden önce düzeltilebilir. Plan doğru olduğunda, Plan Modu'ndan inşa edin veya kontrolleri ekleyen bir sonraki istemle Agent moduna geri dönün.

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

Kalibrasyonumuzda, her çağrıyı en yakın IronZIP üyesiyle değiştiren düz bir çeviri temiz bir şekilde derlendi ve altı testin dördünü geçti. İki başarısızlık çıkarma kontrolü ve yeniden gönderim oldu. Kurala uyan port hepsini geçti.

Korunan bir birleşimden bir belgeyi nasıl çıkarırsınız?

BundleBuilder ayrıca henüz bir müşteri tarafından indirilmemiş bir paketten bir belgeyi kaldıracak bir yol gerektirir. BundleBuilder.cs içinde, tüm Reissue metodunu vurgulayın, açık sohbetinize eklemek için Ctrl+Shift+L'e basın ve talebi Agent modunda gönderin.

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

Sonuçta ortaya çıkan Withdrawal, Contains bir korumadır, ardından Delete, Encrypt ile EncryptionMethods.AES256 ve Save, kendi şifresiyle açılmış bir arşivde. C-1042'den contract.pdf'in çekilmesi altı giriş bıraktı, hala tümüyle şifreli. Kalibrasyonumuzda iki belgelik bir paket birini tuttu ve yapıcı daha sonra paketi açmakta başarısız oldu.

Tek belgeli bir paket kendi şifresini neden reddeder?

IronZipArchive yapıcı doğru şifreyi korunan bir arşiv tam olarak bir giriş tuttuğunda reddeder. IronZIP 2026.10.2'de 'Geçersiz Şifre!' okuyan bir Exception, AES-256, AES-128 ve Geleneksel şifreleme ile şifrelenmiş tek girişli arşivler için atıldı ve byte dizisi aşırı yüklemesi ve FromArchive aynı şeyleri yaptı. ExtractArchiveToDirectory aynı parola ile dosyayı hatasız çıkardı ve iki veya daha fazla giriş normal bir şekilde açıldı.

Müşteri C-1077'nin tek bir belgesi, bir hoş geldiniz mektubu vardır. Klasörünü, düzeltilmiş mektubu ve programı birlikte belirtin.

@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

Kalibrasyonumuzda yazılmış olan paket, liste ve yeniden gönderim başarısız oldu ve paket komutu kendisi de başarısız oldu, bu da giriş sayısını yazdırmak için yeni paketi listeler. Paketin geçici bir klasöre çıkarılması ve yeniden düzenleme veya çekilme için o klasörden tekrar yazılması, paketi 2.643 bayt mektubu listeler ve düzeltilmiş olanı onunla değiştirdi. Çevirilerin altına bu bloku ekleyin.

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

Paketler için regresyon testlerini nasıl yazarsınız?

Bir Cloud Agent, regresyon süitini yazabilir. Bağlı olduğunuz kaynak kontrolünden depoyu klonlar, böylece önce bağlantıyı kurun ve Dashboard'da Cloud Agent'ı başlatmadan önce IRONZIP_LICENSE_KEY bir sır olarak ekleyin.

@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

Yanlış şifre testi paketi çıkarmalıdır. Üç girişli bir pakette, yapıcı yanlış bir parolayı hatasız olarak aldı ve giriş sayısı, giriş listesi ve ad aramak, sanki doğruymuş gibi yanıt verdi. ExtractArchiveToDirectory, İlk olarak ArgümanException 'Geçersiz şifre!!' diyerek bunu reddeden çağrıydı. Bu nedenle, girdiği listeyi paketleyerek çıkardıysa, ilk okumada yanlış parolayı reddeder.

IronZIP'in AI kodlama asistanları kılavuzu, tanımlanmış geçiş kriterlerine karşı tek bir IronZIP görev çalıştırır.

Gerçek bir çalıştırmada istemler ne üretti?

Yedi istem Cursor'a sırayla, bir sohbette, bu kılavuz için yapılan ClientDrop depolarının bir kopyasına karşı gönderildi. Kopya System.IO.Compression BundleBuilder'ı, System.IO.Compression ile paketleri okuyan altı xUnit testi ve müşteri C-1042'yi içeriyordu. Kural dosyası ve müşteri C-1077, onları kullanan istemlerden hemen önce eklendi ve lisans anahtarı yalnızca bir ortam değişkeni olarak ayarlandı. Aşağıdaki her rakam, sohbet bittikten sonra taahhüt edilen kodun derlemeleri ve çalıştırmalarından gelmektedir.

  • 6 testin hiçbiri bağlantıdan önce geçmediyse, ve bağlantıdan sonra da aynı 6 geçmiştir.
  • Taşınmış C-1042 birleşimi benzersiz düz isimler altında 7 giriş bulunduruyordu.
  • IronZIP, o paketten 7 dosya çıkardı, bu da müşterinin klasörünün tuttuğu sayıyla aynıydı.
  • IronZIP ile hiçbir kod paylaşmayan bir Python ZIP okuyucu olan pyzipper, tüm 7 girişte AES-256 şifrelemesi buldu.
  • Çıkarılan tüm 7 dosya, müşteri klasöründeki dosyalar ile SHA-256 ile eşleşti.
  • IronZIP'in nerede bir şifre kontrol ettiğinin sorulduğunda, Cursor yapıyı adlandırdı ve erişim örneğini örnek verdi.
  • Bir birleşimdeki bir adı paketle olmadığı için 'KeyNotFoundException' hatası fırlatıldı.
  • Onarım öncesinde C-1077 için paket, liste ve yeniden çıkarım adımları IronZipArchive yapımından 'Geçersiz Şifre!' İstisna fırlatıldı.
  • Düzeltme sonrası listede hoş geldiniz mektubu 2.643 baytta görüldü ve yeniden gönderim sonrası 2.761 baytta.
  • pyzipper tarafından çıkarılan yeniden gönderilmiş mektup, SHA-256 tarafından düzeltilmiş dosya ile eşleşti.
  • Her C-1077 birleşimi ayrıca boş bir giriş olan __bundle_keep'i de içeriyordu, bu da çıkışta ikinci bir dosya olarak yazdı.
  • Nihai kodda, iki belgeli bir paketten bir belge çekildiğinde bir giriş kaldı ve liste ardından 'Geçersiz Şifre!' fırlattı.
  • Test istemi 6 testi ekledi ve tüm 12 test geçti.
  • IronZIP 2026.10.2, hizmetteki tek paketti ve içinde kalan System.IO.Compression çağrısı olmadı.
  • Her İstek yapımından sonra, bir uyarı veya hata olmadan tamamlandı.
  • Bazı adımlar sayfadan farklı çalıştı. Plan Modunda, Cursor yakınına ironzip-bundles aramak için depo dışındaki klasörlere baktı ve kural dosyasını açmadan önce buldu. C-1077 için, Cursor tek belge paketlerine __bundle_keep girişini ekledi ve onu okuma ile çıkartma yerine bu kural içine yazdı. Cloud Agent istemi, aynı sohbette yalnızca lokal olarak Agent modunda gönderildi, Cloud Agent olarak değil.

Herhangi bir koddaki plan onayı, her arşivi çıkarılarak kopyalandı ve böylelikle tek girişli bir arşiv işleyecek Claude Kod kılavuzunda da olur. GitHub Copilot kılavuzu kendi TAR kurallarını log arşivleyici ve uygulamalar için yalnızca yol-özel talimat dosyasının applyTo değeri ile kısıtlar ve globlar bu kuralı aynı şekilde kısıtlar. çalıştırma kaydı Cursor sürümünü ve modelini adlandırır ve toplam istem zamanını ve test makinesinin donanımını verir.


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ı