localize.dev

الوثائق / الوكلاء / GitHub Copilot in VS Code

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

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

كيف يعمل

يستخدم Copilot خوادم MCP في وضع الوكيل، وتقرأ VS Code منها من .vscode/mcp.json في مساحة العمل. قم بتثبيت هذا الملف وسيحصل كل من يفتح المستودع على أدوات localize.dev.

اطلب من Copilot ترجمة المفاتيح الجديدة، أو إضافة لغة، أو التحقق من صفحة قبل المراجعة. تتغير ملفات اللغة في مساحة العمل الخاصة بك مثل أي تعديل آخر، لذا يمكنك مراجعتها في نفس الفرق.

إعدادها

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

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

ما تحصل عليه

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

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

  • يستخدم ملف VS Code servers، وليس mcpServers، وكل خادم يحتاج إلى "type": "stdio". المقتطف الذي تم لصقه من عميل آخر هو السبب المعتاد لعدم بدء تشغيل الخادم.
  • أدوات MCP متاحة في وضع الوكيل، وليس في وضع الطلب أو التعديل.
  • يكتب npx localize-dev init --agent التعليمات إلى AGENTS.md. إذا لم يقرأ إعداد Copilot الخاص بك AGENTS.md، فانسخ القسم إلى .github/copilot-instructions.md.

جربه

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

“ترجمة المفاتيح الجديدة في locales/en.json إلى كل لغة.”

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

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

npx localize-dev check

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