# n8n مع QCode: دليل مصوّر على Windows 11

اتبع الخطوات الـ13 أدناه، وستشغّل أداة أتمتة سير العمل n8n على جهاز Windows 11 الخاص بك، وتجعل عقدة OpenAI فيها تردّ عليك بجملة واحدة عبر QCode.


**الإجابة المختصرة**: في عقدة «Message a model» على لوحة n8n انقر «Connect to OpenAI»، وأنشئ بيانات اعتماد «OpenAI account» جديدة، وغيّر `Base URL` إلى `https://api.qcode.cc/openai/v1`، وضع في `API Key` مفتاحًا يبدأ بـ `cr_`، ثم اختر `gpt-6.2-sol` في `Model` — وهذا كل شيء.

| البند | ما تملؤه |
|---|---|
| عنوان الفتح المحلي | `http://localhost:5678` |
| اسم بيانات الاعتماد | `OpenAI account` |
| عنوان الوصول (`Base URL`) | `https://api.qcode.cc/openai/v1` |
| المفتاح (`API Key`) | `cr_xxxxxxxx` |
| النموذج الموصى به (`Model`) | `gpt-6.2-sol` |

تم التحقق في 2026-11-22 · n8n 2.48.7 · Windows 11


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

> **كلمة أولى**: لا تتوفر واجهة n8n حاليًا إلا بالإنجليزية، وحتى على نسخة Windows الصينية تُفتح بالإنجليزية. أسماء الأزرار والقوائم الموضوع بين «» في هذا الدليل هي النص الإنجليزي نفسه الظاهر في اللقطات، فانسخها كما هي.


- **ينطبق على**: Windows 10 / 11 (64 بت)
- **إصدار البرنامج**: n8n 2.48.7 (مع Node.js v24.22.3 LTS وnpm 11.19.1)
- **تاريخ تحديث اللقطات**: 2026-11
- **الوقت المتوقع**: 20 دقيقة (`npx n8n` في المرة الأولى ينزّل الاعتماديات، فانتظر بصبر)
- **ما تحتاج إليه**: مفتاح QCode API يبدأ بـ `cr_`؛ وNode.js 20.19–24.x (يُفضّل إصدار LTS)؛ ومتصفح Edge أو Chrome



