كيف يعمل
من الموجّه إلى الـ release، دون مغادرة محرّرك.
مفاتيحك تعيش في Sonenta. ووكيل الترميز لديك يقرؤها ويكتبها عبر MCP. والـ CDN يسلّمها إلى تطبيقاتك. إليك الخطوات الأربع، مع الشيفرة الحقيقية.
1. تثبيت الـ SDK
حزمة واحدة لكل إطار عمل. المفاتيح المستدعاة دون ترجمة تظهر في dashboard أثناء التطوير، دون أن تضيف أي أدوات قياس.
# React (web)
npm i @sonenta/react-i18next
# Next.js · Vue · Svelte · Astro
npm i @sonenta/next
npm i @sonenta/vue-i18n
npm i @sonenta/svelte-i18n
npm i @sonenta/astro
2. ربط الوكيل
يكتب sonenta init إعدادات المشروع وكتلة في CLAUDE.md أو AGENTS.md. ثم يُعلَن خادم MCP في عميلك، بخمسة أسطر من JSON. والكتلة نفسها تصلح لـ Claude Code و Cursor و Claude Desktop.
{
"mcpServers": {
"sonenta": {
"command": "npx",
"args": ["-y", "@sonenta/mcp"],
"env": {
"SONENTA_API_KEY": "snt_live_<prefix>.<secret>",
"SONENTA_PROJECTS": "<uuid1>,<uuid2>"
}
}
}
}
MCP→ 3. ترك الوكيل يترجم
أنت تصف القصد. والوكيل يختار أدواته، ويقرأ الـ glossary والسياق، ولا يتناول سوى المفاتيح غير المترجمة، ثم يقترح. يعمل على جهازك: السير اليومي لا يستهلك credits.
أثر استدعاء الأدوات، مثال
list_untranslated_keys namespace=checkout language_code=es
glossary_list · project_context_get
propose_translations_bulk
publish_cdn
4. النشر
يبني الـ release ملف JSON لكل لغة ولكل namespace، ويقدّمه الـ CDN. تحمّل تطبيقاتك الحزمة الجديدة دون إعادة نشر، وعلى الهاتف دون المرور بالمتاجر.
# depuis la CLI
sonenta releases
# ou depuis l'agent, via MCP
publish_cdn
CLI→ وكلاء Claude Code الخمسة
يثبّت sonenta agents add وكلاء متخصّصين في مستودعك. لكل واحد نطاقه وصفحة توثيقه.
-
sonenta-i18n: يدقّق التغطية، وينشئ المفاتيح الناقصة، ويترجم محلياً، وينشر.
doc → -
sonenta-knowledge: يبني الـ glossary وسياق المشروع ويصونهما.
doc → -
sonenta-a11y: يدقّق أسطح إمكانية الوصول ويصحّحها.
doc → -
sonenta-surface: يدقّق الأسطح حسب الشاشة ويضبطها.
doc → -
sonenta-source-health: يوحّد النصوص المصدرية المكرّرة على مفتاح مرجعي واحد.
doc →