localize.dev

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

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

أضف localize.dev إلى ~/.codex/config.toml حتى يتمكن OpenAI Codex من العثور على النص الثابت لواجهة المستخدم، ومنحه مفاتيح وترجمته، في واجهة سطر الأوامر وامتداد IDE.

كيف يعمل

يقرأ Codex خوادم MCP من ~/.codex/config.toml، وتشارك واجهة سطر الأوامر وامتداد IDE هذا الملف. أضف جدول [mcp_servers.localize] مرة واحدة ويمكن لكليهما استدعاء أدوات localize.dev.

يتبع Codex AGENTS.md. يضيف npx localize-dev init --agent قسمًا هناك يخبره باستدعاء localize بعد تغيير نص واجهة المستخدم وتشغيل npx localize-dev check --changed قبل الانتهاء.

إعدادها

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

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

ما تحصل عليه

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

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

  • ملف التكوين هو TOML، وليس JSON: command و args يذهبان تحت [mcp_servers.localize].
  • لا يحصل Codex على خطاف بعد التحرير. يلتقط قسم AGENTS.md و check في CI النص الذي يتركه ثابتًا.
  • ابدأ بموجه للقراءة فقط: اطلب من Codex تشغيل check قبل فتح طلب سحب. check و config لا يحتاجان إلى مفتاح ولا يستخدمان بدلًا خاصًا بك.

جربه

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

“قبل أن أفتح طلب السحب (PR)، تحقق من النصوص المكتوبة بشكل ثابت والترجمات المفقودة.”

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

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

npx localize-dev check

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