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