إضافة وكيل ذكاء اصطناعي لإدارة ملفات Android: التثبيت والأذونات والمعاينة

ما المهام التي ينظمها وكيل إدارة الملفات؟

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

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

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

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

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

لماذا تأتي إدارة الملفات في إضافة منفصلة؟

File Manager Plugin ليست أداة مدمجة ضمن FoneClaw، بل حزمة Android مستقلة لها ملف APK ومعرّف حزمة وموقّع وصلاحيات وأدوات خاصة بها. يسجل الفهرس الرسمي لإضافات FoneClaw الإصدار الحالي 0.0.4 بالرمز 4، ومعرّف الحزمة ai.android.claw.plugin.device.filemanager، وحدا أدنى للمضيف وفق معلومات توافق FoneClaw الحالية المتاحة.

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

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

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

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

الوصول إلى جميع الملفات ونطاق المسارات

تطلب الإضافة صلاحية MANAGE_EXTERNAL_STORAGE، المعروفة في واجهة Android بالوصول إلى جميع الملفات، إضافة إلى صلاحية الإنترنت INTERNET. تحتاج عمليات البحث والتنظيم إلى الأولى للتعامل مع نطاق واسع من التخزين الخارجي، بينما تستخدم الثانية في تنزيل الملفات من مصادر HTTPS. يعرض Android منح الوصول إلى جميع الملفات عبر إعداد خاص يمكن للمستخدم مراجعته أو سحبه لاحقا.

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

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

لا تجعل صلاحية الوصول كل محتوى قابلا للقراءة في جميع الظروف. قد تبقى مناطق خاصة بالتطبيقات أو شاشات محمية أو ملفات مشفرة خارج المسار العملي، وقد تمنع حالة النظام عملية معينة. كما تقيد أداة قراءة النص كمية البيانات من خلال maxBytes، ما يسمح بطلب جزء مناسب من ملف نصي من دون جلب محتواه الكامل.

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

معاينة إعادة التسمية قبل تطبيقها

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

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

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

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

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

الحذف الدائم والتنزيل الآمن ومعالجة التعارض

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

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

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

إذا وجد ملف بالاسم نفسه، لا تفترض أن المحتوى سيُستبدل. اعرض التعارض واترك للمستخدم اختيار اسم جديد أو مجلد آخر وفقا لنتيجة الأداة. ينطبق المبدأ نفسه على إنشاء ملف جديد، إذ ينص العقد على إنشائه من دون الكتابة فوق ملف موجود. يؤدي ظهور التعارض إلى تعديل المهمة، لا إلى توسيعها تلقائيا.

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

تثبيت الإضافة وتشغيل أول مهمة آمنة

يبدأ التثبيت بالبحث في البيانات الرسمية للإضافات. تستخدم أداة plugin_search الفهرس الرسمي للعثور على File Manager Plugin وعرض بياناتها، ولا تقوم بالتثبيت. بعد اختيار الحزمة، تنشئ plugin_request_install مقترحا مرئيا يتضمن ما سيضاف، ثم تعرض واجهة Home الطلب للمستخدم لاتخاذ القرار.

راجع في المقترح الإصدار 0.0.4 ومعرّف الحزمة والحد الأدنى للمضيف والمصدر والأذونات والموقّع المتوقع. قارن البصمة أو بيانات الحزمة المعروضة بالبيانات الرسمية عندما تكون متاحة. بعد الموافقة، يتحقق FoneClaw من بيانات APK والموقّع المتوقع قبل تسجيل أدوات الإضافة المثبتة.

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

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

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

قائمة فحص الثقة والموافقة والنتيجة والاسترداد

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

• مصدر الحزمة: هل جاءت بيانات الإضافة من الفهرس الرسمي وظهر الإصدار ومعرّف الحزمة؟
• الموقّع: هل تحقق المضيف من بيانات APK والموقّع المتوقع قبل تسجيل الأدوات؟
• نطاق المسار: هل يعرض الطلب المسار النسبي أو الكامل المقصود من دون غموض؟
• تقليل القراءة: هل تستخدم قراءة النص حدا مناسبا عبر maxBytes؟
• المعاينة: هل تُعرض تغييرات إعادة التسمية وتعارضاتها قبل إصدار previewToken؟
• الموافقة: هل يرتبط التطبيق أو الحذف بالقائمة التي راجعها المستخدم؟
• التعارض: هل يتوقف الإنشاء أو التنزيل عند وجود اسم مستخدم بدلا من الكتابة فوقه بصمت؟
• التحقق: هل تسرد المهمة الملف أو المجلد بعد التغيير لتأكيد النتيجة الفعلية؟
• الاسترداد: هل تعرض حالات الفشل خطوة مثل تحديث المعاينة أو تغيير الاسم أو منح الإذن؟
• الإزالة: هل تستطيع إلغاء صلاحية الوصول إلى جميع الملفات وإزالة الإضافة عندما تنتهي حاجتك؟

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

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

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