الاستحواذ بنقرة واحدة على أدوات الذكاء الاصطناعي للبرمجة

تتيح لك ميزة الاستحواذ بنقرة واحدة (Takeover) توجيه أدوات البرمجة الذكية عبر سطر الأوامر (CLI) مباشرة إلى بوابة الذكاء الاصطناعي المحلية دون الحاجة إلى تعديل أي ملفات إعدادات يدويًا. بعد الاستحواذ، ستوجه جميع طلبات هذه الأدوات إلى http://127.0.0.1:11580 ليتم توجيهها إلى القنوات المزودة للخدمات التي اخترتها في البوابة، مع تسجيل موحد للاستهلاك والتكلفة.

آلية العمل

عند تنفيذ الاستحواذ بنقرة واحدة لأي أداة، ستقوم البوابة بالخطوات التالية بشكل متسلسل:

1. التحقق من سلامة البوابة، للتأكد من توفر نقطة الوكيل.
2. إنشاء مفتاح افتراضي خاص تلقائيًا (يتم عرض نص المفتاح فقط عند الإنشاء الأولى، وتتم إضافته إلى إعدادات الأداة).
3. نسخ ملف الإعدادات الأصلي احتياطيًا بامتداد .bak (مثل ~/.claude/settings.json.bak).
4. تحديث / دمج إعدادات التوجيه بدقة نحو البوابة مع الحفاظ على بقية إعداداتك كما هي.
5. تحديث واجهة الحالة لعرض وضع الاستحواذ الحالي.

وبالطريقة نفسها، عند إزالة الاستحواذ، يتم الحذف بدقة: سيتم إزالة القيم المضافة فقط إذا كانت تشير إلى البوابة، دون حذف أي إعدادات أخرى قمت بتعديلها يدويًا.

حالة الاستحواذ

ستظهر إحدى الحالات الأربع التالية لكل أداة في صفحة بوابة الذكاء الاصطناعي → نقاط النهاية (Endpoints):

الحالة	الوصف
تم الاستحواذ (بوابتنا)	الأداة تم توجيهها إلى بوابة الذكاء الاصطناعي المحلية
متصل (عنوان آخر)	تم إعداد الأداة بعنوان مختلف (تعديل يدوي أو توجيه لبوابة أخرى)، ولا يتم تغيير إعداداتها تلقائيًا
غير مستحوذ	تم اكتشاف الأداة ولكنها لم تُوجَّه بعد نحو البوابة
غير مكتشف	لم يتم العثور على إعدادات الأداة على الجهاز المحلي

المتطلبات

• تسجيل الدخول إلى حساب ServBay وتكوين قناة واحدة على الأقل في صفحة القنوات.
• تثبيت الأداة المستهدفة على الجهاز المحلي (تحدد البوابة وجود الأداة من مجلد إعداداتها).

خطوات الاستحواذ بنقرة واحدة

اذهب إلى صفحة بوابة الذكاء الاصطناعي → نقاط النهاية (Endpoints)، وابحث في قائمة الأدوات عن الأداة المستهدفة، ثم اضغط على استحواذ بنقرة واحدة. بعد نجاح العملية سيتغير وضع الأداة إلى "تم الاستحواذ (بوابتنا)". إذا أردت التراجع، اضغط على إزالة / استرجاع.

تفاصيل استحواذ الأدوات

يستعرض الجدول التالي الإعدادات الفعلية والملفات التي يتم تعديلها لكل أداة في أثناء الاستحواذ، لمساعدتك في الفهم واستكشاف المشاكل:

الأداة	ملف الإعدادات	المحتوى المضاف	عنوان البوابة
Claude Code	~/.claude/settings.json	env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN	http://127.0.0.1:11580 (بدون /v1)
Codex	~/.codex/config.toml	قسم [model_providers.servbay] + المفتاح الرئيسي model_provider = "servbay"	http://127.0.0.1:11580/v1
Gemini CLI	~/.gemini/.env	السطران GOOGLE_GEMINI_BASE_URL وGEMINI_API_KEY	http://127.0.0.1:11580
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (متوافق مع OpenAI)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	قسم [model_providers.servbay] + تعريف النماذج	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	دمج عقدة النماذج الخاصة بـ servbay بعمق	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	دمج عقدة provider.servbay (تجميع نماذج القنوات) بعمق	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	دمج عقدة providers.servbay بعمق	http://127.0.0.1:11580/v1

