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 پر شائع ہوئی ہے۔ مستحکم چینل (18 ستمبر 2026 کا 3.82.2) کے ساتھ ابتدائی 3.83.x بھی ہے — مرکزی برانچ کی نائٹلی بلڈز؛ کام کے لیے مستحکم ورژن لیں۔ انسٹالیشن کے بعد ایکٹیویٹی بار پر Zoo Code کا آئیکن نظر آئے گا۔

مرحلہ 2: کلید حاصل کریں۔ gate.joingonka.ai/register پر رجسٹر کریں، پتہ تصدیق کریں اور «API کیز» کے حصے میں jg- پریفکس کے ساتھ کلید بنائیں۔ 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 ٹولز کا مینو دکھائے گا۔

فارم کی ایک تفصیل: Zoo Code 3.82.2 میں Model Configuration کے عنوان والا الگ بلاک نہیں ہے۔ حدود کے فیلڈز اسی فارم میں نیچے، «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 فیلڈز کو خالی رکھیں۔

لمٹس ماڈل کے بجائے پروفائل میں محفوظ ہوتی ہیں: اگر اسی پروفائل میں Model تبدیل کیا جائے تو ونڈو اور آؤٹ پٹ کی لمٹ وہی رہتی ہے۔ اس لیے ہر ماڈل کے لیے الگ پروفائل بنانا زیادہ آسان ہے — اس بارے میں اگلا سیکشن ہے۔

Zoo Code کو Roo Code کے کوڈ بیس سے بنایا گیا ہے، لہذا مائیگریشن میں صرف چند منٹ لگتے ہیں اور پروجیکٹ کی فائلوں کو تبدیل کرنے کی ضرورت نہیں پڑتی۔ سرکاری مائیگریشن گائیڈ میں سیٹنگز ایکسپورٹ اور امپورٹ کرنے کا طریقہ بیان کیا گیا ہے؛ باقی چیزیں ایک الگ بٹن کے ذریعے منتقل کی جاتی ہیں یا پرانے پاتھ سے پڑھی جاتی ہیں:

Roo Code پروفائل جو پہلے سے JoinGonka Gateway کے ساتھ منسلک تھا، وہ ایڈریس، کی، ماڈل اور لمٹس کے ساتھ منتقل ہو جائے گا — بس یہ چیک کر لیں کہ آیا ماڈل ابھی نیٹ ورک میں موجود ہے: لسٹ GET https://gate.joingonka.ai/v1/models کمانڈ کے ذریعے حاصل کی جاتی ہے۔

موڈز اور پروفائلز۔ پانچ بلٹ ان موڈز ہیں: Code، Debug، Architect (صرف Markdown فائلز میں ترمیم کرتا ہے)، Ask (بغیر ترمیم کے جواب دیتا ہے) اور Orchestrator (دوسرے موڈز کے لیے ذیلی ٹاسک تقسیم کرتا ہے)۔ انہیں ان پٹ فیلڈ کے ساتھ والی لسٹ سے تبدیل کیا جا سکتا ہے، پیغام کے شروع میں موڈ کا نام کمانڈ کے طور پر لکھ کر، مثال کے طور پر /architect، یا Ctrl+. (macOS پر Cmd+.) شارٹ کٹ کے ذریعے۔ ہر موڈ اس پروفائل کو یاد رکھتا ہے جسے آپ نے آخری بار استعمال کیا تھا، اور موڈ تبدیل کرنے پر Zoo Code خود بخود پروفائل سوئچ کر دیتا ہے۔

یہاں سے ایک آسان اسکیما بنتا ہے: ہر ماڈل کے لیے ایک پروفائل جو مخصوص موڈز کے ساتھ منسلک ہو۔ Settings → Providers میں Configuration Profile فیلڈ کے ساتھ «+» پر کلک کریں، پروفائل کو نام دیں، مثلاً Gonka DeepSeek، اور فارم پُر کریں؛ GLM-5.3 Flash اور MiniMax M2.7 کے لیے دوبارہ کریں — سب کا ایڈریس اور کی ایک ہی ہے۔ پھر ہر موڈ میں ان پٹ فیلڈ کے ساتھ والی پروفائل لسٹ سے پروفائل منتخب کریں، موڈ اسے یاد رکھے گا۔ اس لسٹ میں موجود لاک کا آئیکن اس کے برعکس کام کرتا ہے، یہ ورکنگ فولڈر کے تمام موڈز کے لیے ایک مخصوص پروفائل کو لاک کر دیتا ہے۔

