مدونة

توطين النص أثناء كتابته بواسطة وكيل الترميز الخاص بك

يتيح خادم localize.dev MCP وخطاف ما بعد التحرير لـ Claude Code و Cursor والوكلاء الآخرين ترجمة نص واجهة المستخدم الجديد في نفس التغيير الذي يضيفه.

Stephen Ufort · 11 نوفمبر 2026 · دقيقتان للقراءة

Claude Code يستدعي أداة localize MCP لإصلاح سطر فشل في فحص i18n

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

يقدم localize.dev للوكيل نفس محرك CLI، كخادم MCP، بالإضافة إلى خطاف يخبر الوكيل عندما يحتوي ملف قام بتحريره على نص غير مترجم. هذا المقال يوضح كيف يتكاملان.

خمسة أدوات

يحتوي خادم MCP على خمسة أدوات. اثنان منها مجانيان ولا يتطلبان مفتاحًا:

  • check: نسخة مشفرة يدويًا وترجمات مفقودة أو قديمة، كل منها مع ملفه وسطره. مرر paths للتحقق فقط من الملفات التي غيرها الوكيل.
  • config: اصطلاحات التطبيق لكتابة نصوص واجهة المستخدم، بحيث تستدعي الشيفرة الجديدة t() بنفس طريقة باقي التطبيق.
  • localize: يعطي مفاتيح نصوص مشفرة، يعيد كتابة الكود ويترجم الرسائل الجديدة.
  • translate: يملأ الترجمات المفقودة في ملفات اللغة.
  • add_language: يضيف لغة إلى الإعدادات ويترجم كل رسالة إليها.

شغله محليًا باستخدام npx -y localize-dev mcp، بحيث يحدث إعادة كتابة الكود على جهازك. أدوات بناء المتصفحات مثل Lovable و Bolt و v0 لا يمكنها بدء عملية محلية، لذا تتصل بالخادم المستضاف عند https://uselocalize.dev/api/mcp باستخدام OAuth أو مفتاح API.

الخطاف الذي يغلق الحلقة

أداة MCP تساعد فقط إذا تذكر الوكيل استدعاءها. في Claude Code، يضمن خطاف بعد التحرير ذلك. بعد كل تعديل أو كتابة، يشغل الخطاف check على الملف الذي غيره الوكيل للتو. إذا كان الملف هو رمز واجهة المستخدم بدون ترجمة، ينتهي الخطاف برمز 2، ويعرض Claude Code رسالته للوكيل:

what the agent sees
localize.dev: src/components/SignIn.tsx has UI text that isn't translated yet.
  line 9: "We'll email you a 6-digit code. No password needed."
Call the localize tool of the localize-dev MCP server with paths ["components/SignIn.tsx"]: it gives this text translation keys, rewrites the code and translates it.
Without the MCP server, run in the project folder: npx localize-dev run --files src/components/SignIn.tsx

ثم يستدعي الوكيل localize بهذا المسار. تحصل الجملة على مفتاح، ويتم إعادة كتابة السطر لاستدعاء t()، ويتم ترجمة الرسالة الجديدة إلى كل لغة تمتلكها التطبيق، في نفس التغيير مثل الكود الذي كان الوكيل يكتبه.

الخطاف لا يتدخل أبدًا مع الوكيل. ملف ليس رمز واجهة المستخدم، وملف نظيف، وأي خطأ في الخطاف نفسه يخرج جميعها برمز 0 ولا تطبع شيئًا. اضبط LOCALIZE_DEV_HOOK=off لإيقافه لجلسة.

إعداده

أمر واحد يضيف كل شيء إلى المستودع:

npx localize-dev init --agent
  • خادم MCP في .mcp.json لـ Claude Code و .cursor/mcp.json لـ Cursor.
  • خطاف بعد التحرير في .claude/settings.json، عند التعديل، MultiEdit والكتابة.
  • قسم في AGENTS.md و CLAUDE.md، وقاعدة Cursor لملفات واجهة المستخدم للتطبيق، تخبر الوكيل بترجمة أثناء الكتابة وتشغيل check قبل الانتهاء.

يضيف فقط إلى الموجود. تظل خوادمك وخطافاتك وتعليماتك، وتشغيله مرة أخرى يستبدل قسمه الخاص بدلاً من إضافة قسم ثاني. أضف --pre-commit للتحقق أيضًا من الملفات المعلقة قبل كل التزام، للتغييرات التي تمت بدون وكيل.

لماذا لا تسأل الوكيل فقط

يمكنك طلب من وكيل استخراج وترجمة النصوص بدون كل هذا، وغالبًا ما ينجح ذلك لملف واحد. عبر التطبيق كله، تتغير المفاتيح بين الملفات، وتختفي أشكال الجمع التي لم يفكر فيها الوكيل، ولا يلتقط شيء الجملة غير المترجمة التالية. يمنح خادم MCP الوكيل نفس سجل المفاتيح، ونفس فحوصات الترجمة، ونفس فحص CI كما في التشغيل الكامل.

جربه على الكود الخاص بك في الملعب، لا يلزم حساب