# ربط تتبّع Langfuse

> مراقبة اختيارية من طرف ثالث للمشاريع وعمليات التقييم، معطّلة افتراضيًا وخاملة تمامًا من دون مفاتيحك أنت.
>
> جرى التحقق من المحتوى مقابل تطبيق RoughCut الحالي بتاريخ 28 أغسطس 2026
> https://www.roughcuteditor.com/ar/docs/langfuse

Langfuse لوحة تحكم اختيارية من طرف ثالث لتتبّع عمليات الذكاء الاصطناعي. يُشحن RoughCut والتتبّع معطّل، ويظل العميل خاملًا تمامًا ما لم يكن الخيار مفعّلًا والمفتاحان محفوظين معًا، فلا يُرسَل شيء حتى تفعّله أنت عمدًا. وللربط أنشئ حسابًا ومشروعًا في Langfuse، وانسخ المفتاح العام والمفتاح السري لمشروع Langfuse ذاك، ثم الصقهما في الإعدادات ضمن تبويب Full ومجموعة Evals، وتأكد أن Langfuse base URL يطابق منطقتك أو نسختك المستضافة ذاتيًا، ثم فعّل Langfuse tracing. يُخزَّن المفتاحان في Keychain على macOS. والذي يغادر جهازك هو بيانات وصفية عن التشغيل ودرجات رقمية مجمّعة فقط، من دون أي وسائط أو نص مفرّغ أو مفاتيح API. وإذا كنت تفضّل ألا يُرسَل شيء على الإطلاق فاترك الخيار معطّلًا، وهو الوضع الافتراضي والخيار الآمن.

> ! **متقدم واختياري تمامًا.** Langfuse خدمة من طرف ثالث. وتفعيل التتبّع يعني إرسال بيانات عن تشغيلاتك إلى شركة ليست Apple وليست RoughCut. **الخيار الآمن هو الوضع المشحون افتراضيًا: معطّل.** لا يُرسَل شيء ما دام `Langfuse tracing` معطّلًا، ولا يُرسَل شيء حتى مع تفعيل الخيار ما لم يكن المفتاحان موجودين معًا. وللعودة إلى الوضع الافتراضي في أي وقت، عطّل `Langfuse tracing` ثم اضغط `Save Configuration`؛ ولمزيد من الاحتياط، احذف المفتاحين.

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

- سبب يجعلك ترغب فيه. التتبّع مفيد إذا كنت تشغّل عمليات تقييم كثيرة وتريد جمع سجلها وأزمنتها ودرجاتها في لوحة واحدة عبر الوقت. أما لعدد قليل من التشغيلات، فملفات الملخص داخل مجموعتك المرجعية تكفي.
- حساب على Langfuse ومشروع بداخله. Langfuse ليست تابعة لـ RoughCut.
- أن تكون مرتاحًا للبيانات المذكورة تحت **ما الذي يُرسَل** أدناه. اقرأ ذلك القسم قبل أن تفعّل الخيار.

## الخطوات

1. أنشئ حسابًا على Langfuse، ثم أنشئ مشروعًا بداخله.
2. من إعدادات ذلك المشروع، أنشئ زوج مفاتيح API وانسخ نصفيه: **المفتاح العام** (يبدأ بـ `pk-`) و**المفتاح السري** (يبدأ بـ `sk-`). ويُعرض المفتاح السري عادة مرة واحدة فقط، فانسخه قبل إغلاق الصفحة.
3. في RoughCut، افتح `الإعدادات`، واختر تبويب `Full`، ثم انزل إلى مجموعة `Evals`.
4. الصق المفتاح العام في حقل `Langfuse public key` واضغط زر `Save` الخاص به. ينتقل الحقل إلى حالة محفوظة مع إخفاء القيمة.
5. الصق المفتاح السري في حقل `Langfuse secret key` واحفظه بالطريقة نفسها.
6. تحقق من `Langfuse base URL`. القيمة الافتراضية هي `https://cloud.langfuse.com`؛ غيّرها إذا كان مشروعك يقع على نقطة نهاية إقليمية مختلفة أو على نسخة مستضافة ذاتيًا.
7. فعّل `Langfuse tracing`.
8. اضغط `Save Configuration`.
9. شغّل شيئًا: مشروعًا عاديًا، أو تقييمًا سريعًا من شاشة `التقييم` (`Evaluation`).
10. افتح مشروعك في Langfuse وتأكد من ظهور الأثر.

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

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

ولا يظهر شيء إلا بعد تشغيل يقع **بعد** تفعيلك للتتبّع. فتفعيل الخيار لا يملأ أي سجل بأثر رجعي.

## ما الذي يُرسَل

هذا هو الجزء المهم، ولذلك يُذكر صراحة.

**ما يُرسَل:** بيانات وصفية عن التشغيل ودرجات رقمية مجمّعة. وبالنسبة إلى عملية تقييم، يعني ذلك معرّف التشغيل، والوضع، وكم مقطعًا شارك، وما إذا كان التفريغ النصي على الجهاز أو سحابيًا، وكم مقطعًا حصل على درجة وكم تُجووِز وكم فشل، وما إذا كانت قد وُضعت علامة تراجع، ومتوسط Word-F1 المجمّع. وتحمل الآثار وسم بيئة ووسومًا وصفية قصيرة.

