بدّل نماذج دردشة GitHub Copilot فورياً باستعمال 9Router Model Connector

شنو هو 9Router Model Connector؟

كيجمع 9Router Model Connector بين Visual Studio Code وGitHub Copilot Chat مع بوابة 9Router للذكاء الاصطناعي. الميزة الرئيسية ديالو هي تبديل النماذج بلا إعادة التحميل: من بعد الإعداد الأولي، تقدر تفعّل نموذج ذكاء اصطناعي آخر بكليك وحدة، بلا ما تبدّل ملفات JSON، ولا تعاود تشغّل VS Code، ولا تسالي جلسة الدردشة الحالية.

المشروع كيدعم النماذج اللي كيدوزو عبر أكثر من 40 مزوّد ديال الذكاء الاصطناعي، من بينهم OpenAI وAnthropic وGoogle Gemini وDeepSeek وGroq وOpenRouter. ومن الأمثلة اللي مذكورة فالمشروع Claude 3.5 Sonnet وGPT-4o وGemini 1.5 Pro وDeepSeek V3 وR1 وLlama 3.

الميزات الرئيسية

• التبديل بلا إعادة التحميل: بدّل النموذج النشيط فالحين، مع بقاء VS Code وجلسة الدردشة الحالية محلولين.
• لوحة تحكم على الويب: تصفّح المزوّدين المتاحين وصَفّيهم، ومن بعد فعّل النموذج بصرياً.
• التكامل مع شريط الحالة ديال VS Code: اختار نموذج بلا ما تخرج من المحرّر.
• مقارنة النماذج وقياس الأداء: جرّب المطالبات جنباً إلى جنب وقارن سرعة الاستجابة.
• وكيل محلي ديناميكي: كيدخل النموذج النشيط أوتوماتيكياً، وكيطبّق ترويسات المصادقة، وكيحوّل استجابات البث عبر Server-Sent Events.
• توافق واسع مع المزوّدين: كيربط مع المزوّدين المتاحين عبر بوابة 9Router.

كيفاش كيخدم الربط

كيستعمل التكامل ثلاثة خدمات أو نقاط نهاية محلية:

• 20128: البوابة الأساسية وموزّع الحمل ديال 9Router.
• 20129: الوكيل المحلي ديال الإضافة، واللي كيدخل النموذج النشيط حالياً فالطلبات.
• 5500: لوحة تحكم الويب المستعملة لاختيار النماذج ومقارنتها.

مني كتختار نموذج من لوحة التحكم ولا من شريط الحالة، الوكيل كيسجّلو كنموذج نشيط. GitHub Copilot Chat كيبعث طلب الإكمال التالي للوكيل المحلي باستعمال الإدخال الثابت 9Router via Proxy. الوكيل كيعاود يكتب بيانات الطلب باش يضمّن النموذج النشيط، وكيضيف مفتاح API المطلوب، وكيحوّل الطلب للبوابة الأساسية ديال 9Router.

9Router كيوجّه الطلب لمزوّد الذكاء الاصطناعي المناسب. الاستجابة كترجع عبر البوابة والوكيل على شكل تدفّق ديال رموز SSE، وهادشي كيخلي Copilot Chat يعرض الجواب فالحين.

خاصك غير تختار 9Router via Proxy مرة وحدة فـ Copilot Chat. من بعد، تبديل النماذج كيدوز من طبقة الوكيل.

التثبيت

الخيار 1: الإعداد الأوتوماتيكي فـ Windows

حلّ Command Prompt ولا أي طرفية فمجلد المشروع وشغّل سكريبت الإعداد:

scripts\setup.bat

وتقدر حتى تستعمل أمر إعداد npm:

npm run setup

الخيار 2: الإعداد الأوتوماتيكي فـ Linux ولا macOS

خلّي سكريبت shell قابل للتنفيذ وشغّلو:

chmod +x scripts/setup.sh
./scripts/setup.sh

