Repository navigation
ar CONTRIBUTING
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
شكراً لاهتمامك. هذا مشروع صغير حسّاس أمنياً (فهو يمنح صلاحية الجذر)، لذا تُراجَع التغييرات مع وضع ذلك في الحسبان.
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/ Androidmksh؛ دون bashisms). - كل ملف يحمل ترويسة SPDX قصيرة. أبقِها.
- حدّث
CHANGELOG.mdتحت[Unreleased]عند أي تغيير حقيقي يراه المستخدم. - بتقديمك PR فإنك توافق على ترخيص مساهمتك بموجب رخصة Apache-2.0 الخاصة بالمشروع.
يُصان ملف README والوثائق بعدة لغات (README.<lang>.md). الإنجليزية هي المصدر الموثوق؛ والترجمات
تتبعها. إذا حسّنت ترجمة أو أضفت لغة، فأبقِ البنية ومراسي الأقسام مطابقة للنسخة الإنجليزية.
استخدم قوالب المشكلات للعلل وطلبات الميزات. وبالنسبة لأي شيء قد يُعرّض جهازاً للخطر، اتّبع
SECURITY.md وأبلِغ بسرّية بدلاً من فتح مشكلة علنية.
تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.