أقسام قاعدة المعرفة ▾

التنقل

▸ ابدأ من هنا حسب الدور

الفئات

أدوات 54
قاموس المصطلحات 12

الأدوات

Roo Code + Gonka AI - وكيل ذكاء اصطناعي مستقل في VS Code

هام: تم إغلاق إضافة Roo Code في 15 مايو 2026. تم نقل المستودع إلى الأرشيف ولن تكون هناك تحديثات أخرى. يستمر التطوير بواسطة Zoo Code — وهو فورك بدأه مجتمع Roo Code: يتم إعداد المزود فيه بنفس الطريقة، وللانتقال يوجد دليل الترحيل ودليل Zoo Code الخاص بنا. الوكلاء مفتوحو المصدر الآخرون لـ VS Code هم Kilo Code وCline، الذي تفرع منه Roo Code سابقاً. الإضافة المثبتة بالفعل تستمر في العمل، والتعليمات أدناه تظل صالحة لها.

Roo Code هو وكيل ذكاء اصطناعي مستقل لـ VS Code: يقرأ ويحرر الملفات، وينفذ الأوامر في الطرفية، ويعمل مع المتصفح ويكمل مهام التطوير متعددة الخطوات. هذا هو فورك لـ Cline، الذي مضى أبعد من ذلك: أوضاع عمل قابلة للتخصيص (Architect, Code, Ask, Debug وأوضاع خاصة)، تعليمات مخصصة للمشروع ولوحة إعدادات مرنة للنماذج. في الواقع، إنه فريق كامل من متخصصي الذكاء الاصطناعي داخل المحرر.

المشكلة الرئيسية لهؤلاء الوكلاء هي استهلاك الرموز (tokens). بالنسبة لمهمة واحدة، يقوم Roo Code بتشغيل سياق الملفات، ومخرجات الأوامر، ونتائج الأدوات — وهذا يعني عشرات الملايين من الرموز. مع أسعار Anthropic ($3-15 لكل 1M)، تصبح الجلسة الواحدة الكاملة بتكلفة $30-1500. بالنسبة للعمل اليومي، هذا غير واقعي.

JoinGonka Gateway يقلل التكلفة بآلاف المرات: نفس الجلسة ستكلف $0.01-1.00. تقوم البوابة بإعادة بيع الـ inference الخاص بـ شبكة Gonka اللامركزية وتدعم كلاً من تنسيق OpenAI (مزود "OpenAI Compatible") وتنسيق Anthropic (endpoint /v1/messages) — يتصل Roo Code عبر أي منهما. هذا يحول Roo Code من عرض تجريبي مكلف إلى أداة عمل يومية.

الخطوة 1: تثبيت Roo Code والحصول على المفتاح

تثبيت Roo Code: في VS Code افتح Extensions (Ctrl/Cmd+Shift+X)، ابحث عن "Roo Code" واضغط على Install. بعد التثبيت، ستظهر أيقونة الكنغر الخاصة بـ Roo Code في الشريط الجانبي. لا يزال الامتداد موجوداً في Marketplace، لكن إصداره الأخير 3.54.0 الصادر في 15 مايو 2026 سيظل الأخير.

مفتاح API لـ JoinGonka: إذا لم يكن لديك مفتاح بعد، قم بالتسجيل في gate.joingonka.ai/register، واحصل على 3M توكن مجاني وأنشئ مفتاحاً ببادئة jg- في لوحة التحكم (Dashboard).

الخطوة 2: تكوين Roo Code (متوافق مع OpenAI)

أسهل طريقة هي الإعداد بأمر واحد عبر المثبّت. بالنسبة لأدوات CLI/الملفات، سيقوم بكتابة مزوّد JoinGonka تلقائيًا (baseUrl، النماذج)، وبالنسبة لأدوات الواجهة سيعرض القيم الجاهزة للصق:

npx @joingonka/setup --tool roo

سيذكّرك الأمر أولًا بإغلاق Roo Code ويخبرك إلى أين تتوجه (--tool zoo، --tool cline، --tool kilo)، ثم يطبع القيم لمن لا يزال لديه الإضافة مثبّتة — مع نافذة السياق الفعلية وسقف استجابة النموذج. سيسألك المثبّت عن مفتاح jg-… وسينتهي بفحص مباشر عبر طلب إلى gateway. فيما يلي الطريقة اليدوية إن كنت تفضّل الإعداد بنفسك.

الإعداد اليدوي (الخطة البديلة)

افتح لوحة Roo Code واذهب إلى الإعدادات (أيقونة الترس). في قسم المزوّد، حدّد:

  1. API Provider — اختر OpenAI Compatible.
  2. Base URL — https://gate.joingonka.ai/v1
  3. API Key — jg-your-key
  4. Model (Model ID) — MiniMaxAI/MiniMax-M2.7

