ترجمة تطبيق باستخدام كوديكس
أضف 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 أولاً في الطرفية الخاصة بك. يقوم بتسجيل دخولك عبر المتصفح ويحفظ مفتاحًا، والذي يقرأه الخادم، لذلك لا يحمل الإعداد أدناه أي شيء.
- أضف جدول [mcp_servers.localize] إلى ~/.codex/config.toml.
- أعد تشغيل الوكيل، أو أعد تحميل خوادم MCP الخاصة به، ليبدأ الترجمة.
- افتح مستودعك واطلب منه شيئًا مثل الموجه أدناه.
[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