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

> تنزيل نموذج Whisper الذي يشغّل التفريغ النصي على الجهاز واستيراده وحل مشكلاته، مرة واحدة فقط.
>
> جرى التحقق من المحتوى مقابل تطبيق RoughCut الحالي بتاريخ 28 أغسطس 2026
> https://www.roughcuteditor.com/ar/docs/speech-model

يحتاج التفريغ النصي على الجهاز إلى ملف واحد يُنزَّل مرة واحدة. يستخدم RoughCut نموذج Whisper مفتوح المصدر ggml-large-v3-turbo.bin، وحجمه نحو 1.6 GB، من مشروع whisper.cpp على Hugging Face. والمسار المعتاد هو الإعدادات ثم Models & Data ثم تنزيل من Hugging Face، مع عرض حي للنسبة المئوية وعدد البايتات. وإذا تعطل التنزيل أو فشل، استخدم نسخ رابط التنزيل لجلب الملف نفسه من المتصفح، ثم استيراد ملف نموذج لتوجيه RoughCut إليه. يُخزَّن النموذج داخل حاوية التطبيق، ويعمل بتسريع Metal، ولا يُنزَّل مرة أخرى أبدا. وأنت لا تحتاجه إلا للتفريغ النصي على الجهاز.

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

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

ويمكنك تجاوز هذه الصفحة كليا إذا كان لديك RoughCut Pro وتنوي استخدام [التفريغ النصي السحابي](/ar/docs/transcription-options) في كل مشروع — فذلك المسار يستخدم 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) لا يحتاج نموذجا محليا على الإطلاق.

## حل المشكلات

| العَرَض | السبب المرجح | ما العمل |
|---|---|---|
| يبقى التقدم عند 0% | مشكلة في الشبكة أو في الخادم المضيف | ألغِ التنزيل وأعد المحاولة؛ وإذا تكرر الأمر، استخدم مسار `نسخ رابط التنزيل` و`استيراد ملف نموذج...` أعلاه. |
| فشل التنزيل مرارا | شبكة مؤسسية أو ترشيح DNS | نزّل الملف من المتصفح ثم استورده. |
| `نموذج Whisper غير موجود في <path>. نزّله أو استورده من الإعدادات.` | الملف غير موجود أو المسار المخصص خاطئ | تحقق من أن `مسار نموذج Whisper` فارغ، ثم نزّل أو استورد من جديد. |
| مساحة القرص غير كافية | المساحة الحرة أقل من `2 GB` تقريبا | فرّغ مساحة ثم أعد المحاولة. الكتابة الفاشلة تترك ملفا غير صالح — نزّل من جديد بدل استيراد الملف الناقص. |
| التفريغ النصي لا ينتج شيئا | ملف نموذج خاطئ أو تالف | أعد تنزيل الملف بالاسم المذكور أعلاه بالضبط ثم استورده مرة أخرى. |

وإذا كان الفشل في المشروع نفسه لا في التنزيل، فابدأ من [حل المشكلات حسب العَرَض](/ar/docs/troubleshooting).