بالأسفل، في كتلة Model Configuration، يمكنك ضبط معاملات النموذج يدويًا:

  • Context Window — 180000 (180K توكن؛ أما DeepSeek V4 Flash فـ 380000).
  • Max Output Tokens — 8192 لـ MiniMax M2.7 وGLM-5.3 Flash، و32768 لـ DeepSeek V4 Flash.
  • Input Price / Output Price — يمكنك إدخال الأسعار الفعلية (≈$0.0062 لكل 1M توكن إدخال، والإخراج ×3) لتحسب Roo Code تكلفة المهام بدقة داخل الواجهة.

مهم بشأن tool calling: تستخدم Roo Code فقط native tool calling — لا يوجد بديل XML كما في الوكلاء القديمة. لذلك يجب أن يدعم النموذج function calling. نماذج الشبكة عبر Gateway لدينا تدعم native tool calling — وRoo Code يعمل معها مباشرة.

الاختبار: في محادثة Roo Code اكتب «أنشئ ملف hello.py بدالة تطبع Hello World». سيقترح الوكيل إنشاء الملف ويعرض الفرق للموافقة.

مقارنة تكلفة جلسات الوكيل

Roo Code هو أداة وكيل (agent tool): فهو لا يجيب برسالة واحدة، بل ينفذ مهمة — يقرأ الملفات، يكتب الكود، يشغل الاختبارات، ويصحح الأخطاء. كل إجراء هو استدعاء للنموذج. دعونا نقارن تكلفة الجلسات النموذجية:

المهمةالرموز (Tokens)Anthropic ClaudeOpenAI GPTJoinGonka Gonka
إصلاح خطأ بسيط~5M$15 — $75$12 — $50$0.048
ميزة جديدة (2-3 ملفات)~20M$60 — $300$50 — $200$0.19
إعادة هيكلة الوحدة~50M$150 — $750$125 — $500$0.48
جلسة تطوير كاملة (4 ساعات)~100M$300 — $1,500$250 — $1,000$0.96

مع JoinGonka Gateway، يصبح Roo Code أداة يومية — يمكنك تشغيله لكل تذكرة، ولكل خطأ، ولكل ميزة، دون القلق بشأن الفاتورة. 3M رمز مجاني في البداية تتيح لك تجربة الحزمة بدون بطاقة ائتمان.

معلمات النماذج: MiniMax M2.7 — نافذة 180K وما يصل إلى 8192 رمز استجابة، DeepSeek V4 Flash — 380K وما يصل إلى 32768، GLM-5.3 Flash — 390K وما يصل إلى 8192. إذا لم يتم تحديد max_tokens لطلب non-stream، ستعيد البوابة افتراضياً ما يصل إلى 1500 رمز (في GLM-5.3 Flash — ما يصل إلى 3000). يقوم Roo Code تلقائياً بتقسيم التوليدات الطويلة إلى خطوات.

ما يميز Roo Code عن Cline: الأوضاع وتنسيق Anthropic

Roo Code هو fork من Cline، لكنه يحمل اختلافات ملحوظة تغيّر سير العمل:

  • الأوضاع (Modes): بدّل دور الوكيل حسب المهمة — Architect للتخطيط، وCode لكتابة الشيفرة، وAsk لأسئلة المشروع، وDebug لتتبّع الأخطاء. يمكنك إنشاء أوضاع خاصة بتعليمات ومجموعة أدوات مسموح بها.
  • native tool calling فقط: بخلاف الوكلاء الذين يعتمدون على تحليل النص/XML، يرسل Roo Code الأدوات وفق مخطط tools الأصلي من OpenAI ويستقبل الاستدعاءات كأحداث منفصلة — زمن استجابة أقل ونتائج أكثر موثوقية. الوجه الآخر: يجب أن يدعم النموذج function calling (نماذج الشبكة عبر Gateway لدينا تدعم ذلك).
  • تعليمات وملفات تعريف مخصّصة: قواعد لكل مشروع (مثلًا عبر ملف قواعد في المستودع) وعدة إعدادات مزوّد محفوظة يمكن التبديل بينها بسهولة.

الاتصال عبر صيغة Anthropic. إن أردت استخدام endpoint /v1/messages لدينا بدل صيغة OpenAI: في الإعدادات اختر API Provider → Anthropic، وفعّل «Use custom base URL» وأدخل https://gate.joingonka.ai، ثم الصق المفتاح نفسه jg-your-key في حقل Anthropic API Key، ثم حدّد اسم النموذج (مثل MiniMaxAI/MiniMax-M2.7). المفتاح والرصيد مشتركان بين الصيغتين، وtool_use الأصلي في وضع Anthropic يمر أيضًا عبر Gateway.

Roo Code + Gonka = وكيل ذكاء اصطناعي مستقل في VS Code مع أوضاع متعددة واستدعاء أدوات أصلي بتكلفة زهيدة. جلسة التطوير تكلف $0.10 بدلاً من $300-1,500 كما في Anthropic، والتوكنات الترحيبية تتيح لك التجربة بدون بطاقة. تم إغلاق الامتداد في 15 مايو 2026: للتثبيتات الجديدة، استخدم Zoo Code — النسخة المجتمعية — أو Kilo Code أو Cline.

تريد معرفة المزيد؟

استكشف الأقسام الأخرى أو ابدأ في كسب GNK الآن.

احصل على توكنز مجانية →