لماذا عنوان Claude Code لا يحتوي على /v1

Claude Code يستخدم بروتوكول Anthropic، حيث تقوم البوابة بإضافة /v1/messages تلقائيًا إلى المسار، لذا يجب أن يكون ANTHROPIC_BASE_URL هو العنوان الرئيسي للبوابة (بدون /v1). أما بقية الأدوات، فهي غالبًا تستخدم بروتوكول متوافق مع OpenAI ويجب أن ينتهي العنوان بـ /v1. ميزة الاستحواذ بنقرة واحدة تملأ هذه المعلومات تلقائيًا حسب الأداة ولن تحتاج للتفرقة يدويًا.

الاسترجاع وحل المشكلات

• استرجاع الإعدادات الأصلية — بالضغط على إزالة ستقوم البوابة مباشرة بحذف إعدادات التوجيه فقط. ويمكنك أيضًا الاسترجاع يدويًا من الملف الاحتياطي الموجود في نفس المجلد بامتداد .bak.
• ظهور الحالة "متصل (عنوان آخر)" — يعني أن الأداة موجهة حاليًا إلى عنوان آخر (تعديل منك أو بوابة أخرى). حفاظًا على إعداداتك، لن يتم الاستحواذ تلقائيًا إلا إذا قمت بحذف العنوان يدويًا أولًا.
• استمرار الأخطاء بعد الاستحواذ — تأكد من أن خدمة وكيل البوابة قيد التشغيل، وأن القناة المخصصة تعمل بشكل صحيح، وأن المفتاح الافتراضي لم يتم سحبه. يمكنك أيضًا التحقق من وصول الطلبات في صفحة الإحصاءات والمراقبة.

الأسئلة الشائعة (FAQ)

• س: هل ميزة الاستحواذ بنقرة واحدة ستضر بإعداداتي الأصلية للأداة؟
  • ج: لن تتضرر. فالميزة تكتب وتدمج إعدادات التوجيه فقط وتقوم دائمًا بإنشاء نسخة احتياطية (.bak) قبل أي تعديل. أما بقية الإعدادات فتبقى كما هي.
• س: هل يمكنني استرجاع الإعداد يدويًا بعد الاستحواذ؟
  • ج: بالتأكيد. يمكنك إما الضغط على "إزالة" من خلال البوابة، أو استرجاع الملف الاحتياطي (.bak) يدويًا.
• س: أين أجد المفتاح الافتراضي الخاص بالاستحواذ؟
  • ج: يتم إنشاء مفتاح افتراضي لكل أداة، ويمكنك إدارته وعرضه في صفحة المفاتيح.
• س: لماذا تظهر أداتي في القائمة بحالة "غير مكتشف"؟
  • ج: هذا يعني أن البوابة لم تعثر على مجلد إعدادات الأداة على جهازك. يرجى تثبيت الأداة وتشغيلها مرة واحدة على الأقل ليُنشئ دليل الإعدادات ثم إعادة المحاولة مع الاستحواذ.

الخلاصة

ميزة الاستحواذ بنقرة واحدة تحول مهمة تعديل إعدادات كل أداة يدويًا، وهي مهمة مرهقة وعرضة للأخطاء، إلى ضغطة واحدة فقط: حيث يتم إنشاء المفاتيح تلقائيًا، حفظ نسخة احتياطية، كتابة الإعدادات بدقة، مع إمكانية الاسترجاع متى رغبت. كما يمنحك توحيد قنوات الاستخدام والرصد التحكم الكامل ومتابعة التكاليف لمجمل أدوات البرمجة الذكية لديك. إذا رغبت بدمج البوابة في شيفرتك البرمجية، راجع صفحة النقاط ونظام المتغيرات.