توطين النص أثناء كتابته بواسطة وكيل الترميز الخاص بك
يتيح خادم localize.dev MCP وخطاف ما بعد التحرير لـ Claude Code و Cursor والوكلاء الآخرين ترجمة نص واجهة المستخدم الجديد في نفس التغيير الذي يضيفه.
Stephen Ufort · 11 نوفمبر 2026 · دقيقتان للقراءة

يكتب وكلاء الترميز نص واجهة المستخدم بسرعة، وكلها تقريبًا باللغة الإنجليزية المضمنة. يمكن أن يحتوي التطبيق الذي تم توطينه بالكامل الشهر الماضي على عشرات السلاسل غير المترجمة هذا الشهر، ولم يقم أحد بكتابتها يدويًا.
يقدم 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 رسالته للوكيل:
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 كما في التشغيل الكامل.