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

كل مفتاح في مخطط إعدادات RoughCut مع نوعه وقيمته الافتراضية ومداه وأثره الفعلي ومخاطر تغييره عن القيمة المشحونة.

القسم: الإعدادات والخصوصية والخطط 11 دقيقة قراءة جرى التحقق من المحتوى مقابل تطبيق RoughCut الحالي بتاريخ 7 نوفمبر 2026 English

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

في هذه الصفحة

اقرأ هذا أولا
كيف تُحسم الإعدادات
LLM
مسار المعالجة v2
التفريغ النصي
التقييمات
النظام
إبقاء هذه الصفحة صادقة

اقرأ هذا أولا

هذه الصفحة متقدمة. لا شيء فيها لازم للاستخدام العادي. فالقيم الافتراضية هي التوليفة المختبَرة، وعناصر التحكم العادية في شاشة «مونتاج أولي جديد» — وهي مشروحة في أنشئ أول مونتاج أولي — هي ما ينبغي لمعظم المستخدمين تغييره.

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

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

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

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

schema default  <  configuration file  <  per-job override

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

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

LLM

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

التسمية	المفتاح	النوع	الافتراضي	المدى أو الخيارات	الأثر ومتى تغيّره
`مزود LLM`	`llm_provider`	select	`openai`	`openai`, `gemini`, `anthropic`	المزود الذي يشغّل مرحلة التحرير والتقييمات. ونص المساعدة: `OpenAI هو الخيار الافتراضي للتثبيتات الجديدة. الخيار gemini هو Google Gemini والخيار anthropic هو Claude. يستخدم كل مزوّد مفتاح API خاصًا به ويحاسبك مباشرة. تُحفظ اختيارات المزوّد السابقة، وتُقسَّم النصوص الطويلة إلى أجزاء ثم تُدمج مع أي مزوّد.`
`مفتاح Gemini API`	`gemini_api_key`	secret	empty	—	مفتاحك أنت، ويُخزَّن في `Keychain`. ويتطلب تفعيل الفوترة على مشروع Google الخاص به.
`نموذج Gemini`	`gemini_model`	string	`gemini-3.1-pro-preview`	—	النموذج المستخدَم في التحرير عبر Gemini. يعرض الحقل المعرّف الحالي بجانب زر `اختيار نموذج وتقدير التكلفة…` الذي يسرد النماذج التي يصل إليها مفتاحك، ويقبل معرّفا مخصصا، ويقدّر التكلفة؛ و`استخدام النموذج` يملأ الحقل و`حفظ الإعدادات` يطبّقه. ولا يتيح RoughCut ضبط مستوى الاستدلال في Gemini. وتوقّع سلوك تحرير مختلفا من نموذج مختلف.
`مهلة Gemini (ثانية)`	`gemini_timeout_sec`	int	`600`	—	ارفعه مع النصوص المفرغة الطويلة جدا على الاتصالات البطيئة.
`مفتاح OpenAI API`	`openai_api_key`	secret	empty	—	مفتاحك أنت، ويُخزَّن في `Keychain`. وهو مطلوب أيضا للتفريغ النصي السحابي.
`نموذج OpenAI`	`openai_model`	string	`gpt-5.6-sol`	—	النموذج المستخدَم في التحرير حين يكون المزود هو OpenAI. ونص المساعدة: `Sol هو الخيار الافتراضي. يستخدم Sol وAstra استدلالًا متوسطًا ما لم تختر مستوى آخر، وتستخدم معرّفات النماذج الأخرى افتراضي المزوّد. اختر النموذج ومستوى الاستدلال وقدّر التكلفة من هنا. احفظ الإعدادات لتطبيقها على المهام القادمة.` ويُعرض `GPT-6 Astra (ترقية اختيارية)` في `اختيار نموذج وتقدير التكلفة…`. ويظهر الحقل بالشكل `<النموذج> · الاستدلال <المستوى>`.
`مهلة OpenAI (ثانية)`	`openai_timeout_sec`	int	`600`	—	يُستخدم أيضا مهلةً للتفريغ النصي السحابي. ومستوى الاستدلال `high` أو `xhigh` أو `max` يرفع انتظار التحرير إلى 900 أو 1800 أو 2700 ثانية على الأقل؛ وإذا ضبطت قيمة أعلى فإنها تبقى.
`مستوى الاستدلال في OpenAI`	`openai_reasoning_effort`	string	`default`	المستويات التي يدعمها النموذج	للقراءة فقط هنا؛ تختاره من `اختيار نموذج وتقدير التكلفة…` بجوار `نموذج OpenAI`. ونص المساعدة: `المدة التي يفكّر فيها نموذج OpenAI قبل أن يجيب. القيمة default تُبقي إعداد RoughCut المختبَر (متوسط في Sol وAstra). المستويات الأعلى أبطأ وأعلى تكلفة. غيّره من «اختيار نموذج وتقدير التكلفة» حيث تظهر المستويات التي يدعمها نموذجك.` وتستخدمه المرحلة الأولى والمراجعة الثانية.
`مفتاح Claude API`	`anthropic_api_key`	secret	empty	—	مفتاحك أنت من Claude Console، ويُخزَّن في `Keychain`. وتحاسبك Anthropic على استخدامه.
`نموذج Claude`	`anthropic_model`	string	`claude-opus-5-5`	—	النموذج المستخدَم في التحرير حين يكون المزود هو `anthropic`. ونص المساعدة: `نموذج Claude لمرحلة التحرير. Opus 5.5 هو الخيار المبدئي، ولم تُقيَّم نماذج Claude بعد على مجموعة تقييم RoughCut. اختر النموذج ومستوى الاستدلال وقدّر التكلفة من هنا.` ويظهر الحقل بالشكل `<النموذج> · الاستدلال <المستوى>`.
`مهلة Claude (ثانية)`	`anthropic_timeout_sec`	int	`600`	—	ونص المساعدة: `أقصى عدد من الثواني دون وصول أي بيانات من Claude قبل فشل الطلب. ردود Claude تُبث تدريجيًا، لذا فهذه مهلة صمت. القيمة 600 تكفي لمعظم الفيديوهات.` ويسري الحد الأدنى نفسه المرتبط بمستوى الاستدلال كما في OpenAI.
`مستوى الاستدلال في Claude`	`anthropic_reasoning_effort`	string	`default`	المستويات التي يدعمها النموذج	للقراءة فقط هنا؛ تختاره من `اختيار نموذج وتقدير التكلفة…` بجوار `نموذج Claude`. ونص المساعدة: `المدة التي يفكّر فيها نموذج Claude قبل أن يجيب. القيمة default لا ترسل أي مستوى، فيُطبَّق افتراضي النموذج نفسه. المستويات الأعلى أبطأ وأعلى تكلفة. غيّره من «اختيار نموذج وتقدير التكلفة» حيث تظهر المستويات التي يدعمها نموذجك.` وتستخدمه المرحلة الأولى والمراجعة الثانية.

