إضافة تنزيل YouTube المجانية والمحلية في FoneClaw المجاني على Android

ما الذي تستطيع إضافة تنزيل YouTube فعله وما حدودها الحالية؟

الإجابة المباشرة بتاريخ 2 أغسطس 2026: FoneClaw مجاني، وإضافة تنزيل YouTube فيه plugin محلي مجاني بالكامل، وليست واحدة من أدوات FoneClaw المدمجة. لا ترفع الإضافة رابط YouTube إلى خدمات FoneClaw. التنفيذ يتم عبر plugin محلي على Android ضمن المسار المدعوم، مع اتصال الشبكة المطلوب للوصول إلى YouTube نفسه؛ وهذا لا يعني أن الإنترنت أو بيانات الهاتف مجانية من مزود الخدمة.

يمكن بدء المسار بطريقتين متساويتين في الاستخدام: مشاركة رابط فيديو YouTube مدعوم من تطبيق YouTube إلى FoneClaw، أو كتابة رابط الفيديو أو لصقه مباشرة داخل FoneClaw. في الحالتين، يتعرف FoneClaw على URL، يستخدم plugin لفحص metadata العامة والصيغ المتاحة، ثم يطلب من المستخدم اختيار الخيار المطلوب والموافقة على الإجراء المؤثر قبل بدء التنزيل. كلمة "تلقائي" هنا تعني أن FoneClaw يحمل عبء الخطوات بعد الاختيار والموافقة؛ لا تعني تجاوز الاختيار أو الموافقة.

توضح مستودع FoneClaw Android الرسمي أن سطح plugin يتكون من أدوات للفحص والتنزيل والحالة والإلغاء. لذلك لا نعرضه كأداة سحرية لكل مقاطع YouTube، ولا كطريقة لتجاوز القيود أو تنزيل محتوى غير مصرح به. إن كنت تريد التحكم في تشغيل YouTube بالصوت لا التنزيل، فالدليل الأنسب هو التحكم الصوتي في YouTube على Android: البحث والتشغيل دون لمس لأنه يفصل نية التشغيل والمشاهدة عن نية إنشاء ملف.

الحد الحالي الذي يجب تذكره: المسار المتحقق يشمل حزمة موقعة، اختيار صيغة متاحة، موافقة صريحة، jobId، تنفيذ في foreground service، منع وظائف مكررة، وتسليم 360p عبر Android MediaStore. لا نحول هذا إلى وعد بكل الصيغ أو كل الأجهزة أو كل حالات الشبكة. هذه الصفحة تشرح كيف تستخدم المسار المتحقق بعقلانية، وما الذي يجب مراجعته قبل توسيع الاعتماد عليه.

ثبّت الإضافة الموقعة عبر مسار الحزمة الموثوقة

قبل تنزيل أي فيديو، تبدأ الثقة من الحزمة نفسها. إضافة تنزيل YouTube لأندرويد لا ينبغي أن تُعامل كملف عشوائي أو APK من مصدر غير معروف. المسار المتحقق يستخدم حزمة مقدمة عبر GitHub وموقعة، مع تدفق trusted fingerprint يتيح للمستخدم رؤية مقترح التثبيت والتحقق من هوية الحزمة قبل تسجيلها داخل FoneClaw.

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

في FoneClaw نريد أن يكون قرار التثبيت مفهوما لا تلقائيا. يجب أن يعرف المستخدم أن هذا plugin خارجي عن built-in tools، وأن قدراته محددة بالفيديو والحالة والإلغاء، وأن استدعاء التنزيل نفسه سيخضع لموافقة لاحقة. الثقة في الحزمة لا تعني الموافقة على كل تنزيل؛ إنها فقط تفتح الباب لتسجيل أدوات plugin ضمن سياسة FoneClaw. وبما أن plugin محلي ومجاني بالكامل، يمكن للمستخدم تشغيل أدواته المحلية ضمن المسار المدعوم من دون تحويله إلى أداة built-in.

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

لا نوصي بتثبيت ملفات غير موثقة، ولا نعامل كل asset على GitHub كحزمة موثوقة تلقائيا. المسار الصحيح هو المسار الذي يظهر مقترحا واضحا، حزمة موقعة، fingerprint موثوقا، ثم تسجيلا مرئيا داخل FoneClaw. عند هذه النقطة فقط يصبح من المنطقي الانتقال إلى فحص الفيديو واختيار الصيغة.

افحص بيانات الفيديو واختر صيغة متاحة بدقة

الخطوة الأولى بعد جاهزية plugin ليست التنزيل. ابدأ بأداة معلومات الفيديو: plugin_youtube_video_info. هذه الأداة مصنفة LOW risk وAUTO approval لأنها تقرأ بيانات عامة وخيارات صيغ متاحة ولا تنشئ ملفا على الجهاز. يمكن أن تصل إلى هذه الخطوة بعد مشاركة رابط YouTube إلى FoneClaw أو بعد لصق الرابط مباشرة. في الحالتين، يتعرف FoneClaw على URL ويستخدم plugin محليا لفحص البيانات العامة من دون رفع الرابط إلى خدمات FoneClaw.

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

