فهم إعدادات RoughCut

التبويبات الأربعة

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

تبويب أساسي مجموعة فرعية من متقدم، وليس مجموعة إعدادات مختلفة. والإعداد الذي يظهر في التبويبين هو الإعداد نفسه، وتعديله في أي منهما له الأثر نفسه.

مبدّل اللغة موجود دائما في الترويسة

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

هناك طريقتان لتغييره، وسلوكهما مختلف:

• قائمة الترويسة تطبّق التغيير وتعيد تشغيل RoughCut فورا.
• صف لغة التطبيق في تبويب أساسي يطبّق التغيير لكنه يؤجّل إعادة التشغيل. فهو يعرض يسري التغيير بعد إعادة تشغيل RoughCut. مع زر إعادة التشغيل الآن، حتى تنهي ما تعمل عليه أولا.

وفي الحالتين، لا بد أن يعيد RoughCut التشغيل لتبديل لغة الواجهة واتجاه التخطيط. راجع التبديل بين الإنجليزية والعربية.

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

ما الذي يكتبه حفظ الإعدادات فعليا

يوجد زر حفظ الإعدادات في ترويسة الإعدادات وهو متاح من كل التبويبات. وما يكتبه أضيق مما يتوقعه معظم الناس.

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

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

وعند النجاح تؤكد النافذة بالرسالة تم حفظ الإعدادات. أما الفشل فيظهر بالرسالة «تعذر حفظ الإعدادات: …» ولا يمر بصمت أبدا.

المفاتيح والأسرار الأخرى تذهب إلى Keychain بدلا من ذلك

مفاتيح API ليست جزءا من ملف الإعدادات، وحفظ الإعدادات لا يكتبها أبدا؛ فهي تُنزع قبل كتابة الملف.

ولكل حقل سرّي زر حفظ خاص به، وضغطه يخزّن القيمة فورا في Keychain الخاص بنظام macOS. وفي إصدار App Store تعمل ثلاثة حقول بهذه الطريقة: مفتاح OpenAI API، ومفتاح Gemini API، ومفتاح Claude API. أما حقلا مفتاحَي Langfuse فينتميان إلى مجموعة التقييمات المخصصة للتطوير فقط.

ويبيّن لك الحقل الحالة التي هو فيها:

• غير محدَّد — حقل نص آمن يحمل العبارة ألصق مفتاحك هنا وشارة برتقالية مكتوب عليها غير مضاف.
• محفوظ — علامة صح خضراء، وقيمة مقنَّعة، والتعليق محفوظ في Keychain، مع زرّي استبدال... واستبعاد.

ولا يُعرض عليك السر المخزَّن مرة أخرى أبدا، لا في التطبيق ولا في أي مكان آخر. فإن فقدت مفتاحا فأنت تستبدله؛ ولا يمكنك قراءته من داخل RoughCut.

ولأن الأسرار تُحفظ بشكل مستقل، لا حاجة إلى ضغط حفظ الإعدادات بعد إدخال مفتاح — وبالمقابل، إدخال مفتاح لا يحفظ تغييراتك المعلّقة الأخرى، بما فيها تغيير مزود LLM. وزر ثالث، استخدام النموذج داخل اختيار نموذج وتقدير التكلفة…، يملأ حقل النموذج ومستوى الاستدلال فقط؛ وحفظ الإعدادات هو ما يطبّقهما. راجع أضف مفتاح OpenAI API وأضف مفتاح Gemini API وأضف مفتاح Claude API واختر OpenAI أو Gemini أو Claude.

شارة تم التعديل

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

وهي لا تعني «غير محفوظ». فالقيمة التي حفظتها قبل شهور ما زالت تحمل الشارة، والقيمة التي كتبتها للتو ولم تحفظها بعد لا تفقدها. اقرأ الشارة على أنها «هذه لم تعد القيمة الافتراضية» — فهي أسرع طريقة لترى، في تبويب متقدم، كل ما غيّرته.

والحقول السرية لا تعرض الشارة أبدا، أيا كانت حالتها. استعن بمؤشري غير مضاف ومحفوظ في Keychain لتلك الحقول بدلا منها.

كيف تُحسم قيمة أي إعداد

حين يحتاج RoughCut إلى قيمة، يبحث عنها في ثلاثة مواضع فقط، بهذا الترتيب:

1. القيمة الافتراضية في المخطط — القيمة التي يُشحن بها RoughCut.
2. ملف الإعدادات — انحرافاتك المحفوظة، وهي تتجاوز القيمة الافتراضية.
3. التجاوز الخاص بالمشروع — ما اخترته في شاشة المشروع لهذا المشروع وحده، وهو يتجاوز الطبقتين قبله.

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

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

أبقِ على القيم الافتراضية

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

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

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

أخطاء شائعة

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

معالجة المشكلات

ما زلت عالقا؟ راجع معالجة المشكلات حسب العرَض.