- الكمبيوتر يعمل بـ Windows 10 / 11 (64 بت)، ويستطيع فتح «Windows PowerShell» أو «الطرفية»
- يستطيع الكمبيوتر الوصول إلى `nodejs.org` و`registry.npmjs.org` و`localhost:5678` و`api.qcode.cc`
- سجّلت حسابًا في QCode.cc ونسخت مفتاح API يبدأ بـ `cr_` من [لوحة التحكم](https://qcode.cc/ar/dashboard). ليس لديك حساب بعد؟ [أنشئ حساب QCode](https://qcode.cc/ar/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-n8n-before) أولًا، واختر خطة من [صفحة الأسعار](https://qcode.cc/ar/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-n8n-before)، ثم أنشئ المفتاح في [لوحة التحكم](https://qcode.cc/ar/dashboard)
- لا تحتاج إلى حساب في موقع n8n الرسمي ولا إلى حساب OpenAI: الحساب المحلي الذي تنشئه عند أول فتح لـ n8n موجود على جهازك وحده
- خصّص نحو 20 دقيقة دون انقطاع، ولا تغلق نافذة PowerShell في أثنائها


## التنزيل والتثبيت

لا توجد حزمة تثبيت `.exe` لـ n8n على Windows، ونسخة سطح المكتب القديمة الرسمية لم تعد مدعومة، فلا تنزّلها. أسهل طريقة على Windows: ثبّت Node.js أولًا، ثم شغّله مباشرة بالأمر `npx n8n` داخل PowerShell، دون صلاحيات مسؤول ودون تثبيت شامل.

المداخل الرسمية:

- **Node.js**: [صفحة التنزيل الرسمية](https://nodejs.org/en/download) (يجب أن يقع الإصدار بين 20.19–24.x، ويستخدم هذا الدليل `v24.22.3 LTS`)
- **نظرة عامة على طرق تثبيت n8n**: [docs.n8n.io/choose-n8n](https://docs.n8n.io/choose-n8n/)
- **وثائق تشغيل n8n من سطر الأوامر**: [docs.n8n.io/hosting/installation/npm](https://docs.n8n.io/hosting/installation/npm/)

تختلف حالة الشبكة من منطقة إلى أخرى، فاختر منطقتك أولًا:

**مناطق أخرى / أجهزة فيها winget**

- نزّل أيضًا `Windows Installer (.msi)` الخاص بـ `v24.22.3 LTS` من **nodejs.org/en/download**، وانقر نقرًا مزدوجًا لتثبيته، ويكفي اتباع الخيارات الافتراضية للمعالج.
- يمكنك أيضًا استخدام `winget`، لكن انتبه: `OpenJS.NodeJS.LTS` يشير الآن إلى v26، وقد يفشل n8n في البدء معه، لذا يُفضّل اختيار MSI من الإصدار v24.x كما سبق.
- قد يعترض «Windows حماية جهازك» ملف `.msi` المنزّل من المتصفح، فانقر «مزيد من المعلومات» ← «التشغيل على أي حال».


**البر الرئيسي للصين**

- افتح **nodejs.org/en/download**، واختر يدويًا `v24.22.3 LTS` من قائمة الإصدارات أعلى الصفحة (المحدد افتراضيًا هو v26، وn8n غير مستقر عليه)، واختر المنصة `Windows` والمعمارية `x64`.
- انقر الزر الأخضر «Windows Installer (.msi)» أسفل الصفحة لتنزيل حزمة التثبيت، ثم انقر نقرًا مزدوجًا واتبع المعالج بالضغط على «Next» حتى النهاية، وعند ظهور «التحكم في حساب المستخدم» انقر «是» (نعم).
- إذا لم تُفتح قائمة الإصدارات في الصفحة أو كان التنزيل بطيئًا، فانتظر قليلًا وانقر مرة أخرى؛ وبعد انتهاء التثبيت أغلق نافذة PowerShell تمامًا وافتح واحدة جديدة، فلن يسري Node الجديد إلا بعد ذلك.


## اتبع اللقطات: Windows خطوة بخطوة

فيما يلي 13 خطوة، كل خطوة تفعل شيئًا واحدًا فقط. تُكتب جميع الأوامر في نافذة «Windows PowerShell» نفسها؛ والأرقام البرتقالية على اللقطات (①، ②، ③) تقابل الترقيم في النص واحدًا بواحد.



### نزّل حزمة Node.js التي يعمل بها n8n

افتح في المتصفح `https://nodejs.org/en/download`، واختر أولًا `v24.22.3 LTS` في قائمة الإصدارات عند ①، واترك المنصة `Windows` والمعمارية `x64`. ثم انقر الزر الأخضر «Windows Installer (.msi)» عند ② لتنزيل حزمة التثبيت.

![صفحة التنزيل الرسمية لـ Node.js: قائمة الإصدارات أعلى الصفحة محددة على v24.22.3 LTS وWindows (1)، وأسفل الصفحة زر أخضر Windows Installer (.msi) (2)](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/01-nodejs-download.webp)


إذا فعلتها بشكل صحيح فسترى: قائمة الإصدارات تعرض `v24.22.3 LTS`، ويبدأ المتصفح تنزيل ملف باسم مثل `node-v24.22.3-x64.msi`.


**تعثّرت؟ الصفحة الافتراضية ليست v24**

الصفحة تحدد افتراضيًا الإصدار الأحدث v26، وn8n 2.48.7 يفشل في البدء معه. يجب التبديل يدويًا في القائمة إلى `v24.22.3 LTS`، والتأكد من تغيّر رقم الإصدار على الزر أيضًا، ثم النقر على التنزيل.




### بعد التثبيت أعد فتح PowerShell وتحقق من الإصدار

انقر نقرًا مزدوجًا على ملف `.msi` المنزّل، واتبع المعالج بالضغط على «Next» حتى ينتهي. ثم **أغلق نافذة PowerShell تمامًا وافتح واحدة جديدة**، واكتب `node -v` ثم `npm -v`: يجب أن يُخرج ① القيمة `v24.22.3`، ويُخرج ② القيمة `11.19.1`.

![في طرفية Windows (PowerShell) يُنفَّذ أولًا node -v فيُخرج v24.22.3 (1)، ثم npm -v فيُخرج 11.19.1 (2)، واسم المستخدم في سطر المطالبة محجوب](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/02-node-version-check.webp)


إذا فعلتها بشكل صحيح فسترى: سطرين نظيفين برقمي الإصدار `v24.22.3` و`11.19.1`، يسبقهما سطر المطالبة الخاص بك، ودون أي خطأ بالأحمر.


**تعثّرت؟ تظهر رسالة أن node أو npm ليس أمرًا داخليًا أو خارجيًا**

هذا يعني أن Node.js لم يُثبَّت جيدًا، أو أنك لم تفتح نافذة جديدة بعد التثبيت. أغلق PowerShell الحالية (لا تصغّرها)، وأعد فتحها وحاول مرة أخرى؛ وإن استمر الأمر فأعد تشغيل حزمة MSI، مع إبقاء «Add to PATH» محدّدًا في معالج التثبيت.




### شغّل خدمة n8n المحلية بالأمر npx

في نافذة PowerShell نفسها اكتب `npx n8n` واضغط Enter. في المرة الأولى تُنزَّل الاعتماديات، وقد يطول الانتظار دقيقة أو دقيقتين. حين يتوقف الطرفية عن التمرير، تحقق من سطرين: ① هو `Version: 2.48.7`، و② هو `Editor is now accessible via: http://localhost:5678`.

![سجل بدء التشغيل بعد تنفيذ npx n8n في PowerShell، وأسفل الطرفية يظهر Version: 2.48.7 (1) وEditor is now accessible via: http://localhost:5678 (2)](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/03-npx-n8n-start.webp)


إذا فعلتها بشكل صحيح فسترى: يتوقف الطرفية عند `Editor is now accessible via: http://localhost:5678`، ولا يتحرك المؤشر بعد ذلك، ويجب إبقاء هذه النافذة مفتوحة من الآن فصاعدًا.


**تعثّرت؟ تظهر نافذة تسأل «هل تريد السماح لهذا التطبيق بالوصول إلى الشبكات العامة والخاصة؟»**

هذا جدار حماية Windows يسأل إن كان بإمكان Node.js الاستماع إلى منفذ محلي، فانقر «السماح» ولن يظهر مرة أخرى. وإذا أخبرك الطرفية أن المنفذ مستخدم، فأوقف n8n في هذه النافذة، ثم استخدم `$env:N8N_PORT = 5679; npx n8n`، وافتح `http://localhost:5679`.




### افتح n8n وأنشئ حسابًا محليًا

افتح في المتصفح `http://localhost:5678`، وسينتقل تلقائيًا إلى صفحة `Set up owner account`. في النموذج عند ① املأ بالترتيب `Email` و`First Name` و`Last Name` و`Password` (كلمة المرور 8 أحرف على الأقل، وتحتوي رقمًا واحدًا وحرفًا كبيرًا واحدًا). بعد الملء انقر الزر الوردي «Next» عند ②.

![صفحة Set up owner account في n8n: في الوسط نموذج بالبريد الإلكتروني والاسم الأول واسم العائلة وكلمة المرور (1)، وأسفله زر Next الوردي (2)، والبريد والاسم محجوبان](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/04-owner-setup.webp)


إذا فعلتها بشكل صحيح فسترى: بعد النقر على «Next» تنتقل الصفحة ويظهر استبيان صغير بعنوان `Customize n8n to you`، وهذا يعني أن الحساب المحلي أُنشئ.


**تعثّرت؟ الصفحة لا تُفتح، أو نسيت كلمة المرور**

إذا لم تُفتح الصفحة فارجع أولًا إلى PowerShell وتأكد أن الطرفية ما زالت عند `Editor is now accessible via:`، وأن النافذة لم تُغلق، ثم حدّث الصفحة. وإذا نسيت كلمة المرور المحلية، فأوقف n8n بالضغط على `Ctrl+C`، ونفّذ `npx n8n user-management:reset` لإعادة تعيين الحساب المحلي، ثم افتح `http://localhost:5678` من جديد.




### تجاوز التوجيه الأول حتى تصل إلى لوحة فارغة

ثم انقر بالترتيب: «Get started» أسفل يمين نافذة الاستبيان ← «Skip» أسفل يسار نافذة الترخيص ← «Got it» في صفحة المساعد ← «Set up later in Settings» أسفل الصفحة ← «Build a workflow» على يمين صفحة `Let's build your first automation`. بعد الوصول إلى اللوحة، سيكون في الوسط مربع الزائد «Add first step...» عند ①.

![بعد تجاوز الاستبيان وتنبيه الترخيص وتوجيه n8n Assistant، يظهر في وسط لوحة سير العمل الفارغة مربع الزائد Add first step... (1)](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/05-empty-canvas.webp)


إذا فعلتها بشكل صحيح فسترى: في وسط اللوحة مربع واحد فقط «Add first step...»، وحوله خلفية رمادية فارغة، والشريط الجانبي الأيسر مطوي.




### ابحث عن عقدة OpenAI واخترها

انقر على «Add first step...» في وسط اللوحة، فينبثق من اليمين لوح العقد. اكتب `OpenAI` في حقل البحث عند ①، ثم انقر أول عنصر «OpenAI» في ② (المكتوب تحته `Message an assistant or GPT...`).

![في حقل البحث في لوح العقد على اليمين كُتب OpenAI (1)، وأول نتيجة هي عقدة OpenAI (2)](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/06-search-openai.webp)


إذا فعلتها بشكل صحيح فسترى: لا يبقى تحت حقل البحث إلا عدد قليل من النتائج المتعلقة بـ OpenAI، وأولها «OpenAI».


**تعثّرت؟ لا يظهر OpenAI في البحث**

اكتب في حقل البحث الحروف الستة `OpenAI` وحدها، دون كلمات أخرى ودون علامات اقتباس. في القائمة أيضًا «OpenAI Chat Model» و«Microsoft Foundry Chat Model»، وهما ليسا المطلوبين في هذا الدليل فلا تنقر عليهما.




### اختر Message a model ضمن TEXT ACTIONS

بعد النقر على «OpenAI» تظهر قائمة الإجراءات، فانزل حتى تجد مجموعة `TEXT ACTIONS`، ثم انقر «Message a model» عند ①.

![في قائمة إجراءات OpenAI، عنصر Message a model ضمن مجموعة TEXT ACTIONS (1)](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/07-openai-actions.webp)


إذا فعلتها بشكل صحيح فسترى: يضيف n8n تلقائيًا على يسار اللوحة مشغّلًا يدويًا «When clicking 'Execute workflow'»، وتظهر في الوقت نفسه نافذة معاملات «Message a model».




### انقر أولًا Connect to OpenAI لإنشاء بيانات الاعتماد

لا حاجة لتغيير المعاملات في النافذة، أنشئ بيانات الاعتماد أولًا: انقر «Connect to OpenAI» عند ①. وتحقق في الوقت نفسه من القيمتين الافتراضيتين عند ② — `Resource` هي `Text` و`Operation` هي `Message a Model` — فإبقاؤهما كما هما صحيح.

![لوح معاملات عقدة Message a model: زر Connect to OpenAI تحت Credential (1)، وقيمتا Resource: Text وOperation: Message a Model بالوضع الافتراضي (2)](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/08-node-params.webp)


إذا فعلتها بشكل صحيح فسترى: تظهر في وسط الشاشة نافذة بيانات اعتماد بعنوان «OpenAI account»، وتُغطى العقدة على اللوحة مؤقتًا.




### املأ مفتاح QCode وعنوان الوصول

في نافذة بيانات الاعتماد: الصق في `API Key` عند ① مفتاحك الذي يبدأ بـ `cr_` (محجوب في الصورة)؛ واترك `Organization ID` فارغًا؛ وفي `Base URL` عند ② اضغط `Ctrl+A` لتحديد القيمة الافتراضية وحذفها، ثم اكتب `https://api.qcode.cc/openai/v1`؛ وأخيرًا انقر «Save» أعلى اليمين عند ③.

![نافذة بيانات اعتماد OpenAI account: في API Key مفتاح cr_ محجوب (1)، وBase URL معدّل إلى https://api.qcode.cc/openai/v1 (2)، وأعلى اليمين زر Save (3)](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/09-credential-form.webp)


إذا فعلتها بشكل صحيح فسترى: سطر `Base URL` يعرض كاملًا `https://api.qcode.cc/openai/v1` (ينتهي بـ `/v1` لا `/v1/v1`)، و`Organization ID` فارغ.


**تحتاج مفتاح API؟**

إن لم يكن لديك حساب QCode بعد، [أنشئ حساب QCode](https://qcode.cc/ar/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-n8n-key) أولًا. وإذا أردت الدفع حسب الاستخدام الفعلي، فاشترِ أولًا [باقة الدفع حسب الاستخدام](https://qcode.cc/ar/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-n8n-key)، ثم أنشئ المفتاح في [لوحة التحكم](https://qcode.cc/ar/dashboard). انسخ السلسلة كاملة التي تبدأ بـ `cr_` والصقها في `API Key`. ويمكنك الدفع ببطاقة الائتمان / الخصم (Visa / Mastercard)، أو Apple Pay / Google Pay، أو العملات المشفرة — راجع [طرق الدفع](/docs/reference/payment-methods).




### تأكد من نجاح حفظ بيانات الاعتماد

بعد النقر على «Save» يستخدم n8n هذا المفتاح تلقائيًا لطلب قائمة النماذج مرة واحدة، وتُغلق النافذة من تلقاء نفسها عند النجاح. تحقق من موضعين: `Credential` عند ① محدّد تلقائيًا على «OpenAI account»، ويظهر أسفل اليمين عند ② تنبيه أخضر «Credential successfully created inside your personal space».

![بعد إغلاق نافذة بيانات الاعتماد: Credential محدد على OpenAI account (1)، وأسفل اليمين تنبيه أخضر Credential successfully created inside your personal space (2)](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/10-credential-saved.webp)


إذا فعلتها بشكل صحيح فسترى: التنبيه الأخضر يظهر أسفل اليمين، وقائمة `Credential` تعرض «OpenAI account»، ولا توجد علامة تعجب حمراء على العقدة.


**تعثّرت؟ خطأ عند الحفظ، أو رسالة أن النموذج غير موجود**

تحقق من ثلاثة أمور بالترتيب: 1) أنك نسخت فقط السلسلة التي تبدأ بـ `cr_`، دون مسافات أو علامات اقتباس حولها؛ 2) أن `Base URL` هو `https://api.qcode.cc/openai/v1`، دون `/chat/completions` ودون `/v1/v1`؛ 3) أن `Organization ID` فارغ. بعد التعديل انقر «Save» مرة أخرى.




### اختر gpt-6.2-sol في Model

انقر القائمة المنسدلة «Choose...» عند `Model`، فينزّل n8n قائمة نماذج QCode تلقائيًا. اكتب `gpt-6.2-sol` في حقل البحث عند ①، ثم انقر «GPT-6.2-SOL» الظاهر تحته.

![بعد كتابة gpt-6.2-sol في قائمة Model المنسدلة يظهر في القائمة GPT-6.2-SOL قابل للاختيار (1)](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/11-select-model.webp)


إذا فعلتها بشكل صحيح فسترى: سطر `Model` يعرض «GPT-6.2-SOL»، وتُطوى القائمة المنسدلة، ويمكن رؤية نماذج أخرى في القائمة مثل `GLM-5.2` و`DEEPSEEK-V4-FLASH`.


**تعثّرت؟ القائمة المنسدلة فارغة**

هذا يعني أن `Base URL` في الخطوة السابقة لم يُحفظ صحيحًا. ارجع إلى `Credential` وانقر «OpenAI account» لتعديلها، وتأكد أن `Base URL` هو `https://api.qcode.cc/openai/v1` ثم انقر «Save»، وبعد ذلك أغلق نافذة العقدة وأعد فتحها مرة واحدة، وستُحمَّل قائمة النماذج من جديد.




### اكتب جملة ونفّذ هذه العقدة

اكتب جملة في حقل `Prompt` عند ①، مثل «مرحبًا، عرّف بنفسك في جملة واحدة». ثم انقر «Execute step» عند ② لإرسال الطلب، وانتظر بضع ثوانٍ وراقب لوح `OUTPUT` عند ③.

![في معاملات العقدة حقل Prompt مملوء بسؤال (1)، وأعلى النافذة زر Execute step (2)، ولوح OUTPUT على اليمين يعرض علامة صح خضراء ورد النموذج (3)](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/12-execute-output.webp)


إذا فعلتها بشكل صحيح فسترى: تظهر أعلى `OUTPUT` علامة صح خضراء، وفيها `role: assistant` و`status: completed`، ويكون رد النموذج في الحقل `output[0].content[0].text`.




### أغلق نافذة المعاملات واحفظ سير العمل

انقر × أعلى يمين نافذة العقدة، وعُد إلى اللوحة، واضغط `Ctrl+S` للحفظ. في الموضع المؤطّر عند ① تظهر عقدتان: المشغّل اليدوي على اليسار و«Message a model» على اليمين، وكلتاهما بعلامة صح خضراء.

![لوحة سير العمل بعد الحفظ: المشغّل اليدوي وعقدة Message a model كلتاهما بعلامة صح خضراء (1)](https://docs.qcode.cc/static/images/tut/n8n/202611/zh/13-workflow-canvas.webp)


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




## التحقق من النجاح

إذا تحققت الأمور الأربعة كلها، فهذا يعني أن n8n متصل بـ QCode اتصالًا كاملًا:

- في PowerShell يُخرج `node -v` القيمة `v24.22.3`، ويُخرج `npm -v` القيمة `11.19.1`؛
- يتوقف الطرفية عند `Editor is now accessible via: http://localhost:5678`، ويستطيع المتصفح فتح `http://localhost:5678`؛
- لا يظهر خطأ عند حفظ بيانات الاعتماد، ويمكن اختيار «GPT-6.2-SOL» في قائمة `Model`؛
- بعد النقر على «Execute step» تظهر علامة صح خضراء في `OUTPUT`، ويكون في `output[0].content[0].text` رد النموذج.


### انتهى كل شيء

أصبح بإمكانك تشغيل n8n على جهاز Windows 11 الخاص بك والعمل بنماذج QCode. ويمكنك بعد ذلك:

- [نقاط الوصول وصيغ API](/docs/getting-started/endpoints-and-api-paths)
- [ربط النماذج الصينية](/docs/usage/cn-models)
- [شرح الفوترة](/docs/reference/billing)
- [استكشاف الأخطاء وإصلاحها](/docs/reference/troubleshooting)
- التالي: قارن الخطط في [صفحة الأسعار](https://qcode.cc/ar/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-n8n-done)
- ارجع إلى [لوحة التحكم](https://qcode.cc/ar/dashboard) لمراجعة الاستخدام والرصيد


## الأخطاء الشائعة

| نص الخطأ | السبب | ما العمل |
|---|---|---|
| `Error` | يفتح المتصفح قبل خدمة الويب الخاصة بـ n8n، فالصفحة المحلية لم تبدأ الاستجابة بعد | ارجع إلى PowerShell وتأكد من طباعة `Editor is now accessible via: http://localhost:5678`، ثم حدّث الصفحة؛ ويجب أن يكون العنوان `http://localhost:5678` دون https |
| `https://api.openai.com/v1` | `Base URL` في بيانات الاعتماد ما زال القيمة الرسمية الافتراضية، فالطلب لم يصل إلى QCode أصلًا | غيّر `Base URL` إلى `https://api.qcode.cc/openai/v1` ثم انقر «Save»، وأغلق نافذة العقدة وأعد فتحها لتُحمَّل قائمة النماذج من جديد |
| `Import Workflow?` | ضغطت لصق والمؤشر ليس في حقل الإدخال، ففسّرت اللوحة محتوى الحافظة كسير عمل مستورد | انقر إلغاء، وأعد فتح نافذة بيانات الاعتماد «OpenAI account»، وانقر المؤشر داخل حقل `API Key` ثم الصق مفتاح `cr_` |
| `sqlite3` | إصدار Node.js أحدث من اللازم (مثل v26)، فلا توجد ملفات مبنية مسبقًا للاعتماديات الأصلية لـ n8n | ارجع إلى Node.js 20.19–24.x (يستخدم هذا الدليل `v24.22.3 LTS`)، وأغلق PowerShell وأعد فتحه، ثم نفّذ `npx n8n` مرة أخرى |
| `confluent-kafka-javascript` | كما سبق، إصدار Node.js خارج نطاق دعم n8n، فيجب إعادة بناء الاعتماديات على الجهاز | كما سبق: بدّل إلى `v24.22.3 LTS` وأعد التثبيت، ثم نفّذ `npx n8n`، ولا تستخدم v26 الذي يثبّته winget |

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

### ماذا أفعل بعد انتهاء صلاحية المفتاح؟

الأمر يختلف بحسب الحالة:

- **الخطة الشخصية**: لا يمكن تجديد مفتاحها بعد انتهاء الصلاحية، بل يجب فتح خطة جديدة والحصول على مفتاح جديد؛
- **باقة الدفع حسب الاستخدام**: بعد شراء باقة جديدة يعود المفتاح نفسه للعمل تلقائيًا.

بعد تغيير المفتاح، ارجع إلى نافذة بيانات الاعتماد «OpenAI account» في n8n، واستبدل `API Key` بالمفتاح الجديد ثم انقر «Save» فقط، دون تغيير الحقول الأخرى.

### هل يمكن تغيير واجهة n8n إلى الصينية؟

لا. لا تتضمن n8n 2.48.7 إلا واجهة إنجليزية، وحتى على نسخة Windows الصينية تُفتح بالإنجليزية. أسماء الأزرار الموضوع بين «» في هذا الدليل هي النص الإنجليزي نفسه الظاهر في اللقطات، فانقر عليها كما هي؛ أما محتوى المحادثة نفسه فيمكن أن يكون بالصينية بالكامل.

### ماذا أفعل إذا أردت استخدام نماذج Claude؟

عقدة OpenAI في n8n ترسل الطلبات فقط إلى عنوان متوافق مع OpenAI، ونقطة النهاية المتوافقة مع OpenAI في QCode `https://api.qcode.cc/openai/v1` لا توفّر سلسلة Claude، لذا يستخدم هذا الدليل `gpt-6.2-sol`. أما Claude فيمر عبر العنوان المتوافق مع Anthropic `https://api.qcode.cc/api`، والنموذج الموصى به افتراضيًا هو `claude-opus-5-5`، والبديل الخفيف `claude-haiku-5-5`.

### هل يعمل n8n بعد إغلاق PowerShell؟

لا. `npx n8n` يعمل داخل تلك النافذة، وبإغلاقها تتوقف الخدمة ولن يُفتح `http://localhost:5678`. لإبقائه عامرًا في الخلفية يمكن استخدام طريقة Docker الرسمية للنشر؛ أما للاستخدام الشخصي فقط فيكفي إعادة فتح النافذة وتنفيذ `npx n8n` مرة أخرى، فسير العمل وبيانات الاعتماد السابقة محفوظة على جهازك ولن تُفقد.

### ماذا أفعل إذا كان المنفذ 5678 مستخدمًا؟

بدّل المنفذ ثم شغّل من جديد: نفّذ في PowerShell الأمر `$env:N8N_PORT = 5679; npx n8n`، ثم افتح في المتصفح `http://localhost:5679`. لاحظ أن العنوان القديم لن يعمل بعد تبديل المنفذ.

## نقاط وصول أخرى

لـ QCode ثلاثة نطاقات وصول بقدرات متطابقة، ويختلف التوجيه الشبكي فقط، والمفتاح نفسه يعمل عليها جميعًا. إذا كانت شبكتك المحلية غير مستقرة مع `api.qcode.cc`، يمكنك التبديل إلى عقدة آسيا، بتغيير `Base URL` في بيانات الاعتماد ثم النقر على «Save»:

| العقدة | متوافق مع OpenAI (المستخدم في هذا الدليل) | متوافق مع Anthropic (Claude) |
|---|---|---|
| عالمي | `https://api.qcode.cc/openai/v1` | `https://api.qcode.cc/api` |
| آسيا | `https://asia.qcode.cc/openai/v1` | `https://asia.qcode.cc/api` |
| أمريكا الشمالية / أوروبا | `https://us.qcode.cc/openai/v1` | `https://us.qcode.cc/api` |

## شرح المعاملات

أكثر البنود استخدامًا في عقدة «Message a model»:

| المعامل | كيف تملؤه | الشرح |
|---|---|---|
| `Credential` | `OpenAI account` | يحفظ مفتاح QCode و`Base URL`، ويمكن لعقد متعددة مشاركة البيانات نفسها |
| `Resource` | `Text` | اتركه على الافتراضي |
| `Operation` | `Message a Model` | اتركه على الافتراضي |
| `Model` | `gpt-6.2-sol` | تعرض القائمة المنسدلة كل النماذج التي يوفّرها QCode |
| `Prompt` | سؤال بجملة واحدة | المحتوى المرسل إلى النموذج |
| `Simplify` | مفعّل افتراضيًا | إيقافه يُظهر بنية الاستجابة الأصلية الكاملة |

مسار الإخراج هو `output[0].content[0].text`، ويأتي معه `role: assistant` و`status: completed` و`phase: final_answer`. وإذا أرادت عقدة لاحقة أخذ هذا الرد فلتستخدم هذا المسار.

## متقدم: دعه يعمل تلقائيًا وفق جدول

بعد نجاح التشغيل، استبدل المشغّل «When clicking 'Execute workflow'» على اليسار بمشغّل آخر، لتستغني عن النقر اليدوي:

- **التشغيل وفق جدول**: احذف المشغّل اليدوي، وابحث في اللوحة عن `Schedule Trigger`، واضبط الوقت بالساعة أو باليوم؛
- **التشغيل عند وصول رسالة**: استبدله بمشغّل `Webhook`، وسيعطيك n8n عنوانًا محليًا، ويكفي أن يصل إليه برنامج آخر ليبدأ التشغيل؛
- **معالجة النتيجة**: أضف بعد «Message a model» عقدة `Set`، لتحفظ `output[0].content[0].text` في حقل، ثم اربطها بالبريد أو الجداول أو أدوات المحادثة.

## وثائق ذات صلة

- [نقاط الوصول وصيغ API](/docs/getting-started/endpoints-and-api-paths) — العلاقة بين البروتوكولات وعائلات النماذج
- [ربط النماذج الصينية](/docs/usage/cn-models) — معرّفات النماذج الصينية المتاحة على نقطة النهاية المتوافقة مع OpenAI
- [شرح الفوترة](/docs/reference/billing) — كيف يُحسب الاستخدام
- [استكشاف الأخطاء وإصلاحها](/docs/reference/troubleshooting) — ملخص المشكلات الشائعة