تثبيت نموذج التعرف على الكلام المحلي

المتطلبات المسبقة

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

ويمكنك تجاوز هذه الصفحة كليا إذا كان لديك RoughCut Pro وتنوي استخدام التفريغ النصي السحابي في كل مشروع — فذلك المسار يستخدم OpenAI بدل نموذج محلي.

الخطوات

1. افتح Settings واختر تبويب Models & Data.
2. في قسم نموذج التعرف على الكلام سترى إما النموذج جاهز (ggml-large-v3-turbo.bin) وإما التنبيه يلزم نموذج التعرف على الكلام، وحجمه نحو 1.6 GB، لإجراء التفريغ النصي.
3. اضغط تنزيل من Hugging Face.
4. راقب التقدم. يعرض RoughCut جار تنزيل النموذج... <n>%، ثم جار تنزيل النموذج... <n>% (<المنزَّل> من <الإجمالي>) بمجرد وصول أعداد البايتات. وتظهر الحالة الحية نفسها في شاشتي مونتاج أولي جديد وتفريغ نصي فقط، فلا حاجة إلى انتظار التنزيل داخل الإعدادات.
5. عند الانتهاء، يتحول القسم إلى النموذج جاهز ويصبح زر بدء المعالجة متاحا.

التثبيت اليدوي حين لا يكتمل التنزيل

يكشف RoughCut عن الملف نفسه بدل إخفائه، فيمكنك دائما الرجوع إلى المتصفح.

1. في Settings → Models & Data، اضغط نسخ رابط التنزيل. ينسخ RoughCut العنوان إلى الحافظة ويؤكد ذلك برسالة تم نسخ رابط تنزيل النموذج.
2. ألصق العنوان في المتصفح ونزّل الملف. والعنوان هو: ``text https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin ``
3. عد إلى Settings → Models & Data واضغط استيراد ملف نموذج....
4. حدد ملف .bin الذي نزّلته. ينسخه RoughCut إلى مجلد النماذج الخاص به، مستبدلا أي ملف موجود بالاسم نفسه.

النتيجة المتوقعة

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

أين يوجد النموذج وكيف يعمل

يُخزَّن الملف داخل حاوية Application Support الخاصة بـ RoughCut، في مجلد models. ولأن هذا الموقع داخل صندوق حماية التطبيق، فإن حذف RoughCut يحذف النموذج معه، وستنزّله من جديد عند أي تثبيت جديد.

ويعمل التفريغ النصي بتسريع Metal على وحدة معالجة الرسوميات افتراضيا. ويقدم إعداد جهاز تشغيل Whisper الخيارات auto وcpu وmetal؛ والخيار metal هو الصحيح على Apple Silicon، بينما وُجد cpu لأغراض التشخيص وهو أبطأ بكثير.

ويستطيع المستخدمون المتقدمون توجيه RoughCut إلى نموذج مخزَّن في مكان آخر عبر إعداد مسار نموذج Whisper، وهو يتجاوز الموقع الافتراضي. اتركه فارغا ما لم يكن لديك سبب محدد.

أخطاء شائعة

• تنزيل نموذج Whisper مختلف. يتوقع RoughCut الملف ggml-large-v3-turbo.bin تحديدا، وهو الخيار الافتراضي المختبَر لأجل الطوابع الزمنية على مستوى الكلمة التي تعتمد عليها خطة القص وتصدير SRT معا.
• استيراد تنزيل ناقص. لا يعتبر RoughCut النموذج جاهزا إلا إذا تجاوز حجم الملف نحو 100 MB تقريبا، وهو ما يكشف التنزيلات المبتورة — لكن ملفا مكتوبا جزئيا ويتجاوز هذا الحد قد يفشل رغم ذلك عند التفريغ. فإذا تصرف التفريغ النصي بشكل غريب بعد استيراد يدوي، نزّل الملف من جديد.
• توقع بقاء النموذج بعد حذف التطبيق. لا يبقى.
• انتظار النموذج وأنت لا تحتاجه. التفريغ النصي السحابي (Pro) لا يحتاج نموذجا محليا على الإطلاق.

حل المشكلات

وإذا كان الفشل في المشروع نفسه لا في التنزيل، فابدأ من حل المشكلات حسب العَرَض.