Zoo Code + JoinGonka Gateway: الانتقال من Roo Code إلى نماذج Gonka

الخطوة 1: تثبيت الإضافة. في VS Code، افتح لوحة الإضافات (Ctrl+Shift+X، وعلى macOS Cmd+Shift+X)، وابحث عن «Zoo Code» وثبّت الإضافة من الناشر Zoo Code Organization. أو بأمر واحد:

code --install-extension ZooCodeOrganization.zoo-code

تحتاج إلى VS Code 1.100 أو أحدث — كما هو مذكور في بيانات الإضافة؛ بالنسبة لـ VSCodium وWindsurf والمحررات الأخرى التي لا تحتوي على Marketplace، نُشرت الإضافة على Open VSX. إلى جانب القناة المستقرة (3.82.2 بتاريخ 18 سبتمبر 2026) هناك إصدار تجريبي 3.83.x — إصدارات ليلية من الفرع الرئيسي؛ للعمل اختر الإصدار المستقر. بعد التثبيت، سيظهر رمز Zoo Code على شريط الأنشطة.

الخطوة 2: الحصول على المفتاح. سجّل في gate.joingonka.ai/register، وأكّد عنوانك، وأنشئ مفتاحاً ببادئة jg- في قسم «API Keys». يُستحسن إنشاء مفتاح منفصل لـ Zoo Code: ستظهر تكاليفه في الإحصائيات بسطر مستقل.

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

npx @joingonka/setup --tool zoo --model deepseek

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

Zoo Code is configured in the VS Code extension UI (no file is written).
Open the Zoo Code settings (gear icon) → API Provider, then enter:

  API Provider: OpenAI Compatible
  Base URL:     https://gate.joingonka.ai/v1
  API Key:      jg-your-key
  Model:        deepseek-ai/DeepSeek-V4-Flash-0731

Then set the real limits of this model under Model Configuration
(the defaults do not fit any Gonka model):

  Context Window Size: 380000
  Max Output Tokens:   32768
  Image Support:       off

Zoo Code relies on native tool calling only — all our Gonka models support it.

ثم يأتي ملخّص طلب مباشر إلى البوابة — عند النجاح يظهر السطر ✓ Verified: the gateway accepted the key, base URL and model. يتم التحقق من المفتاح والعنوان والنموذج فوراً، لا عند أول مهمة. المفتاح في الكتلة المطبوعة يظهر كاملاً لتسهيل نسخه — لا تنشر هذا الناتج.

بدون علم --model، سيستخدم المثبّت MiniMax M2.7: حيث يختار المستخدم النموذج يدوياً، يقترح النموذج الأكبر سعةً في الشبكة. لـ Zoo Code ننصح بالبدء بـ DeepSeek V4 Flash: في اختبارنا، أكمل الدور بعد نتيجة الأداة من الطلب الأول — التفاصيل في قسم الاختبار؛ كما يقبل العلم الاختصارات glm (GLM-5.3 Flash) وminimax. بدون علم --tool، سيعرض المثبّت قائمة من 25 أداة.

تفصيل واحد حول النموذج: لا يوجد قسم منفصل بعنوان Model Configuration في Zoo Code 3.82.2. توجد حقول الحدود في النموذج نفسه أدناه، تحت الشرح «Configure the capabilities and pricing for your custom OpenAI-compatible model»، مع ظهور Max Output Tokens قبل Context Window Size.

عند التشغيل الأول، يعرض Zoo Code ترحيباً مع زر Choose your provider: يؤدي إلى نموذج تم اختيار OpenRouter فيه مسبقاً — قم بتغيير الموفر إلى OpenAI Compatible واضغط على Finish في النهاية. لاحقاً، يمكن فتح نفس النموذج عبر أيقونة الترس في رأس لوحة Zoo Code، قسم Providers؛ يتم حفظ التغييرات عبر زر Save.

حدود نماذج الشبكة:

بقية الإعدادات يمكن تركها كما هي: اترك Enable streaming و Include max output tokens مفعلين، و Enable R1 model parameters و Use Azure معطلين (هذه علامات لنماذج عائلة R1 ولـ Azure OpenAI)، واترك حقول Custom Headers و Extra Body فارغة.

