# مرجع الإعدادات المتقدمة

> كل مفتاح في مخطط إعدادات RoughCut مع نوعه وقيمته الافتراضية ومداه وأثره الفعلي ومخاطر تغييره عن القيمة المشحونة.
>
> جرى التحقق من المحتوى مقابل تطبيق RoughCut الحالي بتاريخ 28 أغسطس 2026
> https://www.roughcuteditor.com/ar/docs/advanced-settings-reference

هذا هو المرجع الكامل لكل مفتاح في مخطط إعدادات RoughCut، مرتّبا بالمجموعات نفسها التي يستخدمها تبويب Full في الإعدادات: LLM وPipeline v2 وTranscription وEvals وSystem. ويعطي لكل مفتاح تسميته في الواجهة، واسمه الداخلي، ونوعه، وقيمته الافتراضية المشحونة، وأي حدود مفروضة عليه، وما الذي يفعله تغييره فعلا. وتُحسم الإعدادات بترتيب واحد لا غير: القيم الافتراضية في المخطط، ثم ملف الإعدادات لديك، ثم التجاوزات الخاصة بكل مشروع. والحفظ لا يكتب إلا القيم التي تختلف عن القيمة الافتراضية، والأسرار لا تدخل ذلك الملف إطلاقا. ومعظم المستخدمين لا ينبغي أن يغيّروا شيئا مما هنا: مقالات سير العمل العادية تغطي عناصر التحكم التي تهم يوما بيوم.

## اقرأ هذا أولا

**هذه الصفحة متقدمة.** لا شيء فيها لازم للاستخدام العادي. فالقيم الافتراضية هي التوليفة المختبَرة، وعناصر التحكم العادية في شاشة إنشاء مونتاج أولي — وهي مشروحة في [أنشئ أول مونتاج أولي](/ar/docs/first-rough-cut) — هي ما ينبغي لمعظم المستخدمين تغييره.

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

> تغيير المزود أو النموذج أو مصدر التفريغ النصي يُبطل قابلية المقارنة مع عمليات [التقييم](/ar/docs/evaluation-overview) السابقة. فالاستجابات المخزَّنة مؤقتا للتقييم مرتبطة بتلك الاختيارات، ولذلك فإن النتائج قبل التغيير وبعده ليست مقارنة نظيفة.

## كيف تُحسم الإعدادات

هناك ترتيب واحد لا غير:

```text
schema default  <  configuration file  <  per-job override
```

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

وشارة `modified` بجانب أي حقل تعني أن قيمته تختلف عن القيمة الافتراضية المشحونة. وهي لا تعني أنها غير محفوظة. والحقول السرية لا تعرضها أبدا.

## LLM

المزود الذي يشغّل مرحلة التحرير، وكيفية استدعائه.

| التسمية | المفتاح | النوع | الافتراضي | المدى أو الخيارات | الأثر ومتى تغيّره |
|---|---|---|---|---|---|
| `LLM provider` | `llm_provider` | select | `gemini` | `gemini`, `openai` | المزود الذي يشغّل مرحلة التحرير والتقييمات. ويوصى بـ Gemini: سياقه الطويل يستوعب عادة فيديو كاملا في مرحلة واحدة. |
| `Gemini API key` | `gemini_api_key` | secret | empty | — | مفتاحك أنت، ويُخزَّن في `Keychain`. ويتطلب تفعيل الفوترة على مشروع Google الخاص به. |
| `Gemini model` | `gemini_model` | string | `gemini-3.1-pro-preview` | — | النموذج المستخدَم في التحرير. لا تغيّره إلا إن تعذّر على مشروعك الوصول إلى النموذج الافتراضي، وتوقّع سلوك تحرير مختلفا. |
| `Gemini timeout (sec)` | `gemini_timeout_sec` | int | `600` | — | ارفعه مع النصوص المفرغة الطويلة جدا على الاتصالات البطيئة. |
| `OpenAI API key` | `openai_api_key` | secret | empty | — | مفتاحك أنت، ويُخزَّن في `Keychain`. وهو مطلوب أيضا للتفريغ النصي السحابي. |
| `OpenAI model` | `openai_model` | string | `gpt-5.2` | — | النموذج المستخدَم في التحرير حين يكون المزود هو OpenAI. |
| `OpenAI timeout (sec)` | `openai_timeout_sec` | int | `600` | — | يُستخدم أيضا مهلةً للتفريغ النصي السحابي. |

## Pipeline v2

كيف تُتَّخذ قرارات القص وتُشكَّل. **هذه هي الإعدادات الأقدر على إفساد المونتاج.**

