التوثيق

نظرة عامة

الترجمة تحوّل النص الذي تصادفه في العميل إلى لغة اختيارك: ردود محادثة الذكاء الاصطناعي، ورسائل التنفيذ، وتعليقات الشيفرة، أو أي تحديد في محرر الشيفرة أو في diff. العمل يقوم به نموذج ترجمة مضبوط على الخادم — العميل يرسل النص فقط ويعرض النتيجة ويخزّنها مؤقتًا لتنتقل بين الأصل والترجمة.

أين تتوفر الترجمة

  • لوحة Copilot — ترويسة كل رسالة (رسائلك، وردود النموذج، وكتل يفكر...) تحمل أيقونة ترجمة. نقرة تستبدل متن الرسالة بترجمتها؛ ونقرة أخرى تعيد الأصل;
  • مسودة رسالة التنفيذ — يعرض صندوق التنفيذ في لوحة Git زر ترجمة فور امتداد مسودتك على عدة أسطر. يترجم المسودة كاملة في مكانها، ونقرة أخرى تعيد صياغتك الأصلية;
  • نافذة تفاصيل التنفيذ — التحويم على تنفيذ في سجل Git يفتح نافذة التفاصيل؛ أيقونة الترجمة بجانب البصمة تبدّل رسالة التنفيذ إلى لغتك;
  • محرر الشيفرة وعرض diff — حدّد أي شيء (التحديدات الكتلية تُحتسب أيضًا)، وانقر بالزر الأيمن واختر ترجمة. شارة كرة أرضية صغيرة تعلّم الأسطر المترجمة في الحاشية، وتفتح بطاقة الترجمة بجانب التحديد.

كيف يعمل

  1. يرسل العميل النص إلى الخادم — مع اسم الملف حين يكون النص محددًا من المحرر أو diff، ليعرف النموذج أي صياغة تعليقات يستخدمها الملف;
  2. يقوم LLM الترجمة على الخادم بترجمته إلى اللغة الهدف المضبوطة في واجهة الويب. تنسيق Markdown (العناوين والقوائم والجداول وكتل الشيفرة) يُحافَظ عليه؛ وفي تحديدات الملفات تُعرف علامات التعليقات مثل // أو # بوصفها زخرفة وتُزال، بينما تبقى الشيفرة والمعرّفات دون مساس;
  3. يعرض العميل النتيجة كـ Markdown هناك من حيث جاء الطلب — استبدال في المكان لرسائل المحادثة، أو في بطاقة قابلة للتمرير لتحديدات المحرر وdiff.

ما تحتاجه

  • خادم مفعّلة فيه خاصية الترجمة — الضبط لمرة واحدة موصوف في إعداد الخادم (قسم LLM في واجهة الويب);
  • عميل سطح مكتب متصل بذلك الخادم. لا شيء يُضبط جهة العميل: كل الواجهات تلتقط إعدادات الخادم نفسها تلقائيًا.

إن لم تكن الترجمة مضبوطة، يعرض العميل خطأ الخادم (مثلًا داخل بطاقة الترجمة) بدلًا من نتيجة.