استخدم هذه القائمة الصغيرة قبل التنزيل:

• تأكد من أن الرابط هو الرابط المقصود وأن العنوان أو البيانات العامة تطابق ما تريد.
• اختر هل تريد فيديو أم صوتا عندما تكون الخيارات متاحة فعليا.
• راجع الجودة أو format المحدد بدلا من طلب "الأفضل" بصياغة غامضة.
• تأكد من أن لديك مساحة وتريد حفظ ملف على هذا الجهاز.
• قرر هل تريد المتابعة الآن أم الاكتفاء بالمعلومات.

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

ابدأ التنزيل المختار بموافقة صريحة على الأثر الخارجي

بعد اختيار الصيغة، ينتقل المسار إلى plugin_youtube_download. هذه الأداة مصنفة EXTERNAL_EFFECT وREQUIRE_APPROVAL لأنها تنشئ عملا فعليا: شبكة، تنزيل، ملف محتمل على الجهاز، وخدمة أمامية أثناء التنفيذ. هنا لا تكفي معرفة أن plugin موثوق أو أن الرابط صحيح؛ يجب أن يوافق المستخدم على بدء التنزيل المحدد.

الموافقة يجب أن تعرض ما يكفي لاتخاذ قرار: الفيديو المقصود، الصيغة المختارة، أن العملية ستبدأ كتنزيل على Android، وأن النجاح سيعيد jobId يمكن تتبعه. لا ينبغي تجاوز هذه الموافقة، ولا ينبغي تغيير الصيغة بصمت. إذا اختار المستخدم صيغة محددة، فالمسار المتحقق يستخدم exact selected format بدون silent downgrade. إذا تعذرت الصيغة، يجب أن يظهر السبب بدلا من حفظ ملف مختلف عن المتوقع.

تدفق العمل الكامل يظهر مرة واحدة بهذا الشكل:

1. ثبّت plugin عبر الحزمة الموقعة وtrusted fingerprint.
2. شارك رابط YouTube إلى FoneClaw أو اكتب الرابط أو الصقه مباشرة داخل FoneClaw.
3. دع FoneClaw يتعرف على الرابط ويفتح معلومات الفيديو باستخدام plugin_youtube_video_info.
4. اختر صيغة متاحة من البيانات الفعلية.
5. راجع طلب plugin_youtube_download ووافق على الأثر الخارجي.
6. استلم jobId بعد بدء المهمة الناجح.
7. تابع الحالة أو ألغ المهمة عند الحاجة.
8. تحقق من تسليم الملف في المسار المدعوم حاليا.

عند بدء المهمة بنجاح، يعمل التنزيل عبر foreground service حتى يبقى التنفيذ ظاهرا ضمن Android، وتعود المهمة بمعرف jobId. هذا المعرف هو نقطة المتابعة، وليس مجرد رقم داخلي. من خلاله يميز FoneClaw بين مهمة قيد الانتظار، مهمة تعمل، مهمة اكتملت، أو مهمة فشلت.

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

عندما نقول إن FoneClaw يستطيع تنفيذ التنزيل تلقائيا، فالمقصود أنه يدير خطوات workflow بعد الاختيار والموافقة المطلوبين: يبدأ job، يتابع الحالة، ويعيد نتيجة قابلة للفهم. لا يعني ذلك تنزيل الملفات بمجرد رؤية رابط، ولا يعني تجاهل سياسة الأداة أو موافقة المستخدم.

تابع jobId وألغ التنزيل وشخّص الفشل

بعد بدء التنزيل، يصبح jobId محور التحكم. أداة plugin_youtube_download_status مصنفة LOW risk وAUTO approval لأنها تقرأ حالة مهمة موجودة ولا تنشئ أثرا جديدا. من خلالها يمكن معرفة هل المهمة queued أو running أو completed أو failed أو canceled بحسب الحالة التي يعيدها plugin. هذه القراءة مهمة لأنها تمنع الاعتماد على الظن: المستخدم يرى حالة العمل بدلا من سؤال عام "هل انتهى؟".

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

عند إلغاء تنزيل YouTube، يجب أن يتوقع المستخدم حدا واقعيا: لا يوجد وعد بأن كل أثر جزئي سيختفي في كل جهاز أو كل حالة. الإلغاء يطلب إيقاف job، لكن إزالة الملفات الجزئية أو تنظيف التخزين أو استرداد الحالة يحتاج تحققا أوسع عبر الأجهزة وسلوك التخزين. لذلك من الأفضل التحقق من الحالة بعد الإلغاء، ثم مراجعة مكان التسليم أو أي أثر متبق إذا أبلغت الحالة عن فشل أو توقف جزئي.

