
نبذة على المشروع
Android Ad Cleaner هو أداة لحيد الإعلانات موجهة للهواتف أندرويد الصينية، كتقدر تعالج الإعلانات الشخصية ديال النظام، وتتبع الإعلانات، والبحث الرائج، والأخبار ديال الشاشة السالبة، وخانات الترويج فمتجر التطبيقات، والإشعارات التسويقية، ومكوّنات الإعلانات والتطبيقات السريعة.
ما كيحتاجش Root للهاتف، ولا كيفتح Bootloader، ولا كيدير فلاش للنظام، ولا كيبدل قسم system، وما كيحيدش ولا كيوقف تطبيقات النظام. العمليات الأساسية هي تعديل الإعدادات العلنية اللي كيوفروها النظام وتطبيقات الشركة المصنّعة؛ غير ملي كيعلّق مكوّنات الإعلانات كيستعمل pm suspend، وكيحتاج موافقة واضحة من مالك الهاتف.
المشروع كيحاول يخلي البحث، والبطاقات المفيدة ديال الشاشة السالبة، وتثبيت وتحديث التطبيقات من المتجر، وتنبيهات الطقس، والطلبات، والتوصيل، وإشعارات تحديث النظام خدامين. حيث واجهة الشركة المصنّعة ممكن تتبدل مع تحديثات النظام، خاصك دير نسخة احتياطية وتتأكد من كل تعديل قبل ما تطبقو.

الوظائف الأساسية
- إعلانات النظام: سدّ إعدادات الإعلانات الشخصية، وتتبع الإعلانات OAID، وخدمات الاقتراحات الذكية وغيرها.
- البحث الرائج والأخبار: معالجة لائحة البحث الرائج اللي كتهبط، وأخبار الشاشة السالبة، وتدفق المعلومات فالمتصفح، مع إمكانية تحويل المتصفح للصفحة الرئيسية البسيطة.
- ترويج متجر التطبيقات: سدّ خدمات تدبير العروض الدوّارة، وإعلانات بدء التشغيل، والأنشطة العائمة، ومكافآت تسجيل الدخول وغيرها.
- الإشعارات التسويقية: سدّ قنوات إشعارات “المحتوى والتسويق” و“العروض والأنشطة” حسب الحاجة، مع الاحتفاظ بإشعارات الطلبات، والتوصيل، وإنذارات الطقس، والتحديثات.
- مكوّنات الإعلانات: الكشف على مكوّنات بحال
com.opos.adsوcom.miui.systemAdSolution، وتعليقها باستعمالpm suspendمن بعد موافقة المستخدم. - التطبيقات السريعة: الكشف على البرامج الصغيرة اللي كتخدم بلا تثبيت وكتتحل مباشرة من بعد الضغط على إعلان، مع توفير إمكانية سدّها.
- سكربتات الموديلات: فتح الصفحات المناسبة أوتوماتيكياً حسب الموديل وإصدار النظام، والتعرف على النصوص وتبديل الإعدادات.
- النسخ الاحتياطي والاسترجاع: حفظ لقطة قبل التعديل؛ ويمكن استرجاع الحزم المعلّقة وقنوات الإشعارات بالأوامر.
اختار طريقة الاستعمال المناسبة
المشروع كيوفر أربع طرق للاستعمال. أغلب المستخدمين من الأفضل ليهم يبدأو بالعميل المكتبي، حيث ما كيحتاجش تثبيت Python وما كيحتاجش أداة ذكاء اصطناعي.
- العميل المكتبي: مناسب للي عندهم حاسوب Mac أو Windows وباغين يكملو العملية من خلال واجهة رسومية.
- الوكيل الذكي: خلي أداة ذكاء اصطناعي قادرة تنفذ أوامر الطرفية تقرا قواعد المستودع وتشغل العملية.
- الذكاء الاصطناعي عبر الدردشة: إلا كان عندك غير الهاتف، تقدر تخلي DeepSeek أو 豆包 أو ChatGPT يوجّهك خطوة بخطوة باش تدير الإعدادات يدوياً.
- اللائحة اليدوية: سدّ العناصر وحدة بوحدة حسب لوائح كل علامة تجارية فالمستودع، وهي مناسبة للي باغين يتحكمو فكل خطوة.
العميل المكتبي وطريقة سطر الأوامر كيحتاجو تفعيل وضع المطوّر وتصحيح USB فالهاتف من قبل. أما طريقة الذكاء الاصطناعي عبر الدردشة أو اللائحة اليدوية، إلا كان عندك غير الهاتف، فما كتحتاجش تربطو بالحاسوب.
الطريقة الأولى: تثبيت العميل المكتبي
اختار حزمة التثبيت الصحيحة
العميل المكتبي 0.2.0 كيوفر الإصدارات التالية:
- Mac بمعالج Apple: مناسب لموديلات M1 وما بعده من أجهزة Apple Silicon، حمّل mac-arm64 DMG.
- Mac بمعالج Intel: حمّل mac-intel DMG.
- نسخة تثبيت Windows 10 أو 11: حمّل مثبّت Windows.
- نسخة Windows 10 أو 11 بلا تثبيت: حمّل ZIP المحمول، فك الضغط وشغّل
AndroidAdCleaner.exe.
إلا ما كنتيش عارف نوع معالج Mac، حلّ قائمة Apple اللي فالزاوية الفوقانية على اليسار واختار “حول هذا الـ Mac”. إلا بدا الحقل ديال “الشريحة” بـ Apple M، اختار نسخة Apple، وإلا اعتمد على معلومات الجهاز واختار نسخة Intel. تقدر تشوف الإصدارات الأخرى فصفحة Releases.
حزم Mac موقّعة ودازت من توثيق Apple. إلا بان فـ Windows التنبيه “Windows حمى حاسوبك”، تبع تعليمات المشروع، كليك على “معلومات إضافية”، ومن بعد اختار “تشغيل على أي حال”.
ربط الهاتف
- حلّ وضع المطوّر من إعدادات الهاتف.
- دخل لخيارات المطوّر وفعّل تصحيح USB.
- ربط الهاتف بالحاسوب بكابل البيانات.
- إلا بانت نافذة ترخيص تصحيح USB فالهاتف، تأكد من بصمة الحاسوب وسمح بالربط.
- شغّل Android Ad Cleaner وتسنى حتى يتعرف العميل على الهاتف.
إلا ما كنتيش عارف كيفاش تفتح تصحيح USB، شوف الشرح المصوّر لوضع المطوّر فالمستودع.

