‫پشتیبانی از فشرده‌سازی Zstandard (Zstd) در NET 11.

جایگاه صنعتی Zstandard: کارایی بالای Zstd باعث شده است که در پروژه‌های بزرگ جهانی به عنوان استاندارد فشرده‌سازی انتخاب شود؛ از جمله سیستم‌فایل‌های لینوکس (btrfs و SquashFS)، مدیریت بسته‌های توزیع‌های آرچ‌لینوکس و فدورا، پلتفرم ابری AWS Redshift، سیستم Core Dump در FreeBSD و حتی آرشیو بازی‌های کنسول نینتندو سوییچ.

• ZstandardStream: یک کلاس بسته‌بندی استریم (Stream Wrapper) جهت مدیریت جریان‌های داده‌ای.
• ZstandardEncoder / ZstandardDecoder: ساختارهایی مبتنی بر Struct، بهینه برای مدیریت حافظه و سازگار با Span.
• ZstandardDictionary: قابلیتی منحصربه‌فرد جهت فشرده‌سازی داده‌های کوچک و مکرر با بازدهی بالا.
• ZstandardCompressionOptions: کلاسی برای تنظیم دقیق کیفیت، اندازه پنجره (Window Size) و ویژگی‌های اعتبارسنجی.

// Compress (فشرده‌سازی)
using var output = new MemoryStream();
using (var zstd = new ZstandardStream(output, CompressionMode.Compress))
{
    await inputStream.CopyToAsync(zstd);
}

// Decompress (باز کردن فشرده‌سازی)
using var zstdDecompress = new ZstandardStream(compressedStream, CompressionMode.Decompress);
await zstdDecompress.CopyToAsync(outputStream);

byte[] source = File.ReadAllBytes("data.bin");

// Compress
int maxLength = ZstandardEncoder.GetMaxCompressedLength(source.Length);
var compressed = new byte[maxLength];
ZstandardEncoder.TryCompress(source, compressed, out int bytesWritten);

// Decompress
int decompressedSize = ZstandardDecoder.GetMaxDecompressedLength(compressed.AsSpan(0, bytesWritten));
var decompressed = new byte[decompressedSize];
ZstandardDecoder.TryDecompress(compressed.AsSpan(0, bytesWritten), decompressed, out int bytesRead);

var options = new ZstandardCompressionOptions
{
    Quality = 6 // بازه عددی بین 1 تا 22، مقدار پیش‌فرض 3 است
};

using var zstd = new ZstandardStream(output, options);

// Program.cs
builder.Services.AddResponseCompression(x =>
{
    x.EnableForHttps = true;
    x.Providers.Add<ZstandardCompressionProvider>();
});

// آموزش دیکشنری از روی نمونه‌ها
byte[] allSamples = ...; // الحاق تمام داده‌های نمونه به هم
int[] lengths = ...;     // طول تک‌تک نمونه‌ها

using ZstandardDictionary dict = ZstandardDictionary.TrainFromSamples(allSamples, lengths, maxDictionarySize: 100_000);

// فشرده‌سازی با کمک دیکشنری - هر دو سمت باید از یک دیکشنری یکسان استفاده کنند
using var encoder = new ZstandardEncoder(dict);
encoder.Compress(payload, compressed, out int consumed, out int written, isFinalBlock: true);

نکته: طبق توصیه‌های استاندارد، حجم بهینه برای دیکشنری حداکثر ۱۰۰ کیلوبایت است و برای آموزش بهینه آن بهتر است حجم داده‌های نمونه حدود ۱۰۰ برابر حجم نهایی دیکشنری (حدود ۱۰ مگابایت داده نمونه واقعی و متناوب) باشد تا بالاترین نرخ بازدهی حاصل شود.