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

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

كيف يعمل

عند تنفيذ الاستيلاء بنقرة واحدة على أي أداة، تنفّذ البوابة الخطوات التالية بالترتيب:

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

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

حالة الاستيلاء

تظهر لكل أداة واحدة من أربع حالات في صفحة بوابة الذكاء الاصطناعي ← إدارة الوصول ← العميل:

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

المتطلبات المسبقة

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

عملية الاستيلاء بنقرة واحدة

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

تفاصيل الاستيلاء لكل أداة

يسرد الجدول التالي ملفات التكوين والمحتوى الذي يُعدَّل فعليًا عند الاستيلاء على كل أداة، لمساعدتك على الفهم والتشخيص:

الأداة	ملف التكوين	المحتوى المكتوب	عنوان البوابة
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
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 الاحتياطية.
• س: أين يوجد المفتاح الافتراضي المستخدم في الاستيلاء؟
  • ج: تُنشئ البوابة مفتاحًا افتراضيًا مخصصًا تلقائيًا لكل أداة تم الاستيلاء عليها، ويمكنك عرضه وإدارته من صفحة المفاتيح.
• س: تظهر الأداة في القائمة كـ "لم يتم الاكتشاف"؟
  • ج: هذا يعني أنه لم يُعثر على دليل تكوين الأداة على الجهاز. ثبّت الأداة وشغّلها مرة واحدة لتوليد دليل التكوين، ثم قم بالاستيلاء.

الخلاصة

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