للتشخيص، ابدأ من الأسئلة العملية: هل jobId صحيح؟ هل كانت المهمة قد اكتملت قبل الإلغاء؟ هل فشل الرابط أو الصيغة؟ هل انقطعت الشبكة؟ هل توجد مساحة كافية؟ هل foreground service ما زالت ظاهرة؟ هذه الأسئلة تساعد على تحديد هل المشكلة في الرابط، الاختيار، الشبكة، التخزين، أو حالة plugin.

في FoneClaw 0.1.0 تحسنت معالجة الفشل واسترداد الأذونات في مسارات المهام، وهذا يهم هنا لأن تنزيل الفيديو ليس ردا نصيا؛ إنه عملية طويلة لها حالة. إذا فشل المسار، يجب أن يحصل المستخدم على سبب قابل للفهم وخطوة تالية: اختيار صيغة أخرى من البيانات المتاحة، إعادة المحاولة لاحقا، إلغاء job، أو التوقف إذا لم يكن المحتوى مناسبا للتنزيل.

مكان تسليم الملف وما الذي ما زال يحتاج تحققا

السؤال "أين يُحفظ الملف؟" يحتاج إجابة دقيقة لا تعميمية. المسار المتحقق حاليا يتضمن تسليم 360p عبر Android MediaStore. هذا يعني أن نتيجة الاختبار الحالية تؤكد مسارا محددا: صيغة 360p، وتسليم عبر طبقة MediaStore في Android. لا نحوّل هذا إلى وعد بأن كل جودة، أو كل خيار صوت، أو كل سلوك تخزين، أو كل جهاز سيعمل بالطريقة نفسها.

MediaStore مهم لأنه طريقة Android لإظهار وسائط محفوظة للتطبيقات والنظام وفق قواعد التخزين الحديثة. لكن التفاصيل التي يراها المستخدم قد تختلف بحسب الجهاز وتطبيق الملفات وتطبيق المعرض وإعدادات Android. لذلك لا نخترع اسم مجلد ثابت أو واجهة عرض موحدة. نقول ما هو متحقق: تسليم 360p عبر MediaStore، ثم نترك مساحة لاختبار أوسع للصيغ والسلوك عبر الأجهزة.

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

إذا كنت تريد فهم الفرق بين أدوات محلية مدمجة ومسارات plugin خارجية على Android، فدليل الأدوات المحلية لوكيل الهاتف يظل مفيدا، لكن ضمن روابط هذه الصفحة نركز على تنزيل YouTube نفسه وعلى سياسة plugin. القاعدة هنا: تحقق من النتيجة بعد الاكتمال، ولا تعتمد على اسم الصيغة أو نجاح البداية فقط. البداية الناجحة تعني أن job انطلق؛ اكتمال الملف وتسليمه هو حالة أخرى يجب مراجعتها.

استخدم الإضافة بشكل مسموح وبسيطرة واضحة

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

استخدم القائمة التالية قبل كل تنزيل فعلي:

• راجع حقك في تنزيل هذا المحتوى بدلا من الاكتفاء بأن الرابط يعمل.
• ابدأ بمعلومات الفيديو قبل إنشاء ملف.
• اختر صيغة موجودة فعليا ولا تعتمد على اختيار غامض.
• راجع طلب الموافقة لأن plugin_youtube_download يحدث أثرا خارجيا.
• احتفظ بـ jobId حتى تستطيع المتابعة أو الإلغاء.
• تحقق من اكتمال الملف عبر MediaStore في المسار المدعوم حاليا.
• أوقف المهمة إذا تغيرت نيتك أو ظهرت صيغة غير مقصودة.

FoneClaw مجاني، ويمكن للمستخدم أن يبدأ بالنموذج الافتراضي المجاني أو يكوّن نموذجا متوافقا لقيادة فهم الطلب والتخطيط. لكن تنفيذ تنزيل YouTube نفسه يتم عبر plugin محلي مجاني بالكامل لا يرفع رابط YouTube إلى خدمات FoneClaw. النموذج يساعد في صياغة النية، plugin ينفذ وظيفة محددة، وFoneClaw يطبق الموافقة وحدود الأداة. هذا الفصل يمنع الخلط بين طلب عام مثل "نزّل هذا" وبين قرار محدد: أي فيديو، أي صيغة، أي أثر، وأي نتيجة.

إذا كان هدفك تشغيل YouTube أو البحث داخله بالصوت بدلا من إنشاء ملف، فدليل التحكم الصوتي في YouTube على Android: البحث والتشغيل دون لمس هو المسار الأنسب. أما هذا الدليل فمخصص لمسار plugin في FoneClaw: الثقة، الفحص، الاختيار، الموافقة، jobId، الإلغاء، وحدود التحقق الحالية.