ترجمتك الأولى.

ما ستعده

يشغّل EveryLocale خدمة خلفية ومساحة عمل متصفح معًا. تترجم الخدمة؛ وتتيح لك مساحة العمل اختيار اللغات والتعامل مع المراجعة. ستنشئ مشروعًا واحدًا، وتترجم ثلاث رسائل إنجليزية إلى الألمانية، وتحمّل ملف JSON بنفس المفاتيح والمتغيرات.

تحتاج إلى Node.js 22.16 أو إصدار أحدث، و pnpm 9.15.9، والوصول إلى نموذج سحابي أو محلي. EveryLocale برنامج مجاني؛ طلبات النموذج السحابي تستخدم رصيد مزودك.

1. التثبيت وإنشاء إعداداتك

افتح محطة طرفية وشغّل هذه الأوامر. تحمّل EveryLocale وتنشئ ملف إعدادات خاص باسم .env في مجلده.

git clone --branch develop https://github.com/bomsn/EveryLocale.git
cd EveryLocale
pnpm install --frozen-lockfile
pnpm build
pnpm run setup

افتح .env في محرر نصوص. أنشأ الإعداد بالفعل رمز تسجيل دخول مساحة العمل وسر جلسة منفصل. احفظهما بسرية. إذا كان الملف موجوداً بالفعل، افتحه بدلاً من تشغيل الإعداد مرة أخرى.

2. اختر النماذج

طلب واحد ينشئ ترجمة؛ طلب منفصل يراجع معناها وصياغتها. يمكنك استخدام نفس النموذج لكلا الدورين. يستخدم هذا المثال Claude Sonnet 4.6 عبر OpenRouter. استبدل الإعدادات المطابقة في .env، وضع مفتاح OpenRouter API الخاص بك في كلا حقلي المفتاح.

EVERYLOCALE_GENERATOR_URL=https://openrouter.ai/api/v1
EVERYLOCALE_GENERATOR_KEY=YOUR_OPENROUTER_KEY
EVERYLOCALE_GENERATOR_MODEL=anthropic/claude-sonnet-4.6
EVERYLOCALE_GENERATOR_INPUT_PRICE=3
EVERYLOCALE_GENERATOR_OUTPUT_PRICE=15
EVERYLOCALE_REVIEWER_URL=https://openrouter.ai/api/v1
EVERYLOCALE_REVIEWER_KEY=YOUR_OPENROUTER_KEY
EVERYLOCALE_REVIEWER_MODEL=anthropic/claude-sonnet-4.6
EVERYLOCALE_REVIEWER_INPUT_PRICE=3
EVERYLOCALE_REVIEWER_OUTPUT_PRICE=15

الأسعار بالدولار الأمريكي لكل مليون رمز. تحقق من الأسعار الحالية للنموذج قبل الترجمة. تساعد هذه الإعدادات EveryLocale على وضع ميزانية للطلبات؛ لا تغيّر فاتورة المزود. يمكنك اختيار نموذج سحابي آخر أو نقطة نهاية محلية في دليل إعدادات النموذج.

3. تحقق من الإعدادات وافتح مساحة العمل

pnpm doctor
pnpm start

يتحقق Doctor من إعدادك وقاعدة البيانات دون تقديم طلب مدفوع. إذا أبلغ عن إعداد مفقود، صحح هذا الإعداد وشغّله مرة أخرى. أبقِ محطة الخدمة مفتوحة، ثم زر http://localhost:4310 في متصفحك.

سجّل الدخول باستخدام EVERYLOCALE_ADMIN_TOKEN من .env. ستتحقق ترجمتك الأولى من وصول المزود الفعلي؛ فحص الإعداد وحده لا يمكنه التحقق من مفتاح API.

4. أنشئ مشروعك الأول

اختر New project. سمّه My first app، استخدم first-app كمعرّف له، واحتفظ بالإنجليزية كلغة أصلية. اختر الألمانية وأزل تحديد خانات اللغات الهدف الأخرى لهذه التجربة الأولى. عيّن ميزانية ترجمة إجمالية قدرها $1.

اختر Automatic approval. يمكن تحميل الترجمات النظيفة بعد الفحوصات والمراجعة بواسطة الذكاء الاصطناعي. المشاكل الجوهرية لا تزال في انتظار الاهتمام. اختر Human review gate بدلاً من ذلك إذا كنت تريد الموافقة على كل نتيجة بنفسك.

5. ترجم العينة

افتح Content → Add content، اختر Use sample messages، واحتفظ باسم المحتوى messages وتنسيق JSON. تحتوي العينة على:

{
  "welcome": "Welcome, {name}!",
  "createProject": "Create a project",
  "saved": "Your changes are saved."
}

اختر Import content. يحفظ الاستيراد النص الإنجليزي دون استدعاء أي نموذج. حدد الألمانية لهذا المحتوى، ثم اختر Translate changes. افتح Review لمتابعة التقدم وفحص المشكلات التي كشفتها المراجعة.

في الوضع التلقائي، تصبح النتيجة النظيفة موافق عليها. إذا وجدت المراجعة مشكلة، صحح الصيغة واحفظها لمراجعة أخرى. المشاريع المحمية بالبوابة البشرية تحتاج إلى موافقتك قبل التنزيل.

6. تنزيل وتجربة تغيير

عد إلى Content، افتح messages، حدد الألمانية، واختر Download approved. يحتفظ JSON بنفس المفاتيح ويحافظ على {name}. يمكن لتطبيقك استبدال هذا المتغير باسم شخص.

Previewيقارن الملفات الكاملة. Connect → Export approved ينزل كتالوجًا يحتوي على معلومات الموافقة لوقت تشغيل EveryLocale؛ Download approved يعطيك تنسيق الملف الأصلي.

عدّل الآن المثال الأصلي، وأعد استيراده بنفس اسم المحتوى، ثم اختر Translate changes. يحتاج النص الذي تغيّر فقط إلى عمل جديد. بعد الموافقة، نزّل الملف المحدّث.

إذا كان هناك شيء يحتاج إلى اهتمام

• الترجمة غير متاحة: كوّن كلا النموذجين، شغّل pnpm doctor، وأعد التشغيل.
• خطأ المزود: تحقق من المفتاح والنموذج والنقطة النهائية والرصيد المتاح؛ أصلح السبب وأعد محاولة المهمة الفاشلة.
• الميزانية استنفدت: افحص النفقات المسجلة قبل رفع الحد الإجمالي للمشروع.
• التنزيل غير مكتمل: أكمل المراجعة لكل رسالة حالية في اللغة المحددة.

دليل البدء الكامل يغطي استكشاف أخطاء التثبيت. للخادم المشترك أو Docker، استخدم دليل الاستضافة والاسترجاع بعد أن تعمل ترجمتك الأولى.