**ما لا يُرسَل:** وسائطك، ونص التفريغ لديك، ومفاتيح API الخاصة بك. لا شيء من ذلك جزء من الأثر.

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

وإذا فشل طلب أثر، فإنه يُسجَّل ويُتجاهل. التتبّع لا يُفشل مشروعًا ولا عملية تقييم أبدًا.

وللصورة الكاملة عمّا يغادر جهازك على مستوى التطبيق كله، راجع [الخصوصية ومسار البيانات](/ar/docs/privacy-data-flow).

## وسم البيئة

`Langfuse environment` نص عادي يُلحق بكل أثر، وهو موجود للفصل بين تشغيلات غير مترابطة داخل مشروع Langfuse واحد. فإذا كنت تتتبّع من أكثر من جهاز، أو أردت فصل فترة تجريب عن تشغيلاتك المعتادة، غيّر الوسم بدل إنشاء مشروع آخر. ولا تتأثر الآثار الحاملة وسمًا سابقًا، لأن الوسم يُطبَّق لحظة إنشاء الأثر.

## أين تُخزَّن المفاتيح

يُخزَّن مفتاحا Langfuse في **`Keychain` على macOS**، مشفَّرين بواسطة النظام، تمامًا مثل مفاتيح مزوّد الذكاء الاصطناعي لديك. ولا يُكتبان أبدًا في ملف إعدادات RoughCut ولا يُدرجان في أي إعدادات مصدَّرة. وبعد الحفظ لا تُعرض عليك القيمة المخزَّنة مرة أخرى؛ بل يمكنك استبدالها عبر `Replace…` أو إزالتها عبر `Remove`.

تعامل مع المفتاح السري كما تتعامل مع كلمة مرور. راجع [فهم إعدادات RoughCut](/ar/docs/settings-overview).

## إذا كانت الخصوصية أولويتك فاتركه معطّلًا

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

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

| العَرَض | السبب | الحل |
|---|---|---|
| لا آثار على الإطلاق | `Langfuse tracing` معطّل | فعّله واضغط `Save Configuration` |
| لا آثار على الإطلاق | أحد المفتاحين ناقص | كلاهما مطلوب. يبقى العميل خاملًا بمفتاح واحد |
| لا آثار على الإطلاق | لم يحدث أي تشغيل منذ تفعيلك للخيار | شغّل مشروعًا أو تقييمًا سريعًا. لا شيء يُملأ بأثر رجعي |
| الآثار مفقودة رغم تفعيل الخيار | المفتاحان يعودان إلى مشروعين مختلفين، أو أن المفتاح العام لُصق في حقل المفتاح السري | أعد نسخ النصفين من زوج مفاتيح المشروع نفسه واحفظهما من جديد |
| لا يصل شيء رغم أن كل شيء يبدو سليمًا | `Langfuse base URL` يشير إلى منطقة خاطئة أو إلى عنوان قديم لنسخة مستضافة ذاتيًا | تحقق من العنوان الأساسي الصحيح لمشروعك وصحّح الحقل |
| لا يصل شيء على شبكة مقيّدة | الوصول الخارجي إلى مضيف Langfuse محجوب | اسمح بالمضيف، أو اقبل أن التتبّع لن يعمل هناك |
| الآثار تظهر في المكان الخطأ | وسم البيئة يختلف عن الوسم الذي تصفّي عليه | طابق `Langfuse environment` مع المرشّح الذي تستخدمه في Langfuse |
| تريد إيقافه | — | عطّل `Langfuse tracing`، واحفظ، ثم احذف المفتاحين |

## أخطاء شائعة

- **توقّع أن يؤثر التتبّع في المونتاج.** لا يفعل. إنه يراقب التشغيلات ولا يغيّرها أبدًا.
- **تفعيل الخيار من دون حفظ.** تغييرات الإعدادات تحتاج إلى `Save Configuration`. أما المفاتيح فتُحفظ فورًا عند ضغط زر `Save` الخاص بها.
- **لصق مفتاح على مستوى المؤسسة.** استخدم زوج المفاتيح الخاص بالمشروع نفسه.
- **افتراض أن فشل الأثر يعني فشل التشغيل.** حالات فشل الأثر تُسجَّل وتُتجاهل عن قصد.

## ملاحظة عن منتج Langfuse

يُطوَّر Langfuse بصورة مستقلة عن RoughCut. وواجهته ومصطلحاته وموضع مفاتيحه داخل إعداداته ونقاط نهايته الإقليمية، كلها قابلة للتغيير من دون إشعار. وحيثما اختلفت هذه الصفحة مع وثائق Langfuse حول أي شيء يخص جانب Langfuse، **فوثائقهم هي المرجع**. أما الثابت في جانب RoughCut فهو ما تصفه هذه الصفحة: مفتاحان، وعنوان أساسي واحد، وخيار تفعيل واحد، ووسم بيئة واحد، وآثار لا تحمل سوى بيانات وصفية عن التشغيل ودرجاته.