تُحفظ الحدود في الملف الشخصي (Profile) وليس مع النموذج: إذا قمت بتغيير Model في نفس الملف الشخصي، ستظل النافذة وحد الإجابة كما هي. لذلك، من الأفضل إنشاء ملف شخصي خاص لكل نموذج — هذا ما سيتناوله القسم التالي.

نشأ Zoo Code من قاعدة كود Roo Code، لذا فإن الانتقال يستغرق بضع دقائق ولا داعي للمساس بملفات المشروع. يصف دليل الترحيل الرسمي كيفية تصدير الإعدادات واستيرادها؛ أما الباقي فيتم نقله عبر زر منفصل أو قراءته من المسارات القديمة:

ملف تعريف Roo Code الذي كان متصلاً بالفعل بـ JoinGonka Gateway سينتقل بالعنوان والمفتاح والنموذج والحدود - فقط تأكد من أن النموذج متاح في الشبكة الآن: القائمة يتم الحصول عليها عبر GET https://gate.joingonka.ai/v1/models.

الأنماط والملفات الشخصية. توجد خمسة أنماط مدمجة: Code، Debug، Architect (يعدل ملفات Markdown فقط)، Ask (يجيب بدون تعديلات)، و Orchestrator (يوزع المهام الفرعية على أنماط أخرى). يمكنك التبديل بينها عبر قائمة بجوار حقل الإدخال، أو بأمر يحمل اسم النمط في بداية الرسالة، مثل /architect، أو باختصار Ctrl+. (Cmd+. على نظام macOS). يتذكر كل نمط الملف الشخصي الذي عملت به آخر مرة، وعند تغيير النمط، يقوم Zoo Code بتبديل الملف الشخصي تلقائيًا.

من هنا تأتي مخطط مريح: ملف تعريف لكل نموذج، مثبت على الأنماط. في Settings ← Providers، اضغط على "+" بجوار حقل Configuration Profile، وقم بتسمية الملف الشخصي، على سبيل المثال Gonka DeepSeek، واملأ النموذج؛ كرر ذلك لـ GLM-5.3 Flash و MiniMax M2.7 - العنوان والمفتاح متطابقان للجميع. بعد ذلك، في كل نمط، اختر الملف الشخصي من قائمة الملفات الشخصية بجوار حقل الإدخال، وسيقوم النمط بتذكره. رمز القفل في هذه القائمة، على العكس من ذلك، يثبت ملفًا شخصيًا واحدًا لجميع أنماط مجلد العمل.

مستوى التفكير. تفتح علامة Enable Reasoning Effort في النموذج قائمة Low و Medium و High و Extra High و Max؛ طالما أنها معطلة، لا يتم إدراج المستوى في الطلب. في GLM-5.3 Flash، يكون المفتاح ثنائيًا في جوهره: Low يوقف التفكير، وأي مستوى آخر يتركه كاملاً - من المريح الاحتفاظ بملف تعريف GLM منفصل مع Low للأسئلة السريعة. مزيد من التفاصيل في مراجعة GLM-5.3 Flash. بالنسبة لـ DeepSeek V4 Flash و MiniMax M2.7، لا تقوم البوابة بإعادة كتابة المقياس: كيفية عمل المستوى تعتمد على النموذج نفسه.

افتح مجلداً يحتوي على ملف صغير به خطأ واضح، على سبيل المثال calc.py مع دالة جمع تقوم بعملية طرح، وفي وضع Code اكتب: "اقرأ calc.py وأخبرني في جملة واحدة ما إذا كان يحتوي على خطأ". سيطلب Zoo Code الإذن لقراءة الملف — "Zoo wants to read this file"، مع وجود زري Approve و Deny، إذا لم يتم السماح بالقراءة مسبقاً في Auto-Approve. بعد ذلك، سيستدعي النموذج أداة الإكمال، وستنتهي المهمة بكتلة Task Completed مع إجابة موضوعية؛ أما الاستنتاجات، إن وجدت، فتظهر في كتلة منفصلة باسم Thinking. يتم حساب النسبة المئوية لامتلاء السياق في عنوان المهمة المطوي بناءً على Context Window Size — وهذا سبب آخر لضبطه بشكل صحيح.

