Cherry Studio + JoinGonka Gateway — عميل ذكاء اصطناعي مكتبي

Cherry Studio — عميل ذكاء اصطناعي مكتبي مفتوح المصدر لـ Windows و macOS و Linux: محادثة مع مساعدين، مقارنة ردود نماذج متعددة، وكلاء، قاعدة معرفية، ترجمة وربط خوادم MCP. يتم توزيع المشروع بموجب ترخيص AGPL-3.0 وقد جمع أكثر من 50 ألف نجمة على GitHub (سبتمبر 2026). المبدأ الرئيسي للعميل هو مفاتيحك الخاصة: أنت تقرر من خلال أي مزودين يتم الاستنتاج (Inference)، ويوفر التطبيق واجهة موحدة فوقهم.

بالإضافة إلى قائمة المزودين الجاهزة، يوجد في Cherry Studio خيار Custom Provider — مزود خاص بعنوان عشوائي. من خلاله يتم توصيل JoinGonka Gateway: واجهة برمجة تطبيقات متوافقة مع OpenAI لنماذج شبكة Gonka اللامركزية مع الدفع بالرموز وفقاً لأسعار الشبكة المباشرة. بعد التسجيل وتأكيد العنوان، سيصل إلى حسابك 3M من الرموز المجانية — يمكنك تجربة العميل بهدوء قبل أول شحن للرصيد.

الدليل يحتوي على إعداد خطوة بخطوة للخط الحالي V2 مع ملاحظات لـ V1، شرح لحقل API Host مع قاعدته حول رمز #، اختيار النموذج، التحقق والأخطاء الشائعة. تم تقديم تسميات الواجهة وفقاً للنسخة الإنجليزية من التطبيق.

التثبيت، الإصدار والمفتاح

التثبيت. توجد حزم لجميع الأنظمة على صفحة إصدارات المشروع: مثبت وحزمة محمولة لـ Windows، ملف dmg لـ macOS، AppImage، deb و rpm لـ Linux — لـ x64 و ARM. يتم تخزين تاريخ المحادثات والإعدادات محلياً على جهازك.

V1 أو V2. في أغسطس 2026 صدر الخط V2 بهيكل بيانات جديد وإعدادات معاد تصميمها؛ آخر إصدار للخط السابق هو 1.9.13. المزود الخاص موجود في كلاهما، ويختلفان في شكل الإضافة وجزء من التسميات — تم تحديد هذه الأماكن أدناه. عند الانتقال من V1، يتم نقل إعدادات المزودين والنموذج تلقائياً، يتم حفظ البيانات الأصلية لـ V1، ولكن لا تتم مزامنة البيانات الجديدة للخلف، والنسخ الاحتياطية للخطين غير متوافقة. قبل التحديث، اقرأ قسم الترحيل في وثائق Cherry Studio.

مفتاح JoinGonka. سجل في البوابة، افتح في المكتب قسم "API-keys" واضغط على "Create Key". يبدأ المفتاح بـ jg- ويظهر مرة واحدة — احفظه على الفور. من المريح إنشاء مفتاح منفصل لـ Cherry Studio: في قسم "Usage" سيظهر استهلاكه في سطر منفصل.

الاتصال: مزود خاص وحقل API Host

اضغط على أيقونة الترس — ستُفتح الإعدادات. اختر قسم Model Provider (المسمّى Model Services في التوثيق الإنجليزي).
أسفل قائمة المزوّدين، اضغط Add Provider.
في V2 ستُفتح نافذة Add Custom Provider. اكتب Provider Name — مثلًا JoinGonka. في قسم Endpoint settings املأ سطر OpenAI بالعنوان https://gate.joingonka.ai/v1: سيظهر أسفل الحقل سطر Request path بالمسار النهائي — ويجب أن ينتهي بـ /v1/chat/completions. في حقل API Key الصق jg-your-key ثم اضغط Add.
في V1 النافذة أقصر: اسم المزوّد وProvider Type — اختر OpenAI. أما المفتاح والعنوان فيُدخلان في صفحة المزوّد نفسه، في حقلي API Key وAPI Host.
تأكد من أن المزوّد مُفعَّل: المفتاح في الزاوية العلوية اليمنى من صفحته. في V2 يُضاف المزوّدون الجدد وهم معطّلون، ولا تظهر نماذج المزوّد المعطّل في قوائم الاختيار.

كيف يبني Cherry Studio العنوان. يقبل حقل API Host العنوان الأساسي، بينما يضيف التطبيق المسار بنفسه ويعرض النتيجة في سطر Preview أسفل الحقل. القواعد واحدة في كلا الإصدارين:

ما تم إدخاله	إلى أين يذهب الطلب	ملاحظة
`https://gate.joingonka.ai/v1`	`https://gate.joingonka.ai/v1/chat/completions`	الخيار الموصى به: الإصدار موجود في العنوان، ويُضاف المسار فقط
`https://gate.joingonka.ai`	العنوان نفسه	لا يوجد إصدار في العنوان — سيضيف Cherry Studio `/v1` بنفسه
`https://gate.joingonka.ai/v1/`	العنوان نفسه	الشرطة المائلة في النهاية تُهمَل ببساطة
`https://gate.joingonka.ai/v1/chat/completions#`	العنوان كما هو، بدون `#`	الرمز `#` في النهاية يعطّل الإضافة التلقائية للإصدار والمسار. بالنسبة للبوابة هذه الحيلة زائدة — فهي تلزم للخدمات ذات المسار غير القياسي
`https://gate.joingonka.ai#`	`https://gate.joingonka.ai/chat/completions`	لم يُضف الإصدار، والطلب يمر خارج API — وسترد البوابة بـ `405`

في الإرشادات القديمة توجد قاعدة أخرى: الشرطة المائلة في نهاية العنوان يُفترض أنها تعطّل /v1. وقد كانت سارية في الإصدارات المبكرة حتى الإصدار 1.6 ضمنًا، وأُزيلت في 1.7: في البنيات الحالية لا يعطّل الإضافة التلقائية سوى #.

النماذج: القائمة، الأنواع، والنموذج الافتراضي

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

القائمة من الخادم. في صفحة المزود، انقر على Sync models (في V1 — Manage، ثم Fetch model list). سيطلب Cherry Studio من البوابة GET /v1/models ويعرض التكوين الحي للشبكة؛ أضف النماذج المطلوبة باستخدام زر +. يدوياً. يفتح زر Add Model نموذجاً حيث يكون حقل واحد إلزامياً — Model ID: يتم إدخال المعرف رمزاً برمز.

سعر النماذج في الشبكة واحد، لذا أضفها جميعاً — سيكون عليك الاختيار بينها بناءً على السلوك وليس الميزانية:

النموذج	Model ID	السياق والاستجابة	متى تستخدمه في Cherry Studio
DeepSeek V4 Flash	`deepseek-ai/DeepSeek-V4-Flash-0731`	380K، استجابة حتى 32768 رمزاً	نموذج المساعد الرئيسي: مستندات طويلة، إدراجات برمجية كبيرة، إجابات مفصلة وترجمات — أكبر سقف للاستجابة في الشبكة
MiniMax M2.7	`MiniMaxAI/MiniMax-M2.7`	200K، استجابة حتى 8192 رمزاً	الأسئلة اليومية السريعة، مسودات الرسائل، التصحيحات النصية القصيرة؛ مناسب كنموذج خدمة
GLM-5.3 Flash	`zai-org/GLM-5.3-Flash`	390K، استجابة حتى 8192 رمزاً	نموذج Reasoning: يفكر قبل الإجابة. حل المهام المعقدة، التخطيط، التحقق من المنطق؛ تصل الإجابة متأخرة ويذهب جزء من حد الاستجابة للتفكير

أنواع النماذج. يحتوي كل نموذج في القائمة على زر إعدادات يتم فيه تحديد قدراته: Vision, Reasoning, Tool وغيرها. يضع Cherry Studio بعض العلامات تلقائياً، ولكن بالنسبة لنماذج البوابة، يجب التحقق منها. يجب إلغاء تحديد Vision: نماذج الشبكة نصية. Tool ضروري إذا كنت تقوم بتوصيل أدوات MCP — جميع النماذج من الجدول تدعم استدعاء الأدوات الأصلي. Reasoning مناسب لـ GLM-5.3 Flash — هذا هو نموذج الاستنتاج في الشبكة.

النموذج الافتراضي. في قسم الإعدادات Default Model يتم تعيين النماذج للأدوار الخدمية. اجعل DeepSeek V4 Flash النموذج الرئيسي للمساعد. بالنسبة للنموذج السريع الذي يبتكر عناوين للمحادثات ويجهز استعلامات البحث، تنصح وثائق Cherry Studio بنموذج خفيف وسريع، وليس نموذج reasoning — من بين نماذج الشبكة، يعد MiniMax M2.7 الأنسب لهذا الدور، ولا تضع GLM-5.3 Flash بتفكيرها الإلزامي هنا. للترجمة، أي من النموذجين الأولين سيكون مناسباً.

الفحص والتشخيص

في صفحة الموفر، توجد في كتلة المفتاح زر Model Check (في V1 يسمى Check بجوار حقل المفتاح). اختر نموذجاً — سيقوم Cherry Studio بإرسال طلب تجريبي قصير إليه ويعرض النتيجة مع تأخير الاستجابة. إذا نجح الاختبار، انتقل إلى المحادثة، واختر نموذج البوابة في محدد النماذج، واطرح أي سؤال.

للتأكد من أن الطلبات تمر بالفعل عبر البوابة، افتح لوحة التحكم الخاصة بها، قسم «الاستخدام» (Usage): في كتلة «حسب المفاتيح» (By keys)، ستظهر الطلبات ووقت آخر وصول لمفتاح Cherry Studio، وفي كتلة «حسب النماذج» (By models) — النموذج المختار. في V2 توجد أيضاً إحصائيات العميل الخاصة، قسم الإعدادات Usage: الرموز (tokens) والطلبات حسب الموفرين، النماذج، والمفاتيح. التكلفة هناك استرشادية — يقوم Cherry Studio بتقديرها وفقاً للأسعار العامة للنماذج وليس حسب سعر شبكة Gonka، لذا راجع المبالغ الدقيقة في لوحة تحكم البوابة.

إذا حدث خطأ ما، فإن السبب يظهر دائماً تقريباً في الرد:

ما الذي يظهر	ماذا يعني ذلك	ماذا تفعل
`401`, `Invalid API key`	البوابة لم تتعرف على المفتاح	تأكد من أن المفتاح يبدأ بـ `jg-`، وموضوع بدون مسافات، ونشط في قسم «API-keys»
`404`, `Invalid URL (POST …)`	يوجد جزء زائد في المسار. حالة نموذجية — تم إدخال المسار الكامل في API Host بدون `#`، وقام Cherry Studio بإضافة `/chat/completions` مرة ثانية	اترك العنوان الأساسي `https://gate.joingonka.ai/v1` فقط في الحقل وتحقق من سطر Preview
`405 Not Allowed` أو HTML بدلاً من الرد	الطلب خرج خارج API: العنوان ينتهي بـ `#`، ولكن `/v1` مفقود	احذف `#` أو أضف `/v1`
`429`	النموذج محمل فوق طاقته: في أوقات الذروة، قد تُستهلك سعة نموذج معين في الشبكة بالكامل	أعد المحاولة بعد بضع ثوانٍ أو انتقل إلى نموذج مجاور؛ حالة الشبكة تظهر على صفحة الحالة
الاختبار ينجح ولكن النموذج غير موجود في المحادثة	الموفر متوقف أو لم تتم إضافة النموذج إلى قائمته	قم بتفعيل الموفر وأضف النموذج عبر Sync models أو Add Model
تم إدخال المفتاح، والمحادثة لا تستجيب	المساعد يعمل على النموذج الافتراضي من موفر آخر غير مضبوط	حدد نموذج البوابة في قسم Default Model
بالنسبة لـ GLM-5.3 Flash، الرد فارغ أو ينقطع	حد الرد في إعدادات المساعد صغير جداً: الاستدلالات تدخل ضمن نفس الحد	أزل قيد Max tokens أو اضبطه بهامش — من 2000 رمز فما فوق
النموذج يرد بأنه لا يرى الصورة	نماذج الشبكة نصية: البوابة تستبدل الصورة بملاحظة نصية	أزل علامة Vision من النموذج؛ المهام التي تتضمن صوراً يجب إسنادها لموفر لديه نموذج رؤية — في Cherry Studio يمكن للموفرين العمل جنباً إلى جنب بانسجام

كم تكلف

العميل نفسه يتم توزيعه مجاناً، أنت تدفع فقط مقابل الـ inference. عبر JoinGonka Gateway تبلغ تكلفة الرموز (tokens) $0.0069 لكل مليون رمز عند الإدخال و $0.021 لكل مليون رمز عند الإخراج — السعر متطابق لجميع نماذج الشبكة ويتم جلبه في هذه الصفحة من مصدر مباشر. تستهلك المحادثة الرموز بشكل أقل بكثير من أدوات الوكلاء، لذا فإن ترتيب المبالغ حسب أسعار سبتمبر 2026 هو كالتالي:

السيناريو	الاستهلاك	عبر Gateway
حوار من عشرات الردود	10-30 ألف رمز	أجزاء من السنت
يوم عمل مكثف: أسئلة، ترجمات، تحليل وثائق	0.5-1M رمز	أقل من سنت
شهر من الاستخدام اليومي	15-30M رمز	عشرات السنتات

ملاحظة هامة حول الحوارات الطويلة: مع كل رد، يرسل العميل إلى النموذج التاريخ بأكمله من جديد، لذا فإن الرد المئة يكلف أكثر من الرد الأول. العلاج هو حوار جديد لمهمة جديدة؛ في Cherry Studio هذا زر واحد.

الطريقة	كيف تدفع	ماذا تحصل
اشتراك في خدمة الدردشة	مبلغ ثابت شهرياً	نماذج موفر واحد في واجهته، مع حدود الباقة
Cherry Studio + مفتاح الموفر	حسب الرموز وفقاً لقائمة أسعار الموفر	واجهتك وتاريخك على جهازك؛ الفاتورة تنمو مع الحجم
Cherry Studio + JoinGonka Gateway	حسب الرموز بسعر الشبكة، من رصيد البوابة	نماذج الشبكة المفتوحة بسعر موحد، الاستهلاك حسب الأيام والمفاتيح والنماذج يظهر في لوحة التحكم

ما الذي توفره هذه الربطة أيضاً

مقارنة النماذج في محادثة واحدة. يتيح لك Cherry Studio طرح سؤال واحد على عدة نماذج في آنٍ واحد: اخترها من مبدل النماذج، وسيقوم كل نموذج بالرد بطلب منفصل. مع توحيد السعر لجميع نماذج الشبكة، تعد هذه أسرع طريقة لمعرفة أين يكفي MiniMax M2.7 في مهامك، وأين تحتاج إلى إجابة طويلة من DeepSeek V4 Flash، وأين تثبت جدوى استنتاجات GLM-5.3 Flash — تم تحليل إعداداتها في مراجعة النموذج.

البروتوكول الثاني بنفس المفتاح. يستجيب البوابة (gateway) أيضاً بتنسيق Anthropic. في محادثة V2، يوجد سطر Anthropic منفصل في كتلة Endpoint settings: أدخل فيه https://gate.joingonka.ai، ويجب أن يكون المسار في سطر Request path هو /v1/messages. في V1، يتم الحصول على نفس النتيجة من خلال مزود منفصل بنوع Provider Type هو Anthropic ونفس العنوان. تحت زر More options في V2 يوجد أيضاً سطر OpenAI Responses — تدعمه البوابة أيضاً، وهو نفس عنوان سطر OpenAI الرئيسي.

تشغيل وكلاء الطرفية (terminal agents). في صفحة Code CLI (المشار إليها في الوثائق بـ Coding Companion)، يقوم Cherry Studio بتثبيت وتشغيل وكلاء الكونسول، مع تزويدهم بالمزود والنموذج من إعداداته؛ يتم تصفية قائمة المزودين هناك وفقاً للبروتوكول الذي تتطلبه الأداة المحددة. لذلك، يُفضل ملء عنوان Anthropic مسبقاً إذا كنت تنوي تشغيل Claude Code من هنا. كيفية إعداد نفس الوكيل بدون وسطاء مشروحة في دليل Claude Code + Gonka.

قاعدة المعرفة. في V2، تعمل حتى بدون نموذج تضمين (embedding model) — باستخدام البحث النصي BM25، ومع نموذج التضمين يتم تفعيل البحث الهجين (hybrid search). نماذج شبكة Gonka هي نماذج توليدية، لذا بالنسبة للوضع الهجين، استخدم نموذج تضمين من مزود آخر، على سبيل المثال محلياً عبر Ollama؛ سيقوم نموذج البوابة بالرد بناءً على الأجزاء التي تم العثور عليها.

هل تحتاج إلى محادثة مشتركة للفريق في المتصفح؟ Cherry Studio هو تطبيق سطح مكتب شخصي. للحصول على واجهة ويب مشتركة مع حسابات، ألقِ نظرة على Open WebUI: فهو يتصل بالبوابة بنفس العنوان والمفتاح.

يتصل Cherry Studio بـ JoinGonka Gateway كمزود خاص: Settings → Model Provider → Add Provider، العنوان https://gate.joingonka.ai/v1 والمفتاح jg-. يقوم التطبيق بإضافة المسار /chat/completions تلقائياً ويعرض النتيجة في سطر Preview؛ رمز # في نهاية العنوان يعطل التعبئة التلقائية ولا تحتاجه البوابة. بعد ذلك — قم بتفعيل المزود، وأضف النماذج عبر Sync models، وقم بإلغاء تحديد Vision الخاص بها وتحقق من الاتصال باستخدام زر Model Check. اختر DeepSeek V4 Flash كنموذج رئيسي، وMiniMax M2.7 كنموذج خدمي، وGLM-5.3 Flash لمهام المنطق؛ يمكن التحقق من الاستهلاك في حساب البوابة، قسم "الاستخدام".

← Trae + JoinGonka Gateway — نماذج شبكة Gonka في AI-IDE omp (Oh My Pi) + JoinGonka Gateway: وكيل بأدوار النماذج →

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

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

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