Skip to content

اختيار النموذج والتخصيص: 14 نموذجًا مدمجًا ومفتاح API وOllama ​

حدّدنا طريقة التنفيذ في الدرس السابق، وهذه الصفحة تحل مسألة «أي نموذج نُرسل للمهمة». المهمة نفسها، سواء أرسلتها للنمط السريع أو الأقصى، أو استخدمت DeepSeek المدمج أو Ollama المحلي، قد تختلف في السرعة والجودة وفاتورة النقاط اختلافًا كبيرًا. نماذج WorkBuddy تنقسم إلى طبقتين: المدمجة وعددها 14 تعمل فورًا وتُحتسب بالمضاعف؛ والنماذج المخصصة تربطها بنفسك — مفتاح API أو باقة Tencent Cloud أو Ollama محلي، وكلها لا تستهلك نقاط WorkBuddy. في 12 دقيقة، افهم أمرين دفعة واحدة: «اختيار النموذج» و«ربط النموذج».

هذا هو الدرس رقم 5 من «الاستخدام اليومي»، مبني على WorkBuddy v5.9.3، وتستند العمليات إلى وثيقة «إعداد النماذج» الرسمية ووثيقة «اختيار النموذج» في التطبيق / التطبيق المصغّر.

ماذا ستستطيع أن تفعل بعد التعلم ​

  • التمييز بين طبقتي نماذج WorkBuddy: 14 نموذجًا مدمجًا يعمل فورًا، ونماذج مخصصة تُربط حسب الحاجة
  • التبديل بين أنماط السريع / المتوازن / الأقصى في أداة اختيار النموذج، واختيار النموذج المدمج المناسب للمهمة (بالنظر إلى وسوم القدرات والمضاعف ومستوى الانشغال)
  • ربط نماذج مخصصة عبر إعداد مسبق للمزوّد + مفتاح API، أو Ollama محلي، وإدارة المفاتيح المحفوظة محليًا في models.json
  • شرح كيف تؤثر شدة التفكير ونافذة السياق والوضع الاقتصادي على استهلاك النقاط
  • عند ظهور خطأ 4100 أو ظهور النموذج باللون الرمادي، تصلحه بنفسك

مشكلتك الحالية ​

  • المهمة ليست صعبة، لكنك تستخدم النموذج نفسه دائمًا، حتى الأسئلة البسيطة تحرق不少 نقاط
  • تريد استخدام باقة النماذج التي اشترتها شركتك مركزيًا، أو تريد أن يبقى المحتوى كليًا على جهازك، ولا تعرف إن كان WorkBuddy يدعم ذلك
  • أضفت نموذجًا مخصصًا بنفسك، فظهر النموذج باللون الرمادي ولا يمكن اختياره، وظهر خطأ 4100 في المحادثة

متى تستخدم هذه الطريقة ​

عندما تحتاج إلى:

  • مطابقة نماذج مختلفة لمهام مختلفة — التنقيح البسيط يحتاج سرعة وتوفيرًا، والتحليل المعقد يحتاج استقرارًا
  • ربط خدمات نماذج خارجية: مفتاح API، وTencent Cloud Token Plan، وCoding Plan
  • إبقاء الشيفرة والمحادثات على جهازك (Ollama محلي)، بحيث تعمل في الشبكات الداخلية والبيئات دون اتصال

ولا تريد أن:

  • تعديل ملفات الإعداد يدويًا والبحث في كومة من المعاملات لاستخدام نموذج معين
  • تسليم مفتاح API إلى سحابة لا تثق بها

🎒 التحضير قبل البدء ​

  • أن تكون قد أكملت 2.0 الاستخدام اليومي: اجعل WorkBuddy رفيقك في العمل، ويُفضّل أن تكون درست أيضًا 2.4 ثلاثة أنماط تنفيذ
  • أن يكون WorkBuddy مثبّتًا على حاسوبك ومسجّلًا للدخول، وأن تستطيع إنشاء مهام والعثور على شريط الإدخال
  • (اختياري) لربط نموذج مخصص: جهّز مفتاح API الذي زوّدك به مزوّد الخدمة؛ ولربط Ollama: يكون Ollama مثبّتًا ومشغّلًا على جهازك
  • 12 دقيقة وقت قراءة

💡 هل يكلف نقاطًا؟

النماذج المدمجة تُحتسب بالنقاط، ولكل نموذج مضاعف مختلف (x0.06~x1.62)؛ أما النماذج المخصصة فلا تستهلك نقاط WorkBuddy — كل التكاليف الناتجة (الرموز Tokens، والاشتراكات، إلخ) تدفعها أنت مباشرة إلى الطرف الثالث (وفق الرواية الرسمية). لتفاصيل قواعد النقاط راجع 2.6 النقاط والأسعار.

الفكرة الأساسية ​

النموذج الذهني: نموذج WorkBuddy = أداة اختيار في المحادثة + صفحة إعداد في الإعدادات.