لقد قمنا بإعادة إنتاج هذا المسار من خلال طلب وفق نموذج Zoo Code — تدفق، أدوات في مخطط صارم، مع وجود نتيجة read_file في السجل. أجاب DeepSeek V4 Flash باستدعاء أصلي attempt_completion مع استنتاج صحيح: الدالة تقوم بالطرح بدلاً من الجمع. النصف الثاني من التحقق هو لوحة تحكم البوابة (Gateway): في قسم "الاستخدام" سيظهر الطلب مقسماً حسب النماذج، وسيتم تحديث وقت آخر استخدام للمفتاح.

بدون Auto-Approve، يظهر الخطأ ككتلة API Request Failed مع زري Retry و Start New Task، ومعها عنوان Provider Error مع رمز الخطأ والعد التنازلي لإعادة المحاولة. يمكن رؤية نص رد البوابة في الرسالة أو في تفاصيلها:

يستهلك الوكيل (agent) الرموز (tokens) بشكل مختلف عن الدردشة. في كل طلب، يضع Zoo Code موجه نظام (system prompt) بقواعد الوضع، وأوصاف الأدوات، ومعلومات عن مجلد العمل — هذه آلاف الرموز قبل طرح سؤالك، وعادة ما تستغرق المهمة عدة خطوات. لذلك، السعر لكل رمز هنا هو العامل الحاسم.

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

للمقارنة — كيف يمكنك الدفع مقابل النماذج في Zoo Code:

مع تعبئة Input Price و Output Price، تظهر تكلفة المهمة في عنوانها، ولكن بدقة تصل إلى السنت — المهام القصيرة على نماذج الشبكة ستظهر $0.00. الاستهلاك الدقيق والرصيد المتبقي موجودان في لوحة التحكم، في قسمي «الاستخدام» (Usage) و «الفواتير» (Billing).

التأكيدات والاستقلالية. يتم تعطيل Auto-Approve افتراضياً، ويطلب Zoo Code إذناً للقراءة والكتابة وتنفيذ الأوامر؛ للمهام الطويلة، قم بتفعيل الفئات المطلوبة في قائمة Auto-approve بجانب حقل الإدخال. بالنسبة للأوامر، يوجد Destructive Command Guard (الإعدادات ← Auto-Approve): تقوم الإضافة بتحميل ملفها التنفيذي، وبعدها تُنفذ الأوامر المسموح بها تلقائياً، بينما تنتظر الأوامر المحظورة التأكيد. مع Auto-Approve، يقوم Zoo Code بإعادة محاولة الطلبات الفاشلة تلقائياً: يبدأ التوقف المؤقت من 5 ثوانٍ ويتضاعف مع كل محاولة، لكنه لا يتجاوز 10 دقائق.

الاستجابة المتدفقة (Streaming). لا تقم بإيقاف Enable streaming: في وضع التدفق، تقوم البوابة بإرسال النص فور توليده وتقصر الاستجابة على سقف النموذج فقط، بينما الطلب بدون تدفق وبدون حد واضح يتم قطعه عند 1500 توكن (بالنسبة لنموذج GLM-5.3 Flash — عند 3000).

فهرسة الكود. يتم ضبط البحث الدلالي في المشروع (Codebase Indexing) بشكل منفصل عن النموذج، عبر مزود التضمينات (embeddings)؛ ويوجد خيار محلي لذلك هو Semble - Local.

الصور. نماذج الشبكة هي نماذج نصية. بالنسبة للقطات الشاشة والنماذج الأولية، قم بإنشاء ملف تعريف منفصل مع نموذج يتعامل مع الصور، وقم بالتبديل إليه عند تنفيذ هذه المهمة.

الخصوصية. يرسل Zoo Code بيانات الأخطاء والاستخدام إلى المطورين، مرتبطة بمعرف التثبيت — بدون الكود أو المطالبات (prompts)؛ يمكن تعطيل ذلك عبر مفتاح Allow error and usage reporting في Settings ← About Zoo Code. من جانبها، لا تقوم البوابة بتخزين محتوى المطالبات أو الردود: لا تظهر في الحساب سوى عدادات الطلبات والتوكنز.