| التسمية | المفتاح | النوع | الافتراضي | المدى | الأثر ومتى تغيّره |
|---|---|---|---|---|---|
| `Min silence to cut (sec)` | `silence_min_cut_s` | float | `0.7` | min `0.1` | الحد الأدنى، على مستوى الإعدادات، لقصّ فترة صمت. وهو غير الحد الأدنى للصمت (ثانية) الخاص بكل مشروع، وقيمته الافتراضية 0.5. ورفعه يترك مساحة أوسع للتنفّس. |
| `Cut pad into removed (sec)` | `pad_into_removed_s` | float | `0.05` | `0.0`–`0.5` | إلى أي مدى يمتد المقطع المُبقى داخل المادة المستبعَدة. رفعه ينعّم القصّات، والمبالغة فيه تعيد الضوضاء التي استبعدتها. |
| `Min keep island (sec)` | `min_keep_island_s` | float | `0.25` | min `0.0` | الأجزاء المُبقاة الأقصر من هذه القيمة تُدمج في القصّ المحيط بها. ورفعه يستبعد مزيدا من المقاطع الشاردة. |
| `LLM editor max output tokens` | `llm_editor_max_output_tokens` | int | `65536` | min `1024` | يُضبط دائما لمنع الاقتطاع الصامت. وخفضه يعرّضك لقائمة تحرير مقتطعة. |
| `LLM editor chunk size (words)` | `llm_editor_chunk_words` | int | `24000` | min `2000` | مقدار النص المفرغ الذي يُرسل إلى النموذج دفعة واحدة. وهو أيضا السقف الذي لا تستطيع المراجعة الثانية العمل فوقه. |
| `LLM editor chunk overlap (words)` | `llm_editor_overlap_words` | int | `600` | min `0` | التداخل بين الأجزاء حتى لا تفوت القصّات القريبة من الحدود. |
| `LLM editor exemplars` | `llm_editor_exemplars` | int | `8` | min `0` | عدد أمثلة الاستبعاد التي تُحقن في الموجّه. والقيمة `0` تعطّل الأمثلة. ويلزم استيراد بنك أمثلة — راجع [بنك الأمثلة](/ar/docs/exemplars). |
| `Exemplar bank path` | `exemplar_bank_path` | path | empty | — | يتجاوز الموقع الافتراضي للبنك. والفراغ يعني الموقع القياسي داخل حاوية التطبيق. |
| `Second Look passes` | `second_look_passes` | int | `0` | `0`–`3` | القيمة `0` تعني الإيقاف. ومفتاح التبديل في المشروع يضبطها على 1 عند تفعيله. راجع [المراجعة الثانية](/ar/docs/second-look). |
| `Second Look min confidence` | `second_look_min_confidence` | float | `0.95` | `0.0`–`1.0` | اقتراحات مرحلة التنقيح التي تقل عن هذه القيمة لا تُقصّ تلقائيا أبدا، بل تصبح اقتراحات للمراجعة. وخفضها يجعل الاستبعاد التلقائي أشد حدّة بكثير. |
| `Second Look max removal %` | `second_look_max_removal_pct` | float | `10.0` | `0.0`–`100.0` | ميزانية كل مرحلة كنسبة من الكلمات التي بقيت حتى تلك اللحظة. |
| `Second Look max spans` | `second_look_max_spans` | int | `10` | min `0` | حد أقصى صارم لعدد القصّات المطبَّقة تلقائيا في كل مرحلة. |
| `Second Look auto categories` | `second_look_auto_categories` | string | `retake_verbatim,retake_reworded,false_start,noise` | — | الفئات التي يجوز تطبيقها تلقائيا. وفئة `tangent` مستبعَدة عمدا لأنها الخطر المعروف للإفراط في القص. |

## Transcription

