Skip to content

ar CONTRIBUTING

github-actions[bot] edited this page Nov 17, 2026 · 5 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文


المساهمة في VD Dropbear

شكراً لاهتمامك. هذا مشروع صغير حسّاس أمنياً (فهو يمنح صلاحية الجذر)، لذا تُراجَع التغييرات مع وضع ذلك في الحسبان.

بنية المستودع

module/     the installable KernelSU / APatch / Magisk module (scripts, WebUI, config, installer)
patches/    the patch set applied on top of upstream Dropbear (the only changes to the SSH server)
src/        where CI unpacks upstream Dropbear to build (not committed)
scripts/    build and maintenance helpers
.github/    CI workflows and issue/PR templates
docs/       documentation (mirrored to the wiki)

البناء

يُنتَج الملف الثنائي عبر CI من mkj/dropbear الأصلي بالإضافة إلى التصحيحات الموجودة في patches/. وللبناء محلياً تحتاج إلى Android NDK:

scripts/build.sh            # fetches the tracked upstream, applies patches, builds arm64 + arm32

مجموعة التصحيحات مُصمَّمة عمداً لتكون بالحد الأدنى وقابلة للتدقيق: سلسلة هوية محايدة/قابلة للضبط، ومسارات تُحدَّد عبر الإعدادات لـ authorized_keys وملف كلمة المرور، وإصلاح openpty الخاص بأندرويد، وإعداد وقت التشغيل. من فضلك أبقِ التصحيحات الجديدة صغيرة وموثَّقة ومبرَّرة في الـ PR.

طلبات الدمج

  • تغيير منطقي واحد لكل PR؛ واوصف الدافع والأثر الأمني.
  • التزم بأسلوب الصدفة القائم (POSIX sh / Android mksh؛ دون bashisms).
  • كل ملف يحمل ترويسة SPDX قصيرة. أبقِها.
  • حدّث CHANGELOG.md تحت [Unreleased] عند أي تغيير حقيقي يراه المستخدم.
  • بتقديمك PR فإنك توافق على ترخيص مساهمتك بموجب رخصة Apache-2.0 الخاصة بالمشروع.

الترجمات

يُصان ملف README والوثائق بعدة لغات (README.<lang>.md). الإنجليزية هي المصدر الموثوق؛ والترجمات تتبعها. إذا حسّنت ترجمة أو أضفت لغة، فأبقِ البنية ومراسي الأقسام مطابقة للنسخة الإنجليزية.

الإبلاغ عن العلل والمشكلات الأمنية

استخدم قوالب المشكلات للعلل وطلبات الميزات. وبالنسبة لأي شيء قد يُعرّض جهازاً للخطر، اتّبع SECURITY.md وأبلِغ بسرّية بدلاً من فتح مشكلة علنية.


تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.

Clone this wiki locally