والمشروع الذي لا يدعم نموذجه المراجَع المستوى المحفوظ يتوقف قبل أي طلب إلى المزود. راجع اختر OpenAI أو Gemini أو Claude لقوائم المستويات.

مسار المعالجة v2

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

التسمية	المفتاح	النوع	الافتراضي	المدى	الأثر ومتى تغيّره
`الحد الأدنى للصمت المراد استبعاده (ثانية)`	`silence_min_cut_s`	float	`0.7`	min `0.1`	الحد الأدنى، على مستوى الإعدادات، لقصّ فترة صمت. وهو غير الحد الأدنى للصمت (ثانية) الخاص بكل مشروع، وقيمته الافتراضية 0.5. ورفعه يترك مساحة أوسع للتنفّس.
`هامش توسيع القص داخل الجزء المستبعد (ثانية)`	`pad_into_removed_s`	float	`0.05`	`0.0`–`0.5`	إلى أي مدى يمتد المقطع المُبقى داخل المادة المستبعَدة. رفعه ينعّم القصّات، والمبالغة فيه تعيد الضوضاء التي استبعدتها.
`الحد الأدنى للمقطع القصير المبقى (ثانية)`	`min_keep_island_s`	float	`0.25`	min `0.0`	الأجزاء المُبقاة الأقصر من هذه القيمة تُدمج في القصّ المحيط بها. ورفعه يستبعد مزيدا من المقاطع الشاردة.
`المقطع غير الموثوق: الحد الأقصى للنشاط الصوتي للقص`	`unreliable_active_max`	float	`0.15`	`0.0`–`1.0`	تُقص حلقات ضوضاء التفريغ تلقائيا عندما يحتوي الصوت تحتها على هذه النسبة أو أقل من الإطارات غير الصامتة؛ أما الحلقات فوق كلام حقيقي فتُبقى دائما وتُوسم للمراجعة. القيمة `0` لا تقص إلا الحلقات فوق الصمت المكتشف. ورفعها يخاطر بقص كلام حقيقي.
`بوابة الثقة للمرور الأول`	`first_pass_gate`	string	`tangent:0.98`	—	حدود دنيا بصيغة `<الفئة>:<الحد الأدنى للثقة>` مفصولة بفواصل لمرور المحرر الأول في المشاريع الإنجليزية وغير العربية. المقاطع تحت الحد تُبقى وتُدرج كاقتراحات للمراجعة. اكتب `off` لتطبيق كل مقطع؛ والحقل الفارغ يعيد الافتراضي.
`بوابة الثقة للمرور الأول (العربية)`	`first_pass_gate_ar`	string	فارغ	—	الصيغة نفسها، مطبّقة على المشاريع العربية. فارغ افتراضيا: فقصّات الاستطراد العربية للمحرر قيست دقيقة بما يكفي للتطبيق.
`ميزانية كلمات الأمثلة`	`llm_editor_exemplar_max_words`	int	`500`	min `100`	عدد الكلمات التي يمكن أن تستخدمها كتلة الأمثلة داخل موجّه المحرر. `500` تقتطع بعد نحو خمسة أمثلة؛ و`1500` تمرّر ستة عشر مثالا دون اقتطاع.
`ترتيب الأمثلة بالاسترجاع`	`llm_editor_exemplar_retrieval`	bool	`false`	—	ترتيب الأمثلة حسب تداخل المفردات مع هذا التفريغ بدل الطول، بحيث تأتي الأمثلة من فيديوهات مشابهة.
`الأمثلة السلبية`	`llm_editor_exemplar_negatives`	int	`0`	`0`–`16`	عدد الفقرات المُبقاة التي بدت قابلة للقص لعرضها على المحرر كأمثلة مضادة. يتطلب بنكا مستخرجا مع أمثلة سلبية.
`عيّنات المحرّر (تصويت)`	`llm_editor_samples`	int	`1`	`1`–`5`	تشغيل مرور المحرر الأول بهذا العدد من المرات وقص ما تتفق عليه الأغلبية فقط؛ والباقي يصبح اقتراحات للمراجعة بنص `قصّت بعض عيّنات المحرّر فقط هذا (…) — محفوظ حتى تقرّر`. وكل عيّنة إضافية استدعاء ذكاء اصطناعي إضافي.
`محاذاة القصّات إلى أخفض نقاط الصوت`	`snap_rms_valley`	bool	`false`	—	عندما تقع حدود القص في فجوة بلا صمت مكتشف، تُوضع عند أهدأ 50 مللي ثانية في الفجوة بدلا من المنتصف. يستخدم غلاف جهارة التسجيل؛ ولا استدعاء ذكاء اصطناعي.
`مرور الاتساق بعد المحرّر`	`llm_editor_consistency`	bool	`false`	—	بعد مرور المحرر الأول، يدمج قصّات مجموعة المحاولة نفسها التي تفصل بينها ثلاث كلمات أو أقل من دون توقف، ويمدّ إعادة التسجيل أو البداية المتعثرة فوق صدى شارد إلى التوقف التالي. ولا استدعاء ذكاء اصطناعي.
`الحد الأقصى لرموز خرج محرر LLM`	`llm_editor_max_output_tokens`	int	`65536`	min `1024`	يُضبط دائما لمنع الاقتطاع الصامت. وخفضه يعرّضك لقائمة تحرير مقتطعة. ويقبل Claude Haiku 4.5 حدا أقصى قدره 64,000 رمز خرج، لذا يفشل المشروع على هذا النموذج بخطأ `Claude HTTP 400` إلى أن تضبط هذا الإعداد على `64000`.
`حجم جزء محرر LLM (كلمات)`	`llm_editor_chunk_words`	int	`24000`	min `2000`	مقدار النص المفرغ الذي يُرسل إلى النموذج دفعة واحدة. وهو أيضا السقف الذي لا تستطيع المراجعة الثانية العمل فوقه.
`تداخل أجزاء محرر LLM (كلمات)`	`llm_editor_overlap_words`	int	`600`	min `0`	التداخل بين الأجزاء حتى لا تفوت القصّات القريبة من الحدود.
`أمثلة محرر LLM`	`llm_editor_exemplars`	int	`8`	min `0`	عدد أمثلة الاستبعاد التي تُحقن في الموجّه. والقيمة `0` تعطّل الأمثلة. ويلزم استيراد بنك أمثلة — راجع بنك الأمثلة.
`مسار بنك الأمثلة`	`exemplar_bank_path`	path	empty	—	يتجاوز الموقع الافتراضي للبنك. والفراغ يعني الموقع القياسي داخل حاوية التطبيق.
`عدد مراحل المراجعة الثانية`	`second_look_passes`	int	`0`	`0`–`3`	القيمة `0` تعني الإيقاف. ومفتاح التبديل في المشروع يضبطها على 1 عند تفعيله. راجع المراجعة الثانية.
`مرور التكثيف في النظرة الثانية`	`second_look_condense`	bool	`false`	—	بعد مرورات المراجعة الثانية، يقترح استدعاء إضافي واحد فقرات كاملة من عشرين كلمة فأكثر قد يحذفها هذا المُنشئ، بنص `اقتراح تكثيف (…) — محفوظ حتى تقرّر`. اقتراحات فقط، ولا تُطبَّق تلقائيا أبدا. يتطلب تفعيل المراجعة الثانية.
`الحد الأدنى لثقة المراجعة الثانية`	`second_look_min_confidence`	float	`0.95`	`0.0`–`1.0`	اقتراحات مرحلة التنقيح التي تقل عن هذه القيمة لا تُقصّ تلقائيا أبدا، بل تصبح اقتراحات للمراجعة. وخفضها يجعل الاستبعاد التلقائي أشد حدّة بكثير.
`الحد الأقصى للاستبعاد في المراجعة الثانية (%)`	`second_look_max_removal_pct`	float	`15.0`	`0.0`–`100.0`	ميزانية كل مرحلة كنسبة من الكلمات التي بقيت حتى تلك اللحظة. والاقتراحات التي تتجاوز الميزانية تصبح اقتراحات للمراجعة.
`الحد الأقصى لمقاطع المراجعة الثانية`	`second_look_max_spans`	int	`20`	min `0`	حد أقصى صارم لعدد القصّات المطبَّقة تلقائيا في كل مرحلة. والاقتراحات الزائدة تصبح اقتراحات للمراجعة.
`فئات الاستبعاد التلقائي في المراجعة الثانية`	`second_look_auto_categories`	string	`retake_verbatim,retake_reworded,false_start,noise`	—	الفئات التي يجوز تطبيقها تلقائيا. وفئة `tangent` مستبعَدة عمدا لأنها الخطر المعروف للإفراط في القص.