الطبقةما هيكيفية الاستخدام
النماذج المدمجة14 نموذجًا جاهز الربط رسميًا (Hunyuan وGLM وKimi وMiniMax وDeepSeek)تختارها مباشرة في أداة اختيار النموذج وتُحتسب بمضاعف النقاط
نموذج مخصصنموذج خارجي / محلي قمت بتوصيله بنفسكيُهيَّأ في صفحة الإعدادات ضمن «النماذج»؛ تُدفع الرسوم للطرف الخارجي ولا يستهلك نقاط WorkBuddy

يوجد في المحدد أيضًا ثلاث درجات من الوضع (سريع / متوازن / أقصى)، وهي تحدد أي درجة من قدرة النماذج تُرسَل للعمل. توصية الجهة الرسمية صريحة: إذا لم تكن متأكدًا من الدرجة التي تختارها، استخدم المتوازن.

ثلاثة «أوضاع» يسهل الخلط بينها، فلنميّزها دفعة واحدة:

التسميةما الذي يديرهأين يوجد
وضع التنفيذ (Agent / Plan / Ask)كيفيةدفع المهمةيسار مربع الإدخال + القائمة (الدرس السابق)
وضع النموذج (سريع / متوازن / أقصى)أيدرجة من النماذج تُرسَللوحة اختيار النموذج (هذا الدرس)
شدة التفكير / نافذة السياقالنموذج الواحدكم يفكر بعمق وكم يتذكرإعداد معاملات النموذج (هذا الدرس)

الخط الأحمر الأمني (الرواية الرسمية): تُحفظ معاملات إعداد النموذج المخصص (بما فيها مفتاح API) محليًا فقط في ~/.codebuddy/models.json ولا تُرفع إلى السحابة؛ وعند الاستخدام يعمل WorkBuddy كقناة اتصال فقط، يمرر مدخلاتك مباشرة إلى النموذج الذي قمت بإعداده، ويُرجَع الناتج من ذلك النموذج مباشرة.

اتبعني خطوة بخطوة ​

الخطوة 1: افتح محدد النماذج في WorkBuddy واختر درجة من الوضع (سريع / متوازن / أقصى) ​

لماذا: تختلف متطلبات المهام المختلفة من قدرة النموذج كثيرًا — اختر الدرجة أولًا ثم انتقِ النموذج المحدد، فلا تهدر نقاطًا بلا داعٍ.

الخطوات:

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

يجب أن ترى: بعد فتح اللوحة ترى درجات الوضع الثلاث وقائمة النماذج؛ وبعد تبديل الوضع تُنفَّذ المحادثات اللاحقة وفق الدرجة الجديدة.

  • فتحتُ لوحة اختيار النموذج ورأيت الدرجات الثلاث: سريع / متوازن / أقصى

الخطوة 2: اختر نموذجًا مدمجًا حسب المهمة (وسوم القدرة، المعامل، ودرجة الانشغال) ​

لماذا: لكل من 14 نموذجًا مدمجًا ما يبرع فيه، وأدنى مضاعف x0.06 وأعلاه x1.62 — الاختيار الصحيح يوفر المال ويُنجز العمل.

الخطوات:

  • انظر إلى وسوم القدرة: «استدلال» = يدعم الاستدلال المنطقي وتخطيط المهام والتنفيذ متعدد الخطوات؛ «رؤية» = يدعم فهم الصور (اختر هذا النوع لسيناريوهات التصوير ولقطات الشاشة)
  • انظر إلى معامل النقاط: كلما انخفض الرقم قلّ الاستهلاك، ويُوضَع تحت اسم النموذج (المعاملات المرجعية الواردة في وثائق التطبيق المصغّر الرسمية في الجدول أدناه؛ وفي نسخة سطح المكتب يُعتمد على ما تعرضه اللوحة فعليًا)
  • انظر إلى درجة الانشغال: مرّر الفأرة فوق نموذج معين، فستعرض بطاقة المعلومات «درجة الانشغال»

قائمة 14 نموذجًا مدمجًا (وثائق سطح المكتب الرسمية، v5.9.3):

النموذجنبذةالوظائف المتاحة
Hy4 previewنموذج هونيون من الجيل الجديدإدخال الصور، وضع التفكير
Hy3نموذج تفكير من هونيون بقدرات استدلال معززةإدخال الصور، وضع التفكير
GLM-5.3GLM نموذج من الجيل الجديد، يدعم نافذة سياق 1Mإدخال الصور، وضع التفكير
GLM-5.3-FlashGLM نسخة سريعة من نموذج الجيل الجديدوضع التفكير
GLM-5.2سياق 1M، بارع في المهام طويلة المدىإدخال الصور، وضع التفكير
GLM-5.1قدرات متوازنة، مناسب للاستخدام اليومينموذج استدلالي
GLM-5v-Turboنموذج متعدد الوسائط أصليإدخال الصور، نموذج استدلالي
MiniMax-M3متعدد الوسائط أصليًا، بارز في الكود ومهام الوكلاءإدخال الصور، نموذج استدلالي
MiniMax-m2.7قدرات متوازنة، مناسب للاستخدام اليومي، بنسبة جودة إلى سعر عاليةإدخال الصور، نموذج استدلالي
Kimi-K3بارع في المهام المستقلة المعقدة طويلة المدى، بقدرات بارزة في تطوير الواجهات الأمامية، وأداء متميز في العمل المعرفي والاستدلال البحثيإدخال الصور، نموذج استدلالي
Kimi-K2.7-Codeنموذج متعدد الوسائط، محسَّن لسيناريوهات البرمجةإدخال الصور، نموذج استدلالي
Kimi-K2.6نموذج متعدد الوسائط، مناسب للمهام اليوميةإدخال الصور، نموذج استدلالي
Deepseek-V4-Flashنموذج DeepSeek الرائد، يدعم نافذة سياق 1M، يعطي الأولوية للسرعةوضع التفكير
Deepseek-V4-Proنموذج DeepSeek الرائد، يدعم نافذة سياق 1Mوضع التفكير