الخيار 3: التثبيت اليدوي

أولاً، ثبّت البوابة الأساسية ديال 9Router بشكل عام:

npm install -g 9router

نسخ مستودع connector ودخل للمجلد ديالو:

git clone https://github.com/yudaprasetya007/routeVSCODE.git
cd routeVSCODE

ثبّت إضافة VS Code المجهّزة. المستودع فيه الإصدار 2.5.0 داخل مجلد releases:

code --install-extension releases/routevscode.model-connector-2.5.0.vsix --force

شغّل لوحة تحكم الويب:

npm start

منين تولّي خدامة، حلّ http://localhost:5500 فالمتصفّح ديالك.

الإعداد الأولي

1. شغّل بوابة 9Router

شغّل 9Router فطرفية مخصّصة:

9router

حلّ http://localhost:20128/dashboard وخذ مفتاح API ديال 9Router. خلّي هاد الطرفية خدامة طول المدة اللي كتستعمل فيها connector.

2. شغّل لوحة تحكم Connector

فالمستودع اللي نسختيه، شغّل:

npm start

خاص لوحة تحكم connector تولّي متاحة فـ http://localhost:5500.

3. إعداد مفتاح API والرابط الأساسي

1. حلّ Command Palette ديال VS Code باستعمال Ctrl+Shift+P. فـ macOS، استعمل Cmd+Shift+P.
2. اختار 9Router: Set API Key & Base URL.
3. دخل http://localhost:20128/v1 كرابط أساسي.
4. لسّق مفتاح API اللي خديتي من لوحة تحكم 9Router.

4. اختار الوكيل فـ Copilot Chat

1. حلّ GitHub Copilot Chat باستعمال Ctrl+Alt+I.
2. حلّ أداة اختيار النموذج فأسفل واجهة الدردشة.
3. اختار 9Router via Proxy.

هاد الاختيار ديال نموذج Copilot كيتدار غير مرة وحدة. خلّي Copilot مضبوط على هاد الإدخال ديال الوكيل ملي كتبدّل بين النماذج عبر 9Router.

الاستعمال الأساسي

بدّل نموذج من لوحة تحكم الويب

1. تأكّد بلي العملية 9router ولوحة تحكم connector خدامين بجوج.
2. حلّ http://localhost:5500.
3. قلّب على النموذج اللي بغيتي تستعمل وفعّلو.
4. صيفط مطالبة جديدة فـ Copilot Chat.

الوكيل المحلي كيدخل النموذج اللي تختار حديثاً فالطلب التالي. ما كايناش حاجة تعاود تحميل VS Code.

بدّل نموذج من شريط الحالة ديال VS Code

كليك على مؤشّر نموذج 9Router فشريط الحالة اللي فالجهة اليمنى لتحت. اختار نموذج من اللائحة، ومن بعد كمّل تستعمل Copilot Chat بشكل عادي.

بدّل عبر Command Palette

حلّ Command Palette وشغّل:

9Router: Pilih Model AI

هاد الشي كيفتح لائحة اختيار سريعة باش تختار موديل الذكاء الاصطناعي النشِط.

أوامر مفيدة فـ VS Code

• 9Router: Pilih Model AI: كيفتح أداة الاختيار السريع ديال الموديل.
• 9Router: Status & Info: كيعرض حالة الاتصال، البورت ديال البروكسي، والموديل النشِط.
• 9Router: Set API Key & Base URL: كيحدّث نقطة النهاية والبيانات ديال الولوج لـ 9Router.
• 9Router: Sync Semua Model ke Copilot: كيعاود يكتب إدخالات 9Router فـ chatLanguageModels.json.
• 9Router: Buka Dashboard Web: كيفتح لوحة التحكم المحلية فـ المتصفح.
• 9Router: Tambah Model Manual: كيسجّل معرّف موديل مخصّص يدوياً.
• 9Router: Hapus Semua Entry 9Router: كيحيد إدخالات بروكسي 9Router من إعدادات VS Code.

