localize.dev

الوثائق / الوكلاء / Cursor

ترجمة تطبيق باستخدام كيرسر

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

كيف يعمل

وكيل كيرسر يقرأ خوادم MCP من .cursor/mcp.json. أضف localize.dev هناك ويمكن للوكيل التحقق من التطبيق بحثًا عن نص مكتوب بشكل ثابت، وإعادة كتابته إلى مكتبة i18n الخاصة بك وترجمته، في نفس الدردشة التي يبني فيها الميزة.

يقوم npx localize-dev init --agent بكتابة خادم المشروع و .cursor/rules/localize.mdc، وهي قاعدة مقيدة بملفات واجهة المستخدم الخاصة بك والتي تخبر الوكيل باستدعاء localize بعد تغيير النص الذي يراه الأشخاص.

إعدادها

قم بتشغيل npx localize-dev login أولاً في الطرفية الخاصة بك. يقوم بتسجيل دخولك عبر المتصفح ويحفظ مفتاحًا، والذي يقرأه الخادم، لذلك لا يحمل الإعداد أدناه أي شيء.

  1. أضف localize إلى .cursor/mcp.json.
  2. أعد تشغيل الوكيل، أو أعد تحميل خوادم MCP الخاصة به، ليبدأ الترجمة.
  3. افتح مستودعك واطلب منه شيئًا مثل الموجه أدناه.
.cursor/mcp.json
{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

ما تحصل عليه

أين يذهب الخادم
.cursor/mcp.json
خادم
localize-dev mcp، تم تشغيله باستخدام npx على جهازك
مفتاح
الذي حفظه npx localize-dev login
ما يضيفه init --agent
الخادم في .cursor/mcp.json، وقاعدة لملفات واجهة المستخدم الخاصة بك، وقسم AGENTS.md

من الجيد معرفته

  • لا يحصل كيرسر على خطاف ما بعد التحرير؛ القاعدة وقسم AGENTS.md يقومان بهذه المهمة. لالتقاط ما فات الوكيل، قم بتشغيل npx localize-dev check --changed قبل الالتزام، أو أضف --pre-commit إلى init --agent.
  • كيرسر هو تطبيق سطح مكتب ولا يرث بيئة shell الخاصة بك، وهذا هو سبب عدم حمل المقتطف لأي مفتاح: يقرأ الخادم المفتاح الذي حفظه npx localize-dev login.
  • ضع الخادم في ~/.cursor/mcp.json ليكون في كل مشروع، أو قم بتثبيت localize.dev من قائمة المكونات الإضافية لكيرسر.

جربه

اسأل شيئًا كهذا. يجب على الوكيل استدعاء أداة add_language.

“أضف اليابانية إلى هذا التطبيق.”

احتفظ بها مترجمة

لا يزال النص الذي يتركه الوكيل ثابتًا يتم اكتشافه: يفشل npx localize-dev check في CI في طلب سحب يضيف نسخة غير مترجمة، ولا يحتاج إلى مفتاح.

npx localize-dev check

جميع الوكلاء ومرجع الأداة موجودون في صفحة خادم MCP.