عن المشروع

يُيسّر هذا الإجراء الخاص بـ GitHub ضغط وفك ضغط الملفات مباشرةً ضمن سير عمل CI/CD. يدعم ستّة صيغ أرشيف: `zip` و`tar` و`tgz` و`tbz2` و`txz` و`tzst` (zstd). تشمل الميزات الرئيسية حماية كلمات المرور لملفات `zip`، والتحقق من تجزئة SHA256 عند فك الضغط لمنع تلف البيانات أو التلاعب بها، بالإضافة إلى الحماية المدمجة ضد ثغرات zip-slip. يولّد الإجراء ملخصاً شاملاً للوظيفة يعرض أحجام الأرشيف، ونسبة الضغط، وعدد الملفات، والمدة الزمنية، والتجزئة، وهو ما يُعرض مباشرةً على صفحة تشغيل GitHub Actions. كما يعرّض هذه المقاييس كمخرجات خطوة لاستخدامها في الخطوات اللاحقة من سير العمل، ما يمكّن من تطبيق منطق مشروط أو إعداد التقارير. يمكن للمستخدمين التحكم في مستويات الضغط من 0 (تخزين فقط) إلى 9 (أقصى ضغط)، واستخدام أنماط glob لمطابقة ملفات متعدّدة. يدعم الإجراء استبعاد ملفات أوDirectories محددة، وإزالة بادئات المسار، والحفاظ على هيكلة المجلدات عند استخدام أنماط glob. يوفر خيارات مرنة لتحديد مسارات وأسماء ملفات الوجهة مخصصة. يتضمّن دليل استكشاف الأخطاء وإصلاحها إرشادات للمشكلات الشائعة مثل عدم العثور على المصدر، أو تطابق أنماط glob، أو الأحجام الكبيرة للأرشيف، أو صيغة الاستبعاد الخاطئة، أو عدم تطابق التجزئة، أو أخطاء الأرشیف غير الآمن.