ریزننگ (Reasoning) لیول۔ فارم میں Enable Reasoning Effort کا چیک باکس Low، Medium، High، Extra High اور Max کی لسٹ کھولتا ہے؛ اگر یہ آف ہو تو لیول ریکویسٹ میں نہیں جاتا۔ GLM-5.3 Flash کا سوئچ بنیادی طور پر بائنری ہے: Low ریزننگ کو بند کر دیتا ہے، کوئی بھی دوسرا لیول اسے مکمل رکھتا ہے — تیز سوالات کے لیے الگ Low GLM پروفائل رکھنا آسان ہے۔ تفصیلات دیکھیں 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 کال کا جواب دیا: فنکشن جمع کے بجائے تفریق کر رہا ہے۔ چیکنگ کا دوسرا حصہ گیٹ وے پینل ہے: "Usage" سیکشن میں ریکوسٹ ماڈلز کے حساب سے نظر آئے گی اور کلید (key) کے آخری استعمال کا وقت اپ ڈیٹ ہو جائے گا۔

Auto-Approve کے بغیر، غلطی API Request Failed بلاک کے طور پر آتی ہے جس میں Retry اور Start New Task کے بٹن ہوتے ہیں، ساتھ ہی Provider Error ہیڈر ہوتا ہے جس میں کوڈ اور دوبارہ کوشش کرنے کا کاؤنٹ ڈاؤن ہوتا ہے۔ گیٹ وے کے جواب کا متن پیغام یا اس کی تفصیلات میں دیکھا جا سکتا ہے:

ایک ایجنٹ چیٹ کے مقابلے میں ٹوکن مختلف طریقے سے خرچ کرتا ہے۔ Zoo Code ہر ریکویسٹ میں موڈ کے قوانین، ٹولز کی تفصیل اور ورکنگ فولڈر کی معلومات کے ساتھ ایک سسٹم پرامپٹ بھیجتا ہے — آپ کے سوال سے پہلے ہی ہزاروں ٹوکن خرچ ہو جاتے ہیں — اور ٹاسک مکمل کرنے میں عام طور پر چند مراحل لگتے ہیں۔ اس لیے یہاں ہر ٹوکن کی قیمت اہم ہے۔

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 (Settings → Auto-Approve) موجود ہے: ایکسٹینشن اس کی ایگزیکیوٹیبل فائل ڈاؤن لوڈ کرتی ہے اور اس کے بعد اس کے ذریعے منظور شدہ کمانڈز خود بخود چل جاتے ہیں، جبکہ بلاک شدہ کمانڈز تصدیق کا انتظار کرتے ہیں۔ Auto-Approve کے ساتھ، Zoo Code ناکام درخواستوں کو بھی خود دوبارہ آزماتا ہے: وقفہ 5 سیکنڈ سے شروع ہوتا ہے اور ہر کوشش کے ساتھ دگنا ہوتا ہے، لیکن 10 منٹ سے زیادہ نہیں بڑھتا۔

اسٹریمنگ رسپانس۔ Enable streaming کو بند نہ کریں: اسٹریم میں گیٹ وے ٹیکسٹ جنریشن کے ساتھ ہی آؤٹ پٹ دیتا ہے اور جواب صرف ماڈل کی حد تک محدود ہوتا ہے، جبکہ بغیر اسٹریم اور واضح حد کے درخواستیں 1500 ٹوکنز پر کاٹ دی جاتی ہیں (GLM-5.3 Flash کے لیے 3000 پر)۔

کوڈ انڈیکسنگ۔ پروجیکٹ میں سیمنٹک سرچ (Codebase Indexing) ماڈل سے الگ، ایمبیڈنگ پرووائیڈر کے ذریعے ترتیب دی جاتی ہے؛ اس کے لیے ایک لوکل آپشن Semble - Local موجود ہے۔

تصاویر۔ نیٹ ورک کے ماڈلز ٹیکسٹ پر مبنی ہیں۔ اسکرین شاٹس اور ڈیزائن کے لیے، ایک الگ پروفائل بنائیں جس میں امیج پروسیسنگ والا ماڈل ہو اور ایسے کام کے وقت اس پر سوئچ کریں۔

پرائیویسی۔ Zoo Code ڈیولپرز کو انسٹالیشن آئی ڈی سے منسلک ایرر اور استعمال کا ڈیٹا بھیجتا ہے — بغیر کوڈ یا پرامپٹس کے؛ اسے Settings → About Zoo Code میں Allow error and usage reporting سوئچ کے ذریعے بند کیا جا سکتا ہے۔ گیٹ وے اپنی طرف سے پرامپٹس یا جوابات کا مواد محفوظ نہیں کرتا: ڈیش بورڈ میں صرف درخواستوں اور ٹوکنز کے کاؤنٹرز نظر آتے ہیں۔