# إعداد نموذج مخصص في WorkBuddy مع QCode

> **آخر تحقق**: 2026-11-10 · 📄 وفقًا للوثائق الرسمية (موقع الصين workbuddy.cn: أحدث إدخال في سجل التغييرات 5.11.0، 2026-11-03، ضمن طرح تدريجي؛ الموقع الدولي workbuddy.ai: أحدث إدخال في سجل التغييرات 5.9.4)

## نظرة سريعة

| البند | التفاصيل |
|---|---|
| هل يمكنني استخدام المفتاح الخاص بي؟ | نعم. على سطح المكتب، افتح النماذج في الإعدادات، واختر مخصص، وأدخل URL ومفتاح API واسم النموذج |
| النماذج التي يمكنك استخدامها | Claude ❌ (النماذج المخصصة تستخدم OpenAI Chat Completions فقط) · GPT ✅ · النماذج الصينية ✅ · Gemini ❌ |
| البروتوكول ورابط نقطة النهاية | OpenAI Chat Completions: المسار الكامل `https://api.qcode.cc/openai/v1/chat/completions` (مع إيقاف تبديل بروتوكول مخصص، يعمل `https://api.qcode.cc/openai/v1` أيضًا) |
| موقع الصين (workbuddy.cn) | صفحة النماذج في الإعدادات؛ يُحفظ الإعداد في `workbuddy/models.json`، ومتوافق مع `~/.codebuddy/models.json` |
| الموقع الدولي (workbuddy.ai) | `Avatar > System Settings > Models`؛ ملف الإعداد `~/.workbuddy-ai/models.json` |
| الهاتف المحمول | لا يوجد إدخال لنموذج مخصص |
| الوثائق الرسمية | [الصين: إعداد النموذج](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model) · [الدولي: إعداد النموذج](https://www.workbuddy.ai/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model-Configuration) |

[WorkBuddy](https://www.workbuddy.cn/) (الموقع الدولي: [workbuddy.ai](https://www.workbuddy.ai/)) هو وكيل الذكاء الاصطناعي لسطح المكتب من فريق CodeBuddy في Tencent Cloud، ومخصص للمخرجات المكتبية (ملاحظات، وجداول بيانات، وعروض تقديمية، وبرمجة خفيفة)، وليس بديلاً مباشرًا لـ [Claude Code](/docs/getting-started/installation). ويقول ملف llms.txt الرسمي الخاص به إنه يتشارك الأساس نفسه مع منتج البرمجة CodeBuddy؛ وللاطلاع على CodeBuddy راجع [النماذج المخصصة في CodeBuddy](/docs/ide/codebuddy). لربط WorkBuddy بـ QCode.cc، افتح الإعدادات → النماذج، وأضف نموذجًا مخصصًا باستخدام نقطة النهاية `https://api.qcode.cc/openai/v1/chat/completions`، ومفتاحك `cr_`، ومعرّف نموذج نشط مثل `gpt-6.1-sol`، ثم اختر النموذج وأرسل `ping`. تستخدم النماذج المخصصة في WorkBuddy بروتوكول OpenAI Chat Completions، الذي يقدّم على QCode نماذج GPT والنماذج الصينية؛ أما نماذج Claude فتُقدَّم عبر نقطة نهاية Anthropic، التي تستخدمها برامج عميلة مثل Claude Code.

تغطي هذه الصفحة مهمة واحدة: إضافة QCode.cc كنموذج **مخصص** في WorkBuddy، حتى يتمكن المفتاح `cr_` نفسه من استدعاء نماذج GPT / GLM / Kimi / DeepSeek / Qwen المتوفرة لدينا من WorkBuddy.

> **نماذج GPT والنماذج الصينية على QCode.** تستخدم النماذج المخصصة في WorkBuddy
> بروتوكول **OpenAI Chat Completions**، الذي يقدّم على QCode نماذج GPT وعائلات النماذج
> الصينية (DeepSeek / GLM / Kimi / Qwen). أما نماذج Claude فتُقدَّم عبر نقطة نهاية Anthropic
> على QCode (`https://api.qcode.cc/api`)، وهي لا تستخدمها النماذج المخصصة في WorkBuddy؛ ومعرّف
> `claude-…` على نقطة نهاية OpenAI يعيد `model_not_available_on_endpoint`. ولاستخدام Claude،
> استخدم أداة تدعم نقطة نهاية Anthropic، مثل
> [Claude Code](/docs/getting-started/installation)، أو [ZCode](/docs/ide/zcode)، أو
> [Qoder](/docs/ide/qoder). راجع
> [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths).

QCode.cc غير تابع لـ Tencent أو WorkBuddy أو CodeBuddy. تتبع تسميات واجهة المستخدم إصدار WorkBuddy الذي ثبّتته؛ وتتبع معاني الحقول إعداد النموذج الرسمي ([الصين](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model) · [الدولي](https://www.workbuddy.ai/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model-Configuration)). تقول الصفحة الدولية: «تكامل النموذج المخصص يستخدم حاليًا واجهة Chat Completions API المتوافقة مع OpenAI».
## المتطلبات الأساسية

- تثبيت WorkBuddy لسطح المكتب (النسخة الصينية [workbuddy.cn](https://www.workbuddy.cn/)، والنسخة الدولية [workbuddy.ai](https://www.workbuddy.ai/); خطوات التثبيت: دليلا [Mac](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Mac-Guide) / [Windows](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Win-Guide) الرسميان). لا يحتوي تطبيق الجوال على مدخل للنموذج المخصص؛ راجع الأسئلة الشائعة أدناه
- مفتاح API من QCode.cc (يبدأ بـ `cr_`) من [لوحة التحكم](https://qcode.cc/dashboard)
- يعمل المفتاح نفسه على البروتوكولات الثلاثة كلها. تستخدم النماذج المخصصة في WorkBuddy **OpenAI Chat Completions**، وهو ما يقابل QCode `/openai/v1/chat/completions`. قواعد البروتوكول و`BASE_URL`: [نقاط النهاية وتنسيقات API](/docs/getting-started/endpoints-and-api-paths)

## إضافة QCode في الواجهة (موصى به)

تقول صفحات النماذج الرسمية إن النماذج المخصصة تُدار عبر واجهة مرئية (إضافة، تحرير، حذف)، **دون تحرير ملف إعدادات يدويًا**. وتقول الصفحة الصينية: إذا لم تكن خدمة النموذج لديك ضمن القائمة المعدة مسبقًا، فاختر Custom وأدخل URL ومفتاح API واسم النموذج يدويًا. ويستخدم دليل WorkBuddy من Tencent Cloud TokenHub المسار نفسه.

1. النسخة الصينية: شغّل WorkBuddy → قائمة الحساب (أسفل اليسار) → **Settings** → **Model**. النسخة الدولية: `Avatar > System Settings > Models`
2. ضمن النماذج المخصصة، **Add model**
3. المزوّد: **Custom**
4. املأ الجدول أدناه، واحفظ، ثم اختر النموذج الجديد في منتقي نموذج الدردشة
5. تحتوي النسخة الدولية أيضًا على **Test Connection** («يتحقق مما إذا كان API قادرًا على الاستجابة»)؛ شغّله قبل الاعتماد على الصف. تشير الوثائق إلى أن حفظ الإعدادات لا يعني نجاح الاتصال

| الحقل | القيمة | ملاحظات |
|-------|--------|------|
| المزوّد | `Custom` | لا تختر Token Plan المدمجة من Tencent Cloud |
| URL نقطة النهاية | `https://api.qcode.cc/openai/v1/chat/completions` | بر الصين الرئيسي: يُفضَّل `https://asia.qcode.cc/openai/v1/chat/completions` |
| مفتاح API | مفتاح QCode.cc الخاص بك (بادئة `cr_`) | بدون مسافات في البداية أو النهاية |
| اسم النموذج | مثل `gpt-6.1-sol` | يجب أن يكون معرّفًا حيًا على [qcode.cc/models](https://qcode.cc/models)، حرفًا بحرف |
| إعدادات متقدمة | فعّل استدعاء الأدوات / إدخال الصور / الاستدلال حسب الحاجة | اختيارية؛ تقول الصفحة الدولية اضبطها وفق ما تدعمه الخدمة فعليًا، لا أن تفعّل الكل |

يمكنك إضافة عدة صفوف مخصصة باستخدام URL والمفتاح نفسهما، مع تغيير **Model name** فقط — مثل صفّ واحد `glm-5.3` وواحد `deepseek-v4-pro`.

### كيفية ملء URL (البروتوكول المخصص)

السلوك الرسمي لمفتاح **البروتوكول المخصص** (في الإعدادات المتقدمة):

| المفتاح | السلوك |
|--------|-----------|
| إيقاف (افتراضي) | استخدم مسار `/chat/completions` القياسي؛ وتحقق من URL وأكمله |
| تشغيل | أرسل URL **كما كُتب تمامًا**؛ وتخطَّ التحقق والإكمال التلقائي |

تضيف الصفحة الدولية ثلاث نقاط: عند إيقاف المفتاح، يُطبَّع العنوان بحيث ينتهي المسار بـ `/chat/completions`، ولا تُضاف لك مقاطع مسارات أخرى يحتاجها المزوّد؛ وعند إيقافه «يمكنك إدخال Base URL الذي يتضمن /v1 أو URL الكامل»؛ وفي معظم الحالات لا تحتاج إلى تشغيل المفتاح. لا يغيّر المفتاح سوى طريقة معالجة العناوين، وليس محوّل بروتوكول API للأغراض العامة.

بالنسبة إلى QCode، أدخل المسار الكامل `https://api.qcode.cc/openai/v1/chat/completions`. وهو صحيح في حالتي المفتاح: عند إيقافه ينتهي المسار بالفعل بـ `/chat/completions`، وعند تشغيله يُرسَل العنوان كما كُتب. وهو أيضًا القيمة التي يحتاجها `models.json` المكتوب يدويًا في `url` (انظر أدناه)، كما يُدخِل دليل TokenHub من Tencent Cloud الخاص بـ WorkBuddy URL كاملًا ينتهي بـ `/v1/chat/completions`. وبالنسبة إلى تطبيق WorkBuddy لسطح المكتب، نتيجة اختبار الاتصال هي الفيصل النهائي.

- عند إيقاف المفتاح، يعمل أيضًا `https://api.qcode.cc/openai/v1` (القيمة نفسها باسم `OPENAI_BASE_URL` في [متغيرات البيئة](/docs/getting-started/environment))؛ ويضيف WorkBuddy `/chat/completions`
- أبقِ `/v1`: يضيف WorkBuddy فقط `/chat/completions`، وليس مقاطع مسارات أخرى، ومسار Chat في QCode هو `/openai/v1/chat/completions`
- يستخدم QCode المسار القياسي، لذا يمكنك ترك البروتوكول المخصص متوقفًا؛ وعند تشغيله، لا يعمل إلا المسار الكامل
- **بدون `/` زائدة في النهاية**. تصبح الشرطات المائلة الإضافية `//chat/completions`

النطاقات الثلاثة للوصول متطابقة وظيفيًا؛ ويختلف التوجيه فقط. ويعمل المفتاح نفسه على جميعها:

| العقدة | URL نقطة النهاية |
|------|--------------|
| عالمي (Route 53) | `https://api.qcode.cc/openai/v1/chat/completions` |
| آسيا (موصى بها في الصين) | `https://asia.qcode.cc/openai/v1/chat/completions` |
| أمريكا الشمالية / أوروبا | `https://us.qcode.cc/openai/v1/chat/completions` |

### أين يوجد ملف الإعدادات

تستخدم النسختان الصينية والدولية مسارات مختلفة؛ اقرأهما كلًا على حدة (مقتبسًا من الصفحتين الرسميتين):

| النسخة | العبارة الرسمية |
|---|---|
| الصين (workbuddy.cn) | تُخزَّن المعاملات (بما فيها مفتاح API) فقط في `workbuddy/models.json` المحلي ولا تُرفَع؛ ولا تزال النماذج المخصصة المُهيأة مسبقًا عبر `~/.codebuddy/models.json` تعمل بعد ترقية الواجهة |
| الدولية (workbuddy.ai) | ملف الإعدادات الافتراضي على مستوى المستخدم هو `~/.workbuddy-ai/models.json`. على Windows، يقع في `%USERPROFILE%\.workbuddy-ai\models.json` |

تضيف الصفحة الدولية أنه إذا غيّرت مجلد إعدادات المستخدم، فينبغي استخدام المسار المعروض في صفحة إعدادات النموذج، وأن ملف الإعدادات الذي يحتوي على مفاتيح API يجب ألا يُرفَع إلى مستودع عام. وتذكر الصفحة الصينية فقط `workbuddy/models.json`، وليس المجلد الذي يوجد فيه؛ اعتمد على الملف الفعلي على جهازك، أو أدِر الصفوف في الواجهة ببساطة.

أيضًا:

- تقول الملاحظة الرسمية حول استخدام الرصيد إن جميع التكاليف التي يتكبدها النموذج المخصص تُدفَع إلى الطرف الثالث (هنا QCode.cc، وتُحتسب لكل token)
- وفق سجل التغييرات الرسمي، وصلت ميزة إعادة التحميل السريع لملف models.json في 5.1.1: تسري التعديلات دون إعادة تشغيل

استخدم الواجهة للتغييرات اليومية. إذا كان لا بد من تحرير `models.json` يدويًا، فجدول الحقول وقاعدة `url` موجودان في [النماذج المخصصة في CodeBuddy](/docs/ide/codebuddy). تقول وثائق CodeBuddy الرسمية: «يجب أن يكون حقل url مسار الواجهة الكامل، وينتهي عادةً بـ /chat/completions» (`https://api.openai.com/v1` مذكور كمثال غير صحيح)، لذا فإن `url` الخاص بـ QCode هو `https://api.qcode.cc/openai/v1/chat/completions`. جُرّب CodeBuddy Code CLI، المبني على الأساس نفسه، بهذا المسار الكامل باعتباره `url` في `models.json` واتصل (CodeBuddy Code 2.182.0، 2026-11-10). ليس لدى WorkBuddy جدول حقول خاص به لذلك الملف، لذا أضف صفًا واحدًا في الواجهة أولًا وافحص الملف المحلي؛ لا تنسخ مخططًا من مدونة طرف ثالث.
## النماذج التي تُضاف أولًا

جميع المعرّفات أدناه تم التحقق منها في 2026-11-10 مقابل القائمة المباشرة على [qcode.cc/models](https://qcode.cc/models). لم تُنسخ الأسعار إلى هذه الصفحة — **تعامل مع qcode.cc/models كقائمة مباشرة** (يمكن للمشرفين تغيير رسوم الخدمة).

| معرّف النموذج | الاستخدام |
|----------|-----|
| `gpt-6.1-sol` | فئة GPT للبرمجة المعقدة والعمل الاحترافي |
| `gpt-5.6-terra` | فئة GPT للاستخدام اليومي |
| `glm-5.3` | النموذج الرائد من Zhipu، شائع في أعمال المكاتب الصينية |
| `kimi-k3` | النموذج الرائد من Moonshot، نافذة سياق طويلة |
| `deepseek-v4-pro` | النموذج الرائد من DeepSeek |
| `qwen3.8-max` | النموذج الرائد من Qwen |

النماذج الشقيقة الأخف `glm-5.3-flash` و`deepseek-v4-flash` و`deepseek-v4.1-flash` و`qwen3.8-flash` و`qwen3.7-plus` معروضة جميعها للبيع؛ وقد أُحيلت الأجيال السابقة `glm-5.1` و`kimi-k2.6` إلى التقاعد — وسيؤدي إدخالها إلى الفشل. انظر [اختيار النموذج](/docs/usage/model-selection). لا تضع اسمًا غير موجود في [qcode.cc/models](https://qcode.cc/models) في **اسم النموذج**.

هذا المسار هو OpenAI Chat Completions. **لا تضع** `ANTHROPIC_BASE_URL` (`https://api.qcode.cc/api`) في حقل نقطة النهاية — تلك البادئة مخصصة لـ Claude Code / SDK الخاص بـ Anthropic.

## التحقق

تحقق أولًا من أن مسار OpenAI الخاص بـ QCode قابل للوصول على شبكتك (نفس الفحص الوارد في [نقاط النهاية وتنسيقات API](/docs/getting-started/endpoints-and-api-paths) §4):

```bash
KEY="cr_your_key"

curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# → 400 = path and key both work (empty body is expected)
# → 401 = bad key; 404 = wrong path prefix
```

في البر الرئيسي للصين، أعد المحاولة باستخدام المضيف `asia.qcode.cc`. ثم في WorkBuddy اختر النموذج الجديد وأرسل `ping`. يعني وصول رد أن التكامل يعمل.

إذا نجح فحص المسار لكن ما زال WorkBuddy يعرض أخطاء، فأعد فحص القسم السابق: يبقى في URL الجزء `/v1` ولا ينتهي بشرطة مائلة، ومع تشغيل البروتوكول المخصص يكون المسار الكامل منتهيًا بـ `/chat/completions`، ويكون معرّف النموذج مطابقًا حرفًا بحرف.

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

### لا يعرض منتقي النماذج الصف الجديد

بدءًا من 5.1.1، يصف سجل التغييرات الرسمي إعادة التحميل الساخن لـ models.json — عادةً يكفي الحفظ. إذا ظل المنتقي لا يعرضه، فأغلق WorkBuddy إغلاقًا كاملًا (لا تتركه في علبة النظام) ثم أعد فتحه؛ وبعد ذلك تحقق من الإعدادات → النموذج بحثًا عن الصف.

### رمز الخطأ 4100 (لا يملك النموذج المخصص نقطة نهاية أو مفتاح API)

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

### لا أستطيع العثور على النماذج المخصصة على هاتفي

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

### هل تحتاج نسختا الصين والدولية إلى إعداد منفصل؟

وفقًا للوثائق الرسمية، تحتفظ النسختان بإعداداتهما في ملفين مختلفين (نسخة الصين `workbuddy/models.json`، والنسخة الدولية `~/.workbuddy-ai/models.json`)، لذا اضبط إعدادات النسخة التي ثبّتها. يُملأ URL الخاص بـ QCode والمفتاح بالطريقة نفسها في كلتيهما.

### HTTP 404

1. أدخل `https://api.qcode.cc/openai/v1/chat/completions` (مع **إيقاف** البروتوكول المخصص، يعمل `https://api.qcode.cc/openai/v1` أيضًا)
2. مع **تشغيل** البروتوكول المخصص، يعمل المسار الكامل فقط؛ ويُرسل `…/openai/v1` وحده كما هو مكتوب، دون `/chat/completions`
3. أبقِ `/v1`؛ دون `/` زائدة في النهاية
4. لا تستخدم `https://api.qcode.cc/api` (بادئة Anthropic Messages)

### HTTP 401

يجب أن يبدأ المفتاح بـ `cr_` وألا يحتوي على مسافات. تحقق منه في [qcode.cc/dashboard](https://qcode.cc/dashboard). يخزّن WorkBuddy المفتاح محليًا؛ ويعني تدوير المفتاح تحرير صف النموذج المخصص هذا.

### ردود غريبة أو فاشلة بعد ملء اسم النموذج

**اسم النموذج** يجب أن يكون معرّفًا مباشرًا على نقطة النهاية هذه مثل `gpt-5.6-terra`، وليس تسمية العرض «GPT 5.6 Terra» وليس اسمًا مستعارًا لمزوّد آخر. القائمة المباشرة: [qcode.cc/models](https://qcode.cc/models) أو `GET https://api.qcode.cc/openai/v1/models` باستخدام مفتاحك — **تلك القائمة هي المجموعة التي يمكن لـ WorkBuddy استخدامها**، وهي لا تحتوي على Claude.

### هل يرفع WorkBuddy المحادثة إلى Tencent؟

الصياغة الرسمية: في مسار النموذج المخصص يكون WorkBuddy ناقلًا؛ فهو يمرر الإدخال إلى الطرف الثالث الذي أعددته، ويبقى مفتاح API محليًا. تُعد [صفحة النموذج الرسمية](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model) واتفاقية مستخدم Tencent مرجعين معتمدين. يمكن فحص الطلبات التي تصل إلى QCode على [probe.qcode.cc](https://probe.qcode.cc) باستخدام المفتاح نفسه.

### هل يمكن أن يحل WorkBuddy محل Claude Code؟

لا. صُمم WorkBuddy لتسليم الأعمال المكتبية متعدد الوكلاء؛ وصُمم Claude Code / Codex لحلقات البرمجة داخل المستودع. استخدم كليهما: مخرجات المكتب في WorkBuddy، وتغييرات الشيفرة في Claude Code مع التبديل عبر [CC Switch](/docs/ide/cc-switch). مفتاح QCode واحد، وحصة واحدة — انظر [الفوترة](/docs/reference/billing).
## الخطوات التالية

- [نقاط النهاية وصيغ API](/docs/getting-started/endpoints-and-api-paths) — ثلاثة بروتوكولات، وثلاثة نطاقات، وخريطة `BASE_URL`
- [نماذج CodeBuddy المخصصة](/docs/ide/codebuddy) — منتج البرمجة من الفريق نفسه: حقول `models.json` وإعداد Responses
- [إعداد CC Switch](/docs/ide/cc-switch) — بدّل المفتاح نفسه بين Claude Code وCodex
- [اختيار النموذج](/docs/usage/model-selection) — أي مستوى تستخدمه يوميًا
- [الفوترة](/docs/reference/billing) — الخطط والحصة
- المعرّفات والأسعار المباشرة: [qcode.cc/models](https://qcode.cc/models)

> ألا تملك مفتاح API لـ QCode.cc بعد؟ اختر خطة من [qcode.cc/pricing](https://qcode.cc/pricing).