فحص واختيار العناصر اللي بغيتي تحيد
العميل كيفحص موديل الهاتف، وإصدار النظام، وسكربتات الموديلات المتاحة، والتطبيقات السريعة ومكوّنات الإعلانات. من بعد ما يكمل الفحص، راجع واش معلومات الجهاز اللي تعرّف عليها صحيحة.

ملي تختار العناصر اللي بغيتي تسد، ردّ بالك خصوصاً لقنوات الإشعارات. تقدر تسد الإشعارات التسويقية، ولكن ما خاصكش تحدد افتراضياً قنوات الطلبات، واللوجستيك، وإنذارات الطقس، وخدمات النظام. إلا بانت صفحة اتفاقية المستخدم، المشروع ما غاديش يوافق عليها بلاصتك؛ اختار “إلغاء” أو “نتكلف بها من بعد”.

نفّذ العملية وراجع النتيجة
من بعد ما تأكد العناصر اللي غادي تتبدل، بدا التنفيذ. العميل غادي يبيّن التقدم والسجل المباشر، وفصفحة الإكمال غادي يعرض نتيجة كل خطوة. الخطوات اللي ما لقاوش المدخل ديالها غادي يتجاوزها، وما غاديش يضغط عشوائياً على صفحات أخرى باش يكمل العملية.

من بعد الإكمال، راجع متجر التطبيقات، والمتصفح، والبحث اللي كينزل، والشاشة السالبة، ومركز الإشعارات، وتأكد باللي المحتوى الترويجي نقص، وتأكد حتى من أن تثبيت التطبيقات وتحديثها وإنذارات الطقس وتذكيرات التوصيل خدامين مزيان. فالآخر، تبع التعليمات وسدّ وضع المطوّر.

الطريقة الثانية: تشغيل العملية كاملة من سطر الأوامر
طريقة سطر الأوامر مناسبة للي باغين يشوفو كل خطوة، أو يختارو العمليات يدوياً، أو يساهمو فملاءمة الموديلات. قبل البداية، خاصك تنسخ المشروع، وتوجد بيئة Python، وتتبع وثيقة التحضير ديال المشروع باش تثبت وتربط ADB.
تثبيت الاعتماديات
git clone https://github.com/rddmwmddr/android-ad-cleaner.git
cd android-ad-cleaner
pip3 install -r requirements.txtالتعرف على الجهاز والفحص للقراءة فقط
أولاً عرض الأجهزة المربوطة، وشوف الرقم التسلسلي، والموديل، وواش كاين سكربت موديل مطابق:
python3 tool/run.py devicesمن بعد بدّل <序列号> فالأمر بالرقم التسلسلي الحقيقي، ونفّذ فحص القراءة فقط:
python3 tool/run.py -s <序列号> checkcheck كيتستعمل باش تعرف الحالة الحالية، وما خاصوش يبدل الإعدادات مباشرة. إلا كانو مربوطين بزاف ديال الأجهزة، ضروري تحدد الهدف باستعمال -s باش ما تخدمش على الجهاز الغلط.
دير نسخة احتياطية وشغّل سكربت الموديل
قبل التعديل الفعلي، حفظ لقطة، ومن بعد شغّل السكربت المطابق للموديل الحالي وإصدار النظام:
python3 tool/run.py -s <序列号> backup
python3 tool/run.py -s <序列号> recipeسكربت الموديل كيسجل شنو هو التطبيق اللي خاصو يتحل، وشنو هي صفحات الإعدادات اللي خاصك تدخل ليها، وشنو هي المفاتيح اللي خاصها تسد، وشنو هي الوظائف اللي خاصها تبقى. إلا ما تطابقش الموديل أو إصدار النظام، المحرك غادي ينبهك؛ وإلا ما قدرش يتأكد من المدخل، غادي يتجاوز الخطوة المعنية.
فحص وسدّ الإشعارات التسويقية
أولاً فحص قنوات الإشعارات، ومن بعد استعمل channels.tsv الموجود فمجلد النسخة الاحتياطية باش تطبق الاختيارات:
python3 tool/run.py -s <序列号> chan-scan
python3 tool/run.py -s <序列号> chan-off backups/<型号>-<时间>/channels.tsvما تسدش جميع الإشعارات دفعة وحدة. الطريقة الصحيحة هي تسد قنوات “المحتوى والتسويق” و“العروض والأنشطة”، وتخلي إشعارات الطلبات، واللوجستيك، وإنذارات الطقس، والتحديثات.

فحص التطبيقات السريعة وإنهاء العملية
python3 tool/run.py -s <序列号> quickapp
python3 tool/run.py -s <序列号> quickapp off
python3 tool/run.py -s <序列号> finishالأمر الأول مخصص لفحص التطبيقات السريعة، والثاني هو اللي كينفذ السدّ. من بعد ما تكمل جميع الفحوصات، شغّل finish وتبع التعليمات باش تسدّ وضع المطوّر. وتقدر حتى تخلي الأمر التالي آخر خطوة:
python3 tool/run.py -s <序列号> dev-off --yesمن بعد تنفيذ
dev-off --yesغادي ينقطع اتصال التصحيح، لذلك ضروري يكون فآخر العملية.
الطريقة الثالثة: خلي الوكيل الذكي ينفذ العملية
إلا كنت كتستعمل WorkBuddy أو Claude Code أو Codex أو Trae أو Cursor أو شي أداة كتقدر تقرا المستودع وتشغل الأوامر، ربط الهاتف بالحاسوب ومن بعد صيفط للوكيل المحتوى التالي:
عافاك نسخ https://github.com/rddmwmddr/android-ad-cleaner ، وقرا AGENTS.md اللي فالمستودع،
ومن بعد عاوني نحيد الإعلانات من هاد الهاتف المربوط بالحاسوب. قبل كل تعديل، قول ليا شنو غادي تبدل.AGENTS.md فيه قواعد التشغيل الموجّهة للذكاء الاصطناعي. حتى إلا كان التنفيذ غادي يديرو وكيل ذكي، خاصّو يطلب منّو يوضّح الإعدادات اللي غادي يبدّل قبل كل تعديل، وما يفوّتش لا النسخ الاحتياطي لا تأكيد المستخدم.
تقنيات متقدمة وتنبيهات
تأكّد باللي سكريبت الطراز مطابق فعلاً
المصنّعين يقدرو يبدّلو سميات وترتيب صفحات الإعدادات من بعد تحديثات صغار للنظام. وحتى التليفونات من نفس الماركة ما خاصّش نفترضو باللي الواجهة ديالها مطابقة تماماً. السكريبتات فالمستودع منظّمة حسب الماركة والطراز ونسخة النظام؛ إلا ما كانتش النسخة مطابقة، خاصّك تعتمد على نتيجة الفحص وما تطبّقش بالقوة سكريبت ديال طراز آخر.
الـ README فيه بعض الأجهزة اللي تجرّبات فعلياً من Honor وOPPO وXiaomi وvivo، ولكن مستوى الاكتمال ماشي هو نفسه فكل الطرازات. وظائف إشعارات التسويق وتتبع الإعلانات عامة نسبياً، أما العمليات التلقائية الخاصة بطراز معيّن فقد تبقى محتاجة للتحقق أو الإضافة.
تعامل بحذر مع مكوّنات الإعلانات
المشروع ما كيستعملش pm uninstall ولا pm disable-user باش يحيد أو يعطّل تطبيقات النظام. بالنسبة لمكوّنات الإعلانات المستقلة، كيستعمل غير pm suspend لتعليقها من بعد موافقة المستخدم. قبل التنفيذ، خاصّك تقرا سميّة المكوّن والوصف ديالو، وإلا ما كنتيش متأكد دوزو.
خلّي مجلد النسخ الاحتياطية
ما تحيدش اللقطات الموجودة فـ backups قبل ما تتأكّد باللي التليفون خدام مزيان. الحزم المعلّقة وقنوات الإشعارات يمكن ترجعها بالأوامر؛ أما إعدادات التطبيقات فخاصّك تعاود تفتحها يدوياً باتباع المسارات الموجودة فاللائحة. للتفاصيل، شوف وثيقة الاسترجاع.
كتب سكريبت لتليفون مازال ما مدعومش
إلا كان الجهاز ما كاينش فلائحة الأجهزة المدعومة، تقدر ترجع لـ دليل كتابة سكريبت لطراز جديد باش تسجّل مسارات الإعدادات، ومن بعد تبعث Pull Request للمشروع. أداة الاستكشاف التجريبية كاينة فـ tool/explore.py، وسكريبتات الطرازات كاينة فـ recipes/<العلامة>-<الطراز>/recipe.py.
حمي الخصوصية ملي كتبعث الملاحظات
خيار «الإبلاغ عن مشكل» اللي كاين فالزاوية السفلى اليسرى ديال تطبيق سطح المكتب كيرفق تلقائياً نسخة التطبيق، وطراز التليفون، ونسخة النظام، وآخر السجلات. الرقم التسلسلي كيتبدّل، وما كيترفقوش لائحة التطبيقات ولا محتوى الإشعارات. ومع ذلك، من الأحسن تراجع المعلومات بنفسك قبل الإرسال، ومن بعد تختار القالب المناسب عبر GitHub Issues.

الخلاصة
الهدف الأساسي ديال Android Ad Cleaner ماشي الحذف القاسح لمكوّنات النظام، ولكن إغلاق مداخل الإعلانات والتوصيات والتسويق بطريقة منظّمة، بلا Root وبلا تفليش النظام. المستخدم العادي يقدر يبدا من تطبيق سطح المكتب؛ وملي كتحتاج تحكّم دقيق، تقدر تستعمل مسارات الفحص والنسخ الاحتياطي وسكريبتات الطرازات وقنوات الإشعارات عبر سطر الأوامر. كيفما كانت الطريقة اللي اخترتي، خاصّك دير النسخ الاحتياطي أولاً، وتأكد من كل خطوة بوحدها، ومن بعد تسدّ وضع المطوّر، وتعتمد على النتيجة الفعلية فالتليفون ديالك.
