الوثائقكيف يُحسم النص5 دقيقة قراءة

كيف يُحسم النص

طلبٌ واحد، وأربعة مصادر للجواب. ومعرفة أيّ المصادر أجابَت تشرح كلفته وزمنه، ولماذا تُترجَم الكلمة نفسها مرتين.

originالمعنىالكلفة
cacheما زالت ذاكرتُنا المشتركة تحتفظ بهذا النص لهذا المشروعلا شيء
approvedاعتمده فريقك في صندوق الوارد، فالسطر المحفوظ هو الجوابلا شيء
pendingأنتجها النموذج ولم يراجعها أحد بعدلا شيء
modelاستدعاءٌ مباشر للنموذج، ويُحفَظ قيدَ المراجعة كي لا يتكرّرأحرف النص الأصلي

لا يُدفَع إلا لاستدعاء النموذج، وعلى النص الأصلي لا على الترجمة الناتجة. النص نفسه ذو الأربعين حرفًا، ولو تكرر مئة مرة، مجاني.

السياق جزء من الهوية

يُخزَّن النص تحت بصمة للنص بعد تصغيره مع اللغة الهدف والسياق. لذا «Account» بلا سياق و«Account» مع screen:checkout نصّان مختلفان، ويصح أن تكون ترجمتهما مختلفة. هذا هو المنتج كله: كلمة بلا شاشة مجرّد تخمين.

t('Account')                     // → «الحساب» as a bill, perhaps
t('Account', 'screen:settings')   // → «الحساب» as a menu item
t('Account', 'screen:checkout')   // → different string entirely, and different storage

// The screen: prefix is a convention, not a parser. The dashboard groups on it —
// an Inbox row whose context says screen:checkout lands under a "checkout"
// screen, and export?screen=checkout can select it. Any other text in the
// context is passed to the model as written.
screen:<name>
حروف وأرقام وشرطات. ثبّت الأسماء كما هي، فهي أساس مرشّح الشاشة والتصدير المتداخل.
tone:
نصٌّ حر يصل إلى النموذج، مثل tone:formal، فهو يأخذه حرفيًا.
max length
160 حرفًا بلا < ولا >، وترفضهما الخدمة عمدًا لأن السياق جزء من موجّه النموذج.

المسرد قيد لا تلميح

يُطابَق مصطلح المسرد مع النص الأصلي ويُرسل داخل الطلب إلى النموذج كقيد صارم. وإن تجاهله النموذج عُدّ الجواب منحرفًا عن المسرد وعُلِّم سطره في صندوق الوارد — فتصلك الترجمة والتحذير معًا، ولا تُعاد كتابة مصطلحك في صمت.

أين تُحفظ الأشياء

  • ذاكرة الحزمة ثم localStorage (وفي Flutter: shared_preferences) — ثلاثون يومًا وألف مدخل افتراضيًا، بمفتاح النص والهدف والسياق.
  • ذاكرة الخادم المشتركة — ومنها تُجاب كل الأجهزة أولًا، لثلاثين يومًا.
  • سجل المعتمد في مشروعك: فالمعتمد يسبق المنتظرَ للمراجعة، ولا يُسأل النموذج ثانيةً عن عملٍ دفعته بالفعل.