نصائح متقدمة

قارن بين الموديلات قبل ما تختار

استعمل خاصية المقارنة المباشرة واختبار الأداء ديال الموديلات فلوحة التحكم باش تصيفط المطالبات وتقارن الأجوبة حدّ بحد. قياسات زمن الاستجابة تقدر تعاونك تختار بين الموديلات ملي كتكون السرعة مهمة.

زيد معرّف موديل مخصّص

إلى كان الموديل اللي محتاج مازال ما مضافش فاللائحة، حلّ Command Palette وشغّل 9Router: Tambah Model Manual. دخل معرّف الموديل اللي كيتسناه مزوّد 9Router اللي مكوّن عندك. التوفّر كيبقى مرتبط بالمزوّدين والموديلات اللي يمكن الولوج ليها عبر بوابة 9Router ديالك.

تأكّد من الاتصال النشِط

قبل ما تشخّص Copilot بوحدو، شغّل 9Router: Status & Info. راقب الموديل النشِط، حالة الاتصال، والبورت المحلي ديال البروكسي. هاد الشي كيساعد يفرّق بين مشكل فالبروكسي ومشكل فالبوابة ولا عند المزوّد.

خلي اختيار البروكسي مستقر

ما تبقاش تختار موديلات فردية من المزوّد مباشرة من منتقي الموديلات ديال Copilot. خلي 9Router via Proxy مختار وبدّل الموديل ديال المزوّد من لوحة التحكم، شريط الحالة، ولا أمر الاختيار السريع. بهاد الطريقة كيبقى سير العمل بلا إعادة تحميل.

شغّل الخدمات فـ ترمينالات منفصلة

خلي 9router خدام فـ ترمينال واحد وnpm start فـ ترمينال آخر. هاد الشي كيسهّل تفقد سجلات الخدمات وكيمنع توقف بوابة الخدمة الأساسية بالخطأ ملي كتعاود تشغّل لوحة التحكم.

حلّ المشاكل

البورت 20129 مستعمل من قبل

البروكسي الديناميكي ديال الإضافة كيستعمل البورت 20129. سدّ نسخ VS Code القديمة ولا وقف أي عملية أخرى شادة داك البورت، ومن بعد عاود شغّل الموصل.

موديل البروكسي ما باينش

من بعد ما تثبّت الإضافة لأول مرة، حلّ Command Palette وشغّل Developer: Reload Window. من بعد رجع لمنتقي موديلات Copilot Chat وقلّب على 9Router via Proxy.

9Router ما كيردّش

تأكّد باللي 9router مازال خدام فـ ترمينال منفصل. وتحقّق حتى باللي عنوان الأساس هو http://localhost:20128/v1 وأن مفتاح API المكوّن جا من لوحة تحكم 9Router المحلية.

عاود ضبط الإعدادات ولا زامنها

استعمل 9Router: Sync Semua Model ke Copilot ملي خاص إعداد الموديلات يتعاود يتولّد. إلا بغيتي تصفير نقي، شغّل 9Router: Hapus Semua Entry 9Router وعاود كوّن الموصل.

للمزيد من التشخيص، راجع وثائق حلّ المشاكل ديال المستودع. المشروع كيوفّر حتى أدلة منفصلة ديال البنية والإعداد.

الخلاصة

كيحط 9Router Model Connector بروكسي ديناميكي بين GitHub Copilot Chat وبوابة 9Router، وكيخلي اختيار الموديل مستقل على الإعداد الثابت ديال Copilot. منين كتكوّن مفتاح API، عنوان الأساس، وإدخال 9Router via Proxy، تقدر تبدّل بين الموديلات المدعومة من لوحة التحكم ولا من شريط الحالة ديال VS Code بلا ما تعاود تحميل المحرّر. المشروع موزّع برخصة MIT.