| التسمية | المفتاح | النوع | الافتراضي | الخيارات | الأثر ومتى تغيّره |
|---|---|---|---|---|---|
| `Whisper model name` | `whisper_cpp_model_name` | string | `ggml-large-v3-turbo.bin` | — | القيمة الافتراضية المختبَرة للحصول على توقيتات الكلمات في الإنجليزية والعربية. |
| `Whisper model path` | `whisper_cpp_model_path` | path | empty | — | يتجاوز الموضع الذي يُحمَّل منه النموذج. والفراغ يعني الموقع القياسي. |
| `Whisper device` | `whisper_device` | select | `metal` | `auto`, `cpu`, `metal` | القيمة `metal` هي الصحيحة على Apple Silicon. أما `cpu` فللتشخيص وهي أبطأ بكثير. |
| `Silence-gated transcription` | `asr_silence_gated` | bool | `true` | — | يفرّغ مناطق الكلام بدل الملف كاملا. اتركه مفعّلا. |
| `Hallucination loop recovery` | `asr_loop_recovery` | bool | `true` | — | يعيد تفريغ المناطق التي دخل فيها النموذج في تكرار. اتركه مفعّلا. ويعمل على الجهاز فقط. |
| `OpenAI transcription model` | `openai_transcribe_model` | string | `whisper-1` | — | يتطلب التفريغ النصي السحابي توقيتات على مستوى الكلمة، ولا يعيدها اليوم سوى `whisper-1`، أما النماذج الأخرى فتفشل بوضوح. |
| `Cloud transcription by default` | `cloud_transcription_default` | bool | `false` | — | يجعل الخيار السحابي محددا مسبقا في المشاريع الجديدة. ويتطلب Pro ومفتاح OpenAI الخاص بك، ومع ذلك يظل كل مشروع يعرض الاختيار. |

## Evals

اختيارية. راجع [قيّم RoughCut مقابل مونتاجك أنت](/ar/docs/evaluation-overview).

| التسمية | المفتاح | النوع | الافتراضي | المدى | الأثر |
|---|---|---|---|---|---|
| `Eval dataset root` | `eval_dataset_root` | path | empty | — | مجلد المجموعة المرجعية لديك. امنح الإذن من تبويب `Models & Data` بدل كتابة مسار. |
| `Full eval max clips` | `eval_full_max_clips` | int | `15` | min `0` | حد أقصى لعدد المقاطع في التشغيل الكامل. والقيمة `0` تشغّل كل المقاطع. |
| `Langfuse public key` | `langfuse_public_key` | secret | empty | — | يُخزَّن في `Keychain`. ولا يلزم إلا للتتبّع. |
| `Langfuse secret key` | `langfuse_secret_key` | secret | empty | — | يُخزَّن في `Keychain`. ولا يلزم إلا للتتبّع. |
| `Langfuse base URL` | `langfuse_base_url` | string | `https://cloud.langfuse.com` | — | غيّره لمنطقة مختلفة أو لنسخة تستضيفها بنفسك. |
| `Langfuse tracing` | `langfuse_tracing` | bool | `false` | — | إيقافه يعني عملا محليا بالكامل: لا تغادر الجهازَ أي بيانات تتبّع. |
| `Langfuse sample rate` | `langfuse_sample_rate` | float | `1.0` | `0.0`–`1.0` | موجود في المخطط. راجع الملاحظة أدناه. |
| `Langfuse environment` | `langfuse_environment` | string | `revamp-v2` | — | وسم البيئة الذي يُطبَّق على عمليات التتبّع. |

## System

| التسمية | المفتاح | النوع | الافتراضي | الأثر |
|---|---|---|---|---|
| `Job TTL hours` | `job_ttl_hours` | int | `24` | المشاريع المنتهية الأقدم من هذه المدة تُنظَّف تلقائيا. |
| `Max video GB` | `max_video_gb` | int | `12` | موجود في المخطط. راجع الملاحظة أدناه. |
| `Max audio GB` | `max_audio_gb` | int | `10` | موجود في المخطط. راجع الملاحظة أدناه. |
| `Max total GB` | `max_total_gb` | int | `25` | يُقلَّم مجلد المشاريع بدءا من الأقدم ليبقى تحت هذه القيمة. |
| `Keep analysis audio` | `keep_analysis_audio` | bool | `false` | إيقافه يحذف صوت التحليل المستخرَج (نحو 115 MB لكل ساعة) عند انتهاء المونتاج. ولا يحتاج إليه ملف FCPXML ولا المراجعة. |
| `Log level` | `log_level` | select | `INFO` | موجود في المخطط. راجع الملاحظة أدناه. |

> ! أربعة مفاتيح — `Max video GB` و`Max audio GB` و`Langfuse sample rate` و`Log level` — تظهر حقولا قابلة للتحرير لكن لا يقرؤها أي جزء من النسخة الحالية. وضبطها لا أثر له. وعلى وجه الخصوص، لا تعتمد على قيمتي GB بوصفهما حدين مفروضين لحجم الملفات.

## إبقاء هذه الصفحة صادقة

هذا الجدول مولَّد من مخطط إعدادات التطبيق عند الإصدار المذكور في بيانات الصفحة، و[فحص الانحراف](/ar/docs/changelog) يعامل أي تغيير في ذلك المخطط بوصفه تغييرا يؤثر في التوثيق. فإن أضاف التطبيق مفتاحا أو أعاد تسمية مفتاح، أُعيد توليد هذه الصفحة قبل نشر التغيير.