MiMo Code + JoinGonka Gateway: وكيل Xiaomi على نماذج شبكة Gonka

الخطوة 1: تثبيت MiMo Code. الطرق الرسمية من README المشروع:

# macOS and Linux
curl -fsSL https://mimo.xiaomi.com/install | bash

# Windows (PowerShell)
powershell -ep Bypass -c "irm https://mimo.xiaomi.com/install.ps1 | iex"

# via npm, on any system
npm install -g @mimo-ai/cli

يثبّت السكربت الملف التنفيذي في ~/.mimocode/bin ويسجّل هذا المجلد في PATH عبر ملف تعريف الصدفة (والعلم --no-modify-path يعطّل ذلك). وهو ينزّل البناء من مستودع Xiaomi؛ وإن تعذّر التنزيل فثبّت عبر npm — فهذا هو الإصدار نفسه، وقد وصلنا في كلا الطريقين الإصدار 0.1.15. للتحقق استخدم mimo --version.

الخطوة 2: الحصول على المفتاح. سجّل في gate.joingonka.ai/register، وأكّد بريدك، وأنشئ مفتاحاً بالبادئة jg- من قسم "مفاتيح API". مفتاح واحد ورصيد واحد يكفيان لجميع نماذج الشبكة.

الخطوة 3: تشغيل برنامج التثبيت.

npx @joingonka/setup --tool mimo-code

سيسألك برنامج التثبيت عن المفتاح — فلا يُمرَّر في وسائط سطر الأوامر — وسيكتب الملفين نفسيهما اللذين يكتبهما معالج مزوّدك داخل MiMo Code نفسه، لكن مع الكتالوج الكامل والحدود مباشرةً:

• يسجّل المزوّد joingonka في الإعداد العام ~/.config/mimocode/mimocode.jsonc (أو في mimocode.json أو config.json إن كان MiMo Code يكتب هناك أصلاً): المحوّل @ai-sdk/openai-compatible، وعنوان البوابة مع /v1، وثلاثة نماذج من الشبكة بنوافذ سياقها وسقوف استجابتها ودعم الأدوات؛
• يضع المفتاح في مخزن مفاتيح MiMo Code الخاص — ~/.local/share/mimocode/auth.json بصلاحيات 600. لا يوجد المفتاح في الإعداد نفسه، لذا يمكنك حفظه في ملفات الإعداد بأمان؛
• يضبط النموذج الافتراضي — الحقل model — على DeepSeek V4 Flash، لكن فقط إن لم يكن هناك نموذج مختار أو كان النموذج المختار قد غادر الشبكة. أما اختيارك أنت، بما في ذلك في إعداد عام آخر، فلا يتجاوزه؛
• يحتفظ بنسخ من الملفات السابقة، ولا يمسّ مزوّدي الآخرين ومفاتيحهم وتعليقاتهم، والملف الذي يتعذّر تحليله لا يُعاد كتابته — بل يتوقف ويخبرك بما يجب إصلاحه؛
• في النهاية يرسل طلباً حياً إلى البوابة ويخبرك صراحةً هل قُبل المفتاح والعنوان والنموذج.

يراعي برنامج التثبيت المجلدات غير القياسية تلقائياً: MIMOCODE_HOME وXDG_CONFIG_HOME وXDG_DATA_HOME وMIMOCODE_CONFIG. ولتعيين نموذج افتراضي آخر استخدم العلم --model مع الاختصار deepseek أو glm أو minimax؛ ولملفات الإعداد والخوادم هناك وضع بلا أسئلة:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool mimo-code --non-interactive

إن كان MiMo Code قيد التشغيل فأعد تشغيله: فالمزوّد الجديد يُلتقط عند بدء التشغيل.

كل ما يفعله المثبّت يمكن كتابته يدويًا. هناك ملفان، ولكل منهما مهمته: ملف الإعدادات يصف المزوّد والنماذج، وauth.json يحفظ المفتاح. يربطهما معرّف المزوّد — يجب أن يكون joingonka متطابقًا في كلا الملفين. ملف الإعدادات، ~/.config/mimocode/mimocode.jsonc:

{\n  \"$schema\": \"https://mimo.xiaomi.com/mimocode/config.json\",\n  \"provider\": {\n    \"joingonka\": {\n      \"npm\": \"@ai-sdk/openai-compatible\",\n      \"name\": \"JoinGonka (Gonka)\",\n      \"options\": {\n        \"baseURL\": \"https://gate.joingonka.ai/v1\"\n      },\n      \"models\": {\n        \"deepseek-ai/DeepSeek-V4-Flash-0731\": {\n          \"name\": \"DeepSeek V4 Flash (Gonka)\",\n          \"tool_call\": true,\n          \"reasoning\": true,\n          \"limit\": { \"context\": 380000, \"output\": 32768 }\n        },\n        \"zai-org/GLM-5.3-Flash\": {\n          \"name\": \"GLM 5.3 Flash (Gonka)\",\n          \"tool_call\": true,\n          \"reasoning\": true,\n          \"limit\": { \"context\": 390000, \"output\": 8192 }\n        },\n        \"MiniMaxAI/MiniMax-M2.7\": {\n          \"name\": \"MiniMax M2.7 (Gonka)\",\n          \"tool_call\": true,\n          \"limit\": { \"context\": 200000, \"output\": 8192 }\n        }\n      }\n    }\n  },\n  \"model\": \"joingonka/deepseek-ai/DeepSeek-V4-Flash-0731\"\n}

المفتاح، ~/.local/share/mimocode/auth.json بأذونات 600:

{\n  \"joingonka\": { \"type\": \"api\", \"key\": \"jg-your-key\" }\n}

يُكتب النموذج الافتراضي بصيغة provider/model-id؛ ويُفصل المزوّد عند أول شرطة مائلة، لذا تُكتب معرّفات الشبكة التي تحوي شرطة مائلة خاصة بها كما هي.

أين يمكن أن يوجد المفتاح أيضًا. يعرض README الخاص بـ MiMo Code أيضًا خيار وضع المفتاح مباشرة في ملف الإعدادات — options.apiKey. هذا يعمل، لكن يصبح من السهل حينها إيداع المفتاح مع ملفات الإعدادات الشخصية، كما أن مفتاحًا قديمًا منسيًا هناك سيتجاوز المفتاح الجديد من auth.json — لذلك يزيل المثبّت options.apiKey من كتلته. وفي ملف المشروع .mimocode/mimocode.jsonc لا تضع المفتاح من باب أولى.

أي ملف هو الأساس. يدمج MiMo Code الملفات العامة config.json وmimocode.json وmimocode.jsonc بهذا الترتيب، وكل لاحق يتجاوز ما قبله. وتُطبع النتيجة عبر mimo debug config، أما مسارات ملف الإعدادات والمفاتيح على نظامك فعبر mimo debug paths.

يمكنك إعداد مزود الخدمة الخاص بك دون الحاجة إلى ملفات عبر المعالج المدمج. عند التشغيل الأول، يسأل MiMo Code في دليل المشروع عما إذا كنت تثق بالمجلد (Yes, I trust this folder): سيحصل الوكيل على صلاحية قراءة وتعديل وتشغيل الملفات فيه. بعد ذلك، يفتح الأمر /connect قائمة Select provider: في الأعلى يوجد مدخل لمنصة Xiaomi MiMo وCodex والاستيراد من Claude Code، وفي الأسفل دليل المزودين، وفي النهاية + Custom provider. يطرح المعالج ستة أسئلة:

في تجربتنا، قام المعالج بتسجيل كتلة المزود مع نموذج واحد بدون حدود وحقلين غير موجودين في المثبت: env مع اسم المتغير JOINGONKA_API_KEY، حيث سيبحث MiMo Code عن المفتاح، و options.setCacheKey: true. يعمل هذا مع البوابة، ولكن يجب استكمال الإعدادات: بدون limit سيظهر الأمر mimo models joingonka نافذة بـ 1M توكن. أسهل طريقة هي تشغيل المثبت مرة واحدة بعد المعالج، وسيقوم بإضافة الكتالوج الكامل مع الحدود إلى نفس الكتلة.

اختيار النموذج. الاختيار الدائم يتم عبر الحقل model في ملف الإعدادات. في الواجهة، يتم تغيير النموذج بالأمر /models، وللتشغيل لمرة واحدة — باستخدام العلم -m. تظهر النماذج التي يراها MiMo Code لدى المزود وحجم نافذة السياق التي يعمل بها بواسطة الأمر mimo models joingonka — جنباً إلى جنب مع العتبة التي سيبدأ عندها الوكيل في ضغط السجل:

joingonka/deepseek-ai/DeepSeek-V4-Flash-0731 — window 380K, compacts at 342K
joingonka/MiniMaxAI/MiniMax-M2.7 — window 200K, compacts at 180K
joingonka/zai-org/GLM-5.3-Flash — window 390K, compacts at 351K

سعر جميع نماذج الشبكة واحد، لذا الاختيار يعتمد على السلوك. هكذا كان أداؤها في تجربتنا mimo run في مهمة واحدة — قراءة ملف والعثور على خطأ:

تم تحليل سبب اختيار DeepSeek V4 Flash كخيار افتراضي في مراجعة النموذج.

أولًا، تأكّد من أن MiMo Code يتعرّف على المزوّد والمفتاح:

mimo models joingonka
mimo providers list

يسرد الأمر الأول نماذج الشبكة الثلاثة مع نوافذ السياق، كما في المثال أعلاه؛ أما الثاني فيطبع مسار مخزن المفاتيح وسطر joingonka api. بعد ذلك، لنُجرِ تشغيلًا واحدًا. ضع في مجلد المشروع ملفًا باسم calc.py يحتوي على خطأ واضح — مثل حساب مساحة مستطيل حيث يُجمع الضلعان بدل ضربهما — ثم اطلب منه اكتشافه:

mimo run "Read the file calc.py in the current project directory and tell me in one sentence whether it has a bug."

سيظهر في المخرجات الوكيل والنموذج (> build · deepseek-ai/DeepSeek-V4-Flash-0731)، واستدعاء الأداة (→ Read calc.py)، وإجابة مباشرة في صلب الموضوع — مع تحديد التعبير الخاطئ. يحوّل الخيار --format json المخرجات إلى تدفّق من الأحداث، حيث يحمل كل خطوة عدّاد رموز، بينما يُشغّل -m joingonka/<model-id> العملية على نموذج آخر. في تجربتنا، أكملت النماذج الثلاثة كلها حلقة «الطلب → استدعاء الأداة → النتيجة → الإجابة».

أما الفحص الثالث فهو من جهة البوابة: في لوحة التحكم، في قسم «الاستخدام»، سيظهر الطلب ضمن تفصيل «حسب النماذج»، وفي كتلة «حسب المفاتيح» سيُحدَّث وقت آخر طلب.

وإذا حدث خطأ ما، فعادةً يكفي قراءة الرسالة لتشخيص السبب:

تستهلك أداة الوكيل التوكنات بشكل مختلف عن المحادثة: تضيف MiMo Code إلى كل جملة من جملك المطالبة النظامية (system prompt)، وأوصاف الأدوات وسياق خدمة الوكيل، وتستغرق المهمة عدة خطوات. في تشغيلنا، حمل كل طلب إلى النموذج 22-25 ألف توكن مدخل، وكلف فحص «قراءة ملف والعثور على خطأ» المكون من خطوتين حوالي 45-50 ألف توكن — تقريباً كلها مدخلات. لذلك فإن السعر لكل توكن هنا هو العامل الحاسم.

عبر JoinGonka Gateway تبلغ تكلفة التوكنات $0.0069 لكل مليون في المدخلات و $0.021 لكل مليون في المخرجات — السعر هو نفسه لجميع نماذج الشبكة ويتم استبداله في هذه الصفحة من مصدر حي.

التقديرات في العمود الأيمن — وفقاً لأسعار سبتمبر 2026. للمقارنة — كيف يمكنك الدفع مقابل النماذج في MiMo Code:

تقديرك الخاص للتكلفة في MiMo Code لنماذج البوابة يساوي صفراً — سجلاتها لا تحتوي على حقل cost، وفي الأحداث --format json توجد القيمة "cost": 0. الاستهلاك الحقيقي والرصيد المتبقي موجودان في لوحة التحكم، في قسمي «الاستخدام» و «الفوترة».

الأذونات. في واجهة MiMo Code، يتم طلب تأكيد للإجراءات الخطرة، ولكن في mimo run لا يوجد أحد لسؤاله — يقوم النظام برفض الوصول خارج نطاق المشروع تلقائيًا. بالنسبة للبيئات الموثوقة ذات الاستخدام الواحد، يوجد خيار --dangerously-skip-permissions (أو متغير البيئة MIMOCODE_DANGEROUSLY_SKIP_PERMISSIONS=1): وهو يسمح بكل ما لم يتم حظره بواسطة قاعدة صريحة — فقط داخل حاوية (container) أو بيئة معزولة (sandbox). في الواجهة، يمكن تفعيل وضع مشابه مؤقتًا لجلسة العمل عبر /skip-permissions.

الوكلاء (Agents). افتراضيًا، يعمل build مع مجموعة كاملة من الأدوات، وplan يكتفي بالقراءة والتحليل، بينما يقود compose العملية من المواصفات إلى الكود الموثق؛ يمكنك التبديل بينها باستخدام Tab.

السياق الطويل. عند الوصول إلى حد النافذة، يقوم MiMo Code بإعادة بناء السياق من آخر نقطة فحص (checkpoint)، وذاكرة المشروع، والرسائل الجديدة؛ ويحسب الحد بناءً على limit.context. يمكن الضغط في وقت مبكر باستخدام الأمر /context-limit، بشكل منفصل لكل نموذج.

ما يرتبط بحساب Xiaomi. الإدخال الصوتي (/voice) يتعرف على الكلام بواسطة نموذج منصة MiMo ويكون متاحًا بعد تسجيل الدخول إليها. الكود والأوامر والوكلاء الفرعيون يعملون عبر مزود متصل — في تجربتنا عملنا بدون أي تسجيل دخول.

الصور. نماذج الشبكة نصية: في /modalities اترك لها النص فقط، وبالنسبة للقطات الشاشة قم بإعداد مزود ثانٍ بنموذج يدعم الرؤية (vision).

MiMo Code وOpenCode أقارب بإعدادات مختلفة. لكل منهما ملفات ومجلدات خاصة، لذا لا يتم نقل الإعدادات من أحدهما للآخر:

الإصدار. يتم تحديث المشروع بشكل متكرر؛ من أجل قابلية التكرار قم بتثبيت الإصدار: npm install -g @mimo-ai/[email protected] أو curl -fsSL https://mimo.xiaomi.com/install | bash -s — --version 0.1.15.

توجد وكلاء من المختبرات نفسها للعائلات التي تخدمها الشبكة: MiniMax Code يعمل على نموذج مزوده الخاص MiniMax M2.7، ولدى DeepSeek وZ.ai (مؤلفو GLM) وكلاء خاصون بهم. جميعهم يتصلون بنفس البوابة (gateway) بمفتاح واحد.