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