التفريغ النصي

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

التقييمات

اختيارية، وهذه المجموعة بأكملها مخفية في إصدار App Store — فمنذ RoughCut 1.9.2 أصبحت مجموعة التقييمات مخصّصة للتطوير فقط. وما زالت أربعة من مفاتيحها (المجلد الرئيسي لبيانات التقييم، والحد الأقصى لمقاطع التقييم الكامل، وتتبع Langfuse، وعنوان Langfuse الأساسي) تظهر في تبويب أساسي، لكن لوحة التقييم ومنتقي مجلد المجموعة المرجعية غير موجودين في ذلك الإصدار، فلا يبقى لها ما تحرّكه. أما حقلا مفتاحي Langfuse فلا يظهران في أي مكان، لذا لا يمكن تزويد التتبع بالمفاتيح. راجع قيّم RoughCut مقابل مونتاجك أنت.

التسمية	المفتاح	النوع	الافتراضي	المدى	الأثر
`المجلد الرئيسي لبيانات التقييم`	`eval_dataset_root`	path	empty	—	مجلد المجموعة المرجعية لديك. امنح الإذن من تبويب `النماذج والبيانات` بدل كتابة مسار.
`الحد الأقصى لمقاطع التقييم الكامل`	`eval_full_max_clips`	int	`15`	min `0`	حد أقصى لعدد المقاطع في التشغيل الكامل. والقيمة `0` تشغّل كل المقاطع.
`المفتاح العام لـ Langfuse`	`langfuse_public_key`	secret	empty	—	يُخزَّن في `Keychain`. ولا يلزم إلا للتتبّع.
`المفتاح السري لـ Langfuse`	`langfuse_secret_key`	secret	empty	—	يُخزَّن في `Keychain`. ولا يلزم إلا للتتبّع.
`عنوان Langfuse الأساسي`	`langfuse_base_url`	string	`https://cloud.langfuse.com`	—	غيّره لمنطقة مختلفة أو لنسخة تستضيفها بنفسك.
`تتبع Langfuse`	`langfuse_tracing`	bool	`false`	—	إيقافه يعني عملا محليا بالكامل: لا تغادر الجهازَ أي بيانات تتبّع.
`معدل أخذ عينات Langfuse`	`langfuse_sample_rate`	float	`1.0`	`0.0`–`1.0`	موجود في المخطط. راجع الملاحظة أدناه.
`بيئة Langfuse`	`langfuse_environment`	string	`revamp-v2`	—	وسم البيئة الذي يُطبَّق على عمليات التتبّع.

النظام

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

أربعة مفاتيح — الحد الأقصى للفيديو (GB) والحد الأقصى للصوت (GB) ومعدل أخذ عينات Langfuse ومستوى السجل — تظهر حقولا قابلة للتحرير لكن لا يقرؤها أي جزء من النسخة الحالية. وضبطها لا أثر له. وعلى وجه الخصوص، لا تعتمد على قيمتي GB بوصفهما حدين مفروضين لحجم الملفات.

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

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

ما زالت المشكلة قائمة؟

تواصل مع الدعم

هل كانت هذه الصفحة مفيدة؟