انطلق في تجربة اختبار اختراق جديدة مع
Athena OS

🏅وُلد لمحترفي أمن المعلومات، وصائدي الثغرات، والطلاب الشغوفين والهاكرز المتمرسين🏅

💞 احصل على Athena OS الآن! 💞

انقر على أيقونة Docker أعلاه لاستكشاف حاويات Athena OS Docker!

انقر على الأيقونة أعلاه لاستكشاف Athena OS WSL في تطبيق Microsoft Store!

تحديثات الحزم الآلية

يتم إبقاء الحزم في هذا المستودع محدثة تلقائيًا عبر سير عمل GitHub Actions يومي مدعوم بـ nvchecker.

كيف يعمل

تعمل الأتمتة كل يوم (ويمكن أيضًا تشغيلها يدويًا) وتمر بالخطوات التالية:

1. توليد الإعدادات — يقوم .nvchecker/generate-nvchecker-config.py بفحص كل PKGBUILD تحت src/ ويولّد تلقائيًا .nvchecker/nvchecker.toml. تُصنَّف كل حزمة كواحدة من:

   • حزمة إصدار — لديها pkgver= ثابت ورابط مصدر بعيد. تُتبَّع عبر أحدث وسم/إصدار على منصة الاستضافة.
   • حزمة VCS — لديها دالة pkgver() ومصدر git+https://. تُتبَّع عبر أحدث commit في المنبع.
   • حزمة محلية فقط — جميع المصادر ملفات محلية. تُتخطى بصمت (لا يوجد منبع لتتبعه).

2. فحص الإصدار — يستعلم nvchecker عن المنبع لكل حزمة متتبعة ويكتب النتائج في .nvchecker/newver.json. تتم مقارنة ذلك مع .nvchecker/oldver.json (المُودَع في المستودع) لإيجاد الحزم التي يتوفر لها إصدار جديد.

3. تحديث PKGBUILD وPR — لكل حزمة قديمة يقوم سير العمل بما يلي:

   • إنشاء فرع مخصص auto-update/<pkgname>-<newver>.
   • تحديث pkgver وإعادة تعيين pkgrel إلى 1 في PKGBUILD.
   • بالنسبة لـ حزم الإصدار: إعادة توليد المجاميع الاختبارية باستخدام updpkgsums.
   • بالنسبة لـ حزم VCS: استنساخ مستودع المنبع، وتشغيل دالة pkgver() محليًا لحساب سلسلة الإصدار الحقيقية بنمط Arch (مثل 131.940a5d3)، وإبقاء sha512sums=('SKIP') كما هي.
   • فتح pull request موسوم بـ auto-update للمراجعة البشرية قبل أن يصل أي شيء إلى main.

4. حفظ الحالة — يتم تحديث .nvchecker/oldver.json بالإصدارات التي شوهدت في هذه الجولة وإيداعها مرة أخرى في main، بحيث لا تفتح الجولة التالية PRs إلا للتغييرات الجديدة فعليًا.

منصات الاستضافة المدعومة

المنصة	الكشف
GitHub	github.com/<user>/<repo>
GitLab (gitlab.com + self-hosted)	gitlab.*/<user>/<repo>
Codeberg	codeberg.org/<user>/<repo>
Gitea (self-hosted)	gitea.*/<user>/<repo>
Sourcehut	git.sr.ht/~<user>/<repo>

توسيع متغيرات Shell في PKGBUILDs

يقوم مولّد الإعدادات وسير عمل CI معًا بحل مراجع متغيرات shell في أسطر source= بحيث تُعالَج الروابط غير المباشرة التالية بشكل صحيح:

_pkgname=${pkgname#athena-}
source=("git+https://github.com/Athena-OS/$_pkgname.git")

تُدعم صيغ توسيع معاملات bash التالية:

الصيغة	المعنى	مثال
$var / ${var}	استبدال بسيط	$pkgname → athena-settings
${var#prefix}	إزالة أقصر بادئة مطابقة	${pkgname#athena-} → settings
${var%suffix}	إزالة أقصر لاحقة مطابقة	${pkgname%-git} → athena-settings

القيود المعروفة

لا يتم حل تراكيب bash التالية بواسطة الأتمتة. سيتم تخطي ملفات PKGBUILD التي تعتمد عليها بلطف مع ملاحظة إعلامية — لا يُرفع أي خطأ، ويمكن دائمًا تحديثها يدويًا.

صيغة غير مدعومة	مثال	السبب
إزالة البادئة الجشعة ##	${var##*/}	يتم تنفيذ # غير الجشع فقط
إزالة اللاحقة الجشعة %%	${var%%.*}	يتم تنفيذ % غير الجشع فقط
استخراج السلسلة الفرعية	${var:0:3}	معامل مختلف، نادر في PKGBUILDs
استبدال النمط	${var//foo/bar}	معامل مختلف، نادر في PKGBUILDs
التوسيع الحسابي	$((pkgver + 1))	خارج نطاق تتبع الإصدارات
التوسيعات المتداخلة	${${var}#prefix}	غير صالح في POSIX؛ لا يُستخدم عمليًا

إذا كان PKGBUILD الخاص بك يستخدم أيًا مما سبق وتخطته الأتمتة، يمكنك إما إعادة كتابة الإسناد كسطر var=value بسيط أو فتح PR لتحديث الإصدار يدويًا.

LOL Omuamua