مرجع معاملات النقاط (وثائق التطبيق المصغّر الرسمية؛ بالنسبة للنماذج الأحدث مثل Hy4 preview وسلسلة GLM-5.3 يُعتمد على ما تعرضه اللوحة فعليًا):

النموذجمضاعف النقاط
Deepseek-V4-Flashx0.06
Deepseek-V4-Prox0.16
MiniMax-M3x0.25
Kimi-K2.6x0.52
Kimi-K2.7-Codex0.57
GLM-5.2 / GLM-5.1x0.79
GLM-5v-Turbox0.95
Kimi-K3x1.62
Hy3مجاني لفترة محدودة
Auto / MiniMax-m2.7لم يذكر التطبيق المصغّر أي مضاعف؛ اعتبر ما يظهر فعليًا في اللوحة هو المرجع

الحالات الأربع لمستوى الانشغال (رسمي):

الحالةالشرح
خامل (أخضر)الحمل طبيعي
ازدحام خفيف (برتقالي)الحمل مرتفع، وقد تصبح الاستجابة أبطأ
ازدحام شديد (أحمر)الحمل مرتفع جدًا، يُنصح بالتبديل إلى نموذج آخر
غير متاحخدمة النموذج معطلة، وغير متاحة مؤقتًا

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

نصيحة رسمية لتوفير المال (وثائق التطبيق): للمهام اليومية البسيطة اختر نموذج استدلاليًا عالي القيمة مقابل التكلفة، وبدّل إلى نموذج «الرؤية» عند الحاجة إلى فهم الصور؛ وإذا لم تكن متأكدًا أيها تختار، فاستخدم الافتراضي Auto (اختيار تلقائي ذكي)، وسيطابق النظام النموذج الأمثل تلقائيًا.

💡 تريد استخدام DeepSeek؟ إنه مدمج بالفعل

لا حاجة للبحث عن مفتاح API بنفسك — Deepseek-V4-Flash (x0.06) وDeepseek-V4-Pro (x0.16) في القائمة المدمجة جاهزان للاستخدام فورًا، الأول يعطي الأولوية للسرعة، وكلاهما يدعم نافذة سياق 1M. لتوصيل واجهات DeepSeek أخرى، استخدم النماذج المخصصة أدناه.

💡 مستخدمو النسخة المؤسسية: لا يمكنك اختيار نموذج؟

النماذج التي يعطّلها مسؤول المؤسسة في الخلفية تُخفى أو تُرمّد تلقائيًا في منتقي النماذج بالعميل (بما فيها auto). إذا وجدت نموذجًا لا يمكن اختياره، فتأكد أولًا لدى مسؤول المؤسسة من حالة تمكين هذا النموذج.

ينبغي أن ترى: عند تمرير المؤشر فوق نموذج تظهر بطاقة معلومات تعرض مستوى الانشغال؛ وتحت اسم النموذج يوجد تمييز للمضاعف.

  • أستطيع بناءً على «وسم القدرة + المضاعف» اختيار نموذج مدمج لمهمة معينة

الخطوة 3: ضبط شدة التفكير ونافذة السياق حسب الحاجة ​

لماذا: هذان المعاملان يحددان «مدى عمق تفكير النموذج ومدى طول ذاكرته»، ويحددان أيضًا مباشرة استهلاك النقاط في كل جولة — القيم الافتراضية تناسب الغالبية العظمى من المهام، فافهمهما قبل تغييرهما.

شدة التفكير (الصياغة الرسمية):

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

نافذة السياق (الصياغة الرسمية):

  • كل جولة حوار ترسل السياق الحالي كاملًا إلى النموذج — كلما كبرت النافذة، زاد استهلاك النقاط في الجولة الواحدة
  • تذكير رسمي: النافذة الأكبر ليست دائمًا أفضل — النافذة الأكبر لا تجعل النموذج أذكى، بل تجعل استهلاك كل جولة يتضاعف
  • النماذج متعددة المستويات: انقر حلقة استخدام السياق في مربع الإدخال، وبدّل المستوى أسفل لوحة «استخدام السياق» (مثل افتراضي / متوسط / فائق الطول)
  • القواعد: تمرير المؤشر فوق مستوى يعرض شرحه؛ التبديل يُحفظ فورًا؛ أثناء جريان الحوار يسري المستوى الجديد بدءًا من الجولة التالية؛ المستوى يسري فقط للمهمة الحالية، وبعد تبديل النموذج أو إنشاء مهمة جديدة يعود إلى المستوى الافتراضي لذلك النموذج
  • النماذج ذات مستوى واحد لا توفر مدخلًا للتبديل
  • نصيحة: أبقِ المستوى الافتراضي، فهو كافٍ للغالبية العظمى من السيناريوهات؛ لا تكبّره إلا عند معالجة مستندات طويلة جدًا تحتاج أن يتذكر النموذج قدرًا كبيرًا من المحتوى التاريخي كاملًا

الوضع الاقتصادي (تعرّف عليه بالمناسبة):

  • مفتاح «وضع Max» في لوحة اختيار النموذج الأصلية نُقل الآن إلى الإعدادات → الوكيل الذكي → الوضع الاقتصادي (مفعّل افتراضيًا في النسخة الشخصية)
  • عند التفعيل: يضغط النظام السياق تلقائيًا في الأوقات المناسبة، مما يقلل المحتوى المكرر في الحوارات الطويلة ويخفض استهلاك النقاط
  • عند التعطيل: يُحتفظ بالسياق الكامل دون أي ضغط طوال الوقت، فلا تفقد التفاصيل، لكن استهلاك النقاط في الحوارات الطويلة يزيد بشكل ملحوظ
  • نصيحة: أبقه مفعّلًا؛ ترقية الإصدار لن تتجاوز اختيارك الحالي

ينبغي أن ترى: انقر حلقة استخدام السياق في مربع الإدخال فتظهر لوحة «استخدام السياق»، وفي أسفلها تبديل للمستويات.

  • وجدت حلقة استخدام السياق، وأعرف أن المستوى يسري فقط للمهمة الحالية ويعود إلى الافتراضي بعد تبديل النموذج

الخطوة 4: إضافة نموذج مخصص: إعداد مسبق للمزوّد + مفتاح API ​

لماذا: لاستخدام نماذج خارج القائمة المدمجة (مثل حزمة اشترتها شركتك بشكل موحد)، لا حاجة للمس ملفات الإعداد — بضع نقرات في الواجهة الرسومية لصفحة الإعدادات تكفي، وبنص الوثائق الرسمية «لا حاجة لتحرير ملفات الإعداد يدويًا».

الخطوات:

  1. افتح قسم «النماذج» في صفحة الإعدادات (يوجد أيضًا في منتقي النماذج بواجهة الحوار مدخل سريع للانتقال إلى واجهة الإعداد)
  2. أضف نموذجًا، باختياره من قائمة المزوّدين: ستُملأ تلقائيًا URL وقائمة النماذج ووسوم القدرات (استدعاء الأدوات، إدخال الصور، وضع الاستدلال وغيرها)، ويكفي إكمال مفتاح API لحفظه واستخدامه
  3. اختر طريقة الربط حسب الخدمة المتوفرة لديك:
طريقة الربطلمنما يجب إكماله
Tencent Cloud Token Planلمن اشترى Tencent Cloud Token Plan (مصممة خصيصًا لسيناريوهات برمجة الذكاء الاصطناعي وWorkBuddy، ومتوافقة مع Hunyuan وMiniMax وKimi وGLM وغيرها من النماذج الكبيرة السائدة)اختر أولًا نوع الحزمة (احترافية مؤسسية / خفيفة مؤسسية / شخصية عامة / Hy شخصية)، ثم أدخل مفتاح API لتلك الحزمة، وأخيرًا اختر النماذج التي تدعمها الحزمة (النماذج المتاحة تختلف بين الحزم)
Coding Planلمن اشترى اشتراكًا مخصصًا لـ AI Coding (يدعم Coding Plan من Tencent Cloud وZhipu وKimi)بيانات الاعتماد والنماذج للحزمة المقابلة
واجهة API مخصصةاستخدام واجهات برمجة التطبيقات لمزودين رئيسيين آخرين (مداخل جاهزة مدمجة للمزودين الرئيسيين، اتصال بنقرة واحدة)مفتاح API
مخصص / Customالخدمة غير موجودة في أي قائمة جاهزةأدخل يدويًا عنوان URL ومفتاح API واسم النموذج
  1. احفظ. يتم حفظ التهيئة تلقائيًا بشكل دائم؛ عند اختيار مزود قياسي، تُكتب تلقائيًا علامات القدرات مثل استدعاء الأدوات وإدخال الصور دون الحاجة إلى تهيئة يدوية

تنبيهات أمنية (النقاط الرئيسية من كلام المسؤول):

  • لا تشارك مفتاح API مع الآخرين——فهو مرتبط بحسابك وحصة باقتك، وقد يؤدي تسريبه إلى استغلال الآخرين لحصتك أو تكبد رسوم إضافية أو مخاطر تتعلق بأمن البيانات
  • تأكد من موثوقية المزود——قبل الاتصال، اقرأ اتفاقية الخدمة وسياسة الخصوصية لمزود النموذج، وتأكد من توافقهما مع متطلباتك بشأن أمن البيانات والامتثال

💡 أين تُحفظ التهيئة؟ وهل تُرفع إلى السحابة؟

تُحفظ معلمات التهيئة (بما فيها مفتاح API) محليًا فقط في ~/.codebuddy/models.json،ولا تُرفع إلى السحابة. النماذج التي تمت تهيئتها يدويًا عبر هذا الملف في المراحل المبكرة تظل قابلة للاستخدام بعد ترقية الواجهة، ويمكن عرضها وتعديلها وحذفها من الواجهة—فلا حاجة للتعامل مع ملف التهيئة في الإدارة اليومية. عند التوقف عن استخدام نموذج ما، توصي الجهة الرسمية بحذف مفتاحه من models.json.

يجب أن ترى: بعد الحفظ، تظهر مجموعة النماذج المخصصة في منتقي النماذج بواجهة المحادثة (معروضة باسم النموذج وأيقونة المزود)، وتختارها لتبدأ الاستخدام.

  • أضفت نموذجًا مخصصًا ورأيته في المجموعة المخصصة بالمنتقي

الخطوة 5: توصيل نموذج محلي عبر Ollama (بدون الحاجة إلى مفتاح API) ​

لماذا: محتوى حساس لا تريد أن يغادر جهازك، أو بيئة شبكة داخلية بلا إنترنت، أو مجرد رغبة في تجربة بلا تكلفة—Ollama المحلي يحل الأمور الثلاثة دفعة واحدة.

ما هو Ollama (وفق الجهة الرسمية): أداة مفتوحة المصدر لتشغيل النماذج الكبيرة محليًا؛ بعد التثبيت يمكن سحب وتشغيل النماذج مفتوحة المصدر بأمر واحد؛ وبعد التشغيل يستمع إلى منفذ HTTP محلي (الافتراضي 11434)، ويوفر تلقائيًا واجهة متوافقة مع بروتوكول OpenAI ليتصل بها WorkBuddy.

الفئات الثلاث لسيناريوهات الاستخدام المدرجة رسميًا:

السيناريوالفائدة
خصوصية البيانات / الامتثال في الشبكات الداخليةلا يغادر الكود ومحتوى المحادثات جهازك، مناسب للقطاع المالي والجهات الحكومية والمشاريع الحساسة
تجربة بلا تكلفةدون استهلاك Token ودون مفتاح API مدفوع، استخدم العتاد كقوة حوسبة
يعمل دون اتصاليعمل WorkBuddy على متن الطائرة، أو أجهزة التطوير في الشبكات الداخلية، أو البيئات بلا إنترنت

الخطوات:

  1. ثبّت Ollama وشغّله، واسحب نموذجًا مفتوح المصدر (اتبع تعليمات Ollama الرسمية في خطوات التثبيت وسحب النماذج)، وأبقِ الخدمة المحلية قيد التشغيل
  2. WorkBuddy الإعدادات → النماذج → إضافة، واختر Ollama من قائمة المزودين—يُملأ عنوان الواجهة تلقائيًا (يستمع Ollama افتراضيًا إلى المنفذ المحلي 11434)
  3. أدخل الاسم الدقيق للنموذج المثبت واحفظ
  4. لا حاجة لإدخال مفتاح API—صرّحت الجهة الرسمية بأن «النماذج التي تشير إلى هذا الجهاز (مثل Ollama المحلي) لا تحتاج إلى مفتاح API»

⚠️ النموذج المحلي ≠ بقاء المهمة بأكملها دون اتصال بالشبكة

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

يجب أن ترى: يظهر النموذج المحلي الذي هيأته في المجموعة المخصصة بمنتقي النماذج؛ وبعد إرسال رسالة يرد النموذج المحلي، ويرتفع استخدام موارد جهازك بوضوح (العتاد هو قوة الحوسبة لديك).

  • ظهر نموذجي المحلي في المنتقي ولم يُطلب مني إدخال مفتاح API طوال العملية

الخطوة 6: استكشاف الأخطاء 4100: ماذا تفعل إذا ظل النموذج المخصص رماديًا / لم يُرسل الطلب ​

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

الأعراض (رمز الخطأ الرسمي 4100):

  • في منتقي النماذج: النموذج رمادي ولا يمكن اختياره، مع أيقونة استثناء (مثلًا كُتب اسم النموذج بأداة طرف ثالث دون اكتمال التهيئة)
  • تلميح عند التحويم: «النموذج المخصص الحالي لم تُهيأ له واجهة عنوان أو مفتاح API، يرجى الانتقال إلى التهيئة قبل الاستخدام»
  • إذا أُرسل الطلب رغم ذلك: يظهر في المحادثة المحتوى نفسه مع مدخل «الانتقال إلى التهيئة»،رمز الخطأ 4100، ولا يُرسل الطلب

طريقة الإصلاح (ثلاث خطوات):

  1. انقر على «الانتقال إلى التهيئة» في التلميح (موجود في بطاقة التحويم أو تلميح المحادثة)، ليُفتح مباشرةً صفحة تهيئة ذلك النموذج
  2. أكمل عنوان الواجهة و مفتاح API واحفظ
  3. تم—وفق الجهة الرسمية «بعد الإكمال والحفظ يمكن اختياره بشكل طبيعي» و«بعد الإكمال والحفظ يعود النموذج متاحًا دون الحاجة إلى إعادة التشغيل»

الاستثناء: النماذج التي تشير إلى هذا الجهاز (مثل Ollama المحلي) لا تحتاج إلى مفتاح API ولا تخضع لهذا القيد.

رموز الأخطاء الأخرى (3002 اتصال الشبكة، 3008 النموذج بلا استجابة، 6003 إلخ) انظر «شرح معالجة رموز الأخطاء» الرسمي وصفحة هذا الموقع مرجع استكشاف الأخطاء السريع: رموز الأخطاء والأسئلة المتكررة.

يجب أن ترى: بعد الإكمال والحفظ، يتحول النموذج من الرمادي إلى قابل للاختيار؛ وعند إرسال رسالة أخرى، يُرسل الطلب بشكل طبيعي.

  • أعرف أن 4100 = النموذج المخصص ينقصه عنوان الواجهة أو مفتاح API، وبعد الإكمال لا حاجة لإعادة التشغيل

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

نقاط التحقق ✅ ​

  • أستطيع التبديل بين المستويات الثلاثة سريع / متوازن / أقصى في لوحة اختيار النماذج، وذكر نوع المهام المناسب لكل منها
  • أستطيع ذكر الغرض من وسم «الرؤية»، وإيجاد توضيح مضاعف النقاط للنموذج (x0.06~x1.62)
  • أعرف أن نافذة السياق الأكبر تعني استهلاكًا أكبر في الجولة الواحدة، وأن المستوى يسري على المهمة الحالية فقط، وأنه يُنصح بإبقاء الوضع الاقتصادي مفعّلًا
  • أضفت نموذجًا مخصصًا (Token Plan / Coding Plan / واجهة API مخصصة / Ollama أيًا كان)، وأعرف أن التهيئة تُحفظ محليًا فقط في models.json ولا تُرفع إلى السحابة
  • عند مواجهة 4100 أنقر على «الانتقال إلى التهيئة» للإكمال بدلًا من الظن أن البرنامج معطل

تنبيهات من الأخطاء الشائعة ​

❌ دفع نافذة السياق إلى الحد الأقصى ظنًا أن الأكبر أفضل ​

العرض: ضبط مستوى السياق على الحد الأقصى دون تغير في جودة المهمة، مع نفاد النقاط بسرعة كبيرة.

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

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

❌ مشاركة مفتاح API كنص عادي أو رفعه إلى مستودع عام ​

العرض: نشر لقطة شاشة للتهيئة مع المفتاح في مجموعة، أو رفع models.json إلى مستودع أكواد، فيُستنزف الحصة من قبل الآخرين.

السبب: مفتاح API مرتبط بحسابك وحصة باقتك. تنبيه الجهة الرسمية الأمني: قد يؤدي التسريب إلى استغلال الآخرين لحصتك أو تكبد رسوم إضافية أو مخاطر تتعلق بأمن البيانات.

الطريقة الصحيحة: أدخل المفتاح فقط في التهيئة المحلية لـ WorkBuddy (ملف models.json لا يُرفع إلى السحابة)؛ لا تدخله أو تصدره في بيئات مشتركة؛ وعند التوقف عن الاستخدام احذفه من models.json.

❌ إرسال رسائل رغم بقاء النموذج المخصص رماديًا ظنًا أن البرنامج معطل ​

العرض: اختيار نموذج مخصص رمادي وإرسال رسالة، فتظهر المحادثة 4100، ويكون رد الفعل الأول هو إعادة التثبيت.

السبب: لم تُهيأ لهذا النموذج واجهة عنوان أو مفتاح API—WorkBuddy لا يرسل الطلب مباشرةً، وهذا آلية حماية وليس عطلًا.

الطريقة الصحيحة: انقر على «الانتقال إلى الإعدادات» في التنبيه، وأكمل عنوان الواجهة و API Key، ثم احفظ فقط، دون الحاجة إلى إعادة التشغيل. النماذج المحلية في Ollama لا تحتاج إلى Key ولا تتأثر بذلك.

❌ الاعتقاد بأن «ربط نموذج محلي = عمل دون اتصال طوال الوقت وعدم خروج البيانات من الشبكة إطلاقًا» ​

الظاهرة: بعد ربط Ollama لأغراض الامتثال، تشعر بالاطمئنان وتترك WorkBuddy يقوم بكل الأعمال.

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

الطريقة الصحيحة: في السيناريوهات الحساسة للامتثال، تحقق أولًا مما إذا كانت المهمة ستصل إلى الشبكة (مثلًا لا تجعله يبحث في الإنترنت عن معلومات ضمن مهام النموذج المحلي)؛ وللاطلاع على حدود الأمان بالتفصيل راجع 5.4 أمن البيانات والخصوصية.

نصائح متقدمة (اختياري) ​

🔧 البروتوكول المخصص: لا تتعامل معه إلا عندما تمر الواجهة عبر بوابة / وكيل. عندما تستخدم خدمة النموذج مسار URL غير قياسي (مغلّف عبر بوابة أو طبقة وكيل)، فعّل مفتاح «البروتوكول المخصص» في الإعدادات المتقدمة: مغلق (افتراضي) = استخدام مسار /chat/completions القياسي مع التحقق التلقائي وإكمال عنوان الواجهة؛ مفعّل = إرسال الطلب مباشرة وفق URL الذي أدخلته، مع تخطي التحقق من المسار والإكمال التلقائي. يُنصح عمومًا بإبقائه مغلقًا، إلا إذا طلب مزود الخدمة ذلك صراحةً.

🔧 كيفية عرض النماذج على الهاتف. يمكن لتطبيق الهاتف المحمول عرض قائمة النماذج وعلامات القدرات والمضاعفات، كما يمكنه تعديل شدة التفكير (مثل منخفض / متوسط / مرتفع / فائق) ونافذة السياق (مثل 300K / 1M) — والمدخل موجود في مدخل الإعدادات أعلى يمين لوحة اختيار النموذج. لكن لا توفر نسخة الهاتف المحمول مدخلًا لـ «تهيئة نموذج مخصص»، وقائمة النماذج تعرض النماذج المتاحة فقط؛ ويظهر اختيار النموذج في نسخة التطبيق المصغّر بعد إرسال الجملة الأولى من المهمة.

🔧 هل تستخدم النسخة الدولية workbuddy.ai؟ مدخل الإعدادات ومسار الملفات مختلفان: الصورة الرمزية → إعدادات النظام → النماذج، وملف الإعدادات موجود في ~/.workbuddy-ai/models.json، وعنوان واجهة Ollama الافتراضي موثّق رسميًا بأنه http://localhost:11434/v1/chat/completions. للاطلاع على فروقات النسخة الدولية راجع 5.5 النسخة الدولية workbuddy.ai: الفروق عن النسخة الصينية وطريقة الربط.

خلاصة هذا الدرس ​

✅ طبقتان من النماذج: WorkBuddy تنقسم النماذج إلى 14 نموذجًا مدمجًا (Hunyuan / GLM / Kimi / MiniMax / DeepSeek) ونماذج مخصصة — المدمجة جاهزة للاستخدام فورًا وتستهلك النقاط حسب المضاعف؛ والمخصصة تربطها بنفسك ولا تستهلك نقاط WorkBuddy، وتدفع الرسوم لطرف ثالث.

✅ ثلاثة مستويات للأنماط: سريع (المهام البسيطة، الأسرع والأوفر) / متوازن (معظم المهام، اختره عند عدم التأكد) / أقصى (المهام المعقدة، أكثر استقرارًا وأعلى تكلفة).

✅ اختيار نموذج مدمج: انظر إلى علامات القدرات (استدلال / رؤية) + مضاعف النقاط (x0.06~x1.62، وكلما انخفض كان أوفر) + درجة الانشغال (أخضر / برتقالي / أحمر / غير متوفر)؛ عند عدم التأكد استخدم Auto الافتراضي وسيطابق النظام تلقائيًا.

✅ معاملان: أبقِ شدة التفكير على الوضع الافتراضي؛ كلما كبرت نافذة السياق ارتفعت تكلفة الجولة الواحدة، والمستوى يسري على المهمة الحالية فقط؛ أبقِ الوضع الاقتصادي (الإعدادات → الوكيل الذكي) مفعّلًا لتوفير النقاط.

✅ الربط المخصص: الإعدادات المسبقة للمزودين (Tencent Cloud Token Plan / Coding Plan / API مخصص) تحتاج فقط إلى إكمال API Key؛ وOllama المحلي لا يحتاج إلى Key (المنفذ الافتراضي 11434)؛ وإذا لم يكن ضمن الإعدادات المسبقة فاختر Custom وأدخل البيانات يدويًا. تُحفظ الإعدادات محليًا في ~/.codebuddy/models.json فقط ولا تُرفع إلى السحابة.

✅ 4100: عند نقص عنوان الواجهة أو API Key في النموذج المخصص → انقر «الانتقال إلى الإعدادات» وأكمل البيانات واحفظ، ليستأنف العمل فورًا دون إعادة تشغيل.

مراجعة الإعدادات الرئيسية:

عنصر الإعدادالقيمة الموصى بهاالشرح
نمط النموذجمتوازنمعظم المهام؛ يمكن التبديل إلى سريع للمهام البسيطة وإلى أقصى للمهام المعقدة
النموذج المدمجAuto، أو الاختيار حسب المضاعف + العلاماتاستخدم نموذج استدلال منخفض المضاعف للمهام البسيطة، واختر علامة «رؤية» لفهم الصور
شدة التفكيرالافتراضياختار المسؤولون رسميًا الشدة المناسبة لمعظم المهام
نافذة السياقالمستوى الافتراضيكلما كبرت ارتفعت تكلفة الجلسة الواحدة؛ كبّرها للمستندات الطويلة جدًا فقط، والمستوى يسري على المهمة الحالية فقط
الوضع الاقتصاديمفعّلالإعدادات → الوكيل الذكي → الوضع الاقتصادي؛ يضغط السياق تلقائيًا ويوفر النقاط في المحادثات الطويلة
النموذج المخصصالإعدادات المسبقة للمزود أولًايُملأ URL وعلامات القدرات تلقائيًا، ويكفي إدخال API Key
Ollama المحلياختر Ollama كمزوديُملأ العنوان تلقائيًا (يستمع افتراضيًا إلى المنفذ 11434)، دون الحاجة إلى API Key

الأسئلة الشائعة ​

WorkBuddy كيف أتصل بواجهة برمجة تطبيقات خارجية؟ ​

افتح قسم «النماذج» في صفحة الإعدادات، وعند إضافة نموذج اختر «واجهة API مخصصة» من قائمة مزودي الخدمة — فهناك مداخل جاهزة للمزودين الرئيسيين للاتصال بنقرة واحدة، حيث يتم ملء عنوان URL وقائمة النماذج وعلامات القدرات تلقائيًا، ولا تحتاج سوى إلى إكمال مفتاح API لحفظه واستخدامه. إذا لم تكن الخدمة موجودة في أي قائمة جاهزة، فاختر «مخصص / Custom» وأدخل عنوان URL ومفتاح API واسم النموذج يدويًا. يتم حفظ الإعدادات محليًا فقط في ~/.codebuddy/models.json ولا تُرفع إلى السحابة.

WorkBuddy ما هي خطوات الاتصال بواجهة API؟ ​

أربع خطوات إجمالًا: افتح قسم «النماذج» في صفحة الإعدادات؛ أضف نموذجًا واختر من قائمة المزودين (Token Plan من Tencent Cloud، أو Coding Plan، أو واجهة API مخصصة، أو Ollama وغيرها)؛ أكمل المعلومات وفقًا للطريقة المختارة (في الطرق الجاهزة عادةً يكمل مفتاح API فقط، أما Token Plan فيتطلب أولًا اختيار نوع الباقة ثم اختيار النماذج المدعومة)؛ بعد الحفظ تُخزَّن الإعدادات تلقائيًا بشكل دائم، ويمكنك رؤيتها في مجموعة النماذج المخصصة داخل أداة اختيار النماذج. لا تتطلب العملية بأكملها تحرير ملف الإعدادات يدويًا.

WorkBuddy كيف أضبط نموذجًا مخصصًا؟ ​

أضفه من الإعدادات ← النماذج: عند اختيار مزود جاهز يتم ملء عنوان الواجهة وعلامات القدرات تلقائيًا، وتحتاج فقط إلى إكمال مفتاح API؛ أما Ollama المحلي فلا يحتاج إلى مفتاح API، وبعد اختيار Ollama كمزود يتم ملء عنوان الواجهة تلقائيًا (يستمع افتراضيًا إلى المنفذ المحلي 11434)، ثم أدخل الاسم الدقيق للنموذج المثبَّت واحفظ. لاحظ أن تطبيق الهاتف لا يوفر مدخل «ضبط نموذج مخصص»، ويجب إتمام الضبط على إصدار سطح المكتب. وعند التوقف عن استخدام نموذج معين، توصي الجهة الرسمية بتنظيف مفتاحه من models.json.

WorkBuddy كيف أختار نموذجًا؟ ​

اختر أولًا أحد مستويات الوضع الثلاثة في لوحة اختيار النماذج: «سريع» للمهام البسيطة، «متوازن» لمعظم المهام، «أقصى أداء» للمهام المعقدة — وتوصي الجهة الرسمية باستخدام «متوازن» عند عدم اليقين بالمستوى المناسب. ثم اختر نموذجًا مدمجًا محددًا وفقًا لعلامات القدرات ومضاعف النقاط (x0.06~x1.62، فكلما انخفض وفَّرت أكثر) ومستوى الانشغال؛ وإذا لم تكن متأكدًا من الاختيار، فاستخدم خيار Auto الافتراضي (الاختيار الذكي التلقائي)، وسيطابق النظام أفضل نموذج تلقائيًا.

WorkBuddy هل تدعم واجهات API؟ ​

نعم. هناك 14 نموذجًا مدمجًا يعمل فور التشغيل؛ والنماذج خارج القائمة المدمجة تُوصل عبر واجهات API لجهات خارجية من قسم «النماذج» في صفحة الإعدادات (مفتاح API، أو Token Plan من Tencent Cloud، أو Coding Plan)، أو عبر Ollama المحلي لتوصيل النماذج مفتوحة المصدر. النماذج المخصصة لا تستهلك نقاط WorkBuddy، وتُدفع الرسوم الناتجة عنها مباشرةً منك إلى الطرف الثالث.

استعراض الدرس التالي ​

بعد أن تعرفت على النماذج والمضاعفات، سنتعلم في الدرس التالي حساب التكاليف. ستتعلم في الدرس التالي 2.6 النقاط والأسعار: الحصة المجانية وباقات المستويات الأربعة ونصائح التوفير.

ستتعلم:

  • النسخة التجريبية توفر 500 نقطة أساسية شهريًا، وكم تمنح كل باقة من الباقات الأربع المدفوعة
  • تُمنح النقاط شهريًا ولا تُرحّل بعد انتهاء صلاحيتها، ويُخصم أولًا ما تنتهي صلاحيته الأقرب
  • كيفية شراء حزم الزيادة وكيفية طلب استرداد الأموال
  • ما هي نصائح التوفير في الروايات الرسمية وفي اختبارات الأطراف الثالثة

دروس ذات صلة ​

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.