ما الذي تثبته الأدلة المتاحة؟

يُعد Next.js إطار عمل مبنيًا على React لإنشاء تطبيقات الويب. كما تصف المصادر المقدّمة KISS Sorcar، وهو إطار مساعد مستقل يفهرس النماذج ضمن فئات متعددة من المزوّدين، بما في ذلك OpenAI وAnthropic. ويشير وصفه إلى إمكانية مزج النماذج في المهام عبر الإشارة إلى معرّف نموذج مختلف، وأن الإطار يبدّل الواجهة الخلفية في كل استدعاء. تثبت هذه الحقائق أن اختيار النماذج من عدة مزوّدين نمط برمجي حقيقي، لكنها لا توثّق معالج مسارات في Next.js ولا تثبت أن دمجًا معينًا مع OpenAI أو Anthropic SDK يعمل.

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

لذلك، يتعامل هذا الدليل مع التنفيذ باعتباره سلسلة من القرارات الهندسية. ولا يدّعي أن نموذجًا معينًا متاح لكل الحسابات، أو أن معاملًا محددًا للرموز مقبول لدى كلا المزوّدين، أو أن صيغة استجابة موحّدة واحدة تستوعب كل إمكانات المزوّدين. هذه تفاصيل تكامل يجب التحقق منها بشكل مستقل.

الخطوة ١: حدّد نطاق الموجّه

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

قرّر أيضًا ما إذا كان الإصدار الأول سيتعامل مع دردشة نصية فقط. لا يتحقق السياق المقدّم من دعم الصور أو الأدوات أو المخرجات المنظّمة أو البث أو الطلبات متعددة الوسائط عبر تنفيذ Next.js المقترح. لا توحِ بدعم هذه الإمكانات لمجرد أن مزوّدًا أو إطارًا آخر قد يدعمها. اجعل العقد الأولي محدودًا، ولا تضف أي قدرة إلا بعد مراجعة وثائق المزوّد واختبار مسارات الطلب والاستجابة ذات الصلة.

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

الخطوة ٢: أنشئ عقد طلب مشتركًا

استخدم صيغة طلب مملوكة للتطبيق بدلًا من السماح بانتشار هياكل البيانات الخاصة بالمزوّدين داخل واجهة المستخدم. يجب أن يحدد العقد معرّفات المزوّدين المسموح بها، وأدوار الرسائل المقبولة، وحدود محتوى الرسائل، وطريقة تمثيل النموذج المحدد. تحقّق من بيانات HTTP الواردة أثناء التشغيل؛ فأنواع TypeScript تصف القيم أثناء التطوير، لكنها لا تتحقق بمفردها من صحة JSON عشوائي يستقبله الخادم.

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

وبالمثل، تحقّق من العلاقة بين المزوّد والنموذج على الخادم. القائمة المنسدلة في المتصفح وسيلة لتسهيل الاستخدام، وليست حدًا أمنيًا. يمكن تعديل الطلب خارج الواجهة. احتفظ بقائمة معتمدة أو سجل ضمن إعدادات يتحكم بها الخادم، وارفض التركيبات التي لم يفعّلها التطبيق صراحة. لا تثبت المصادر المقدّمة قائمة حالية لمعرّفات نماذج OpenAI أو Anthropic، لذا لا تملأ هذا السجل إلا بعد مراجعة المعلومات الرسمية للمزوّد.

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

الخطوة ٣: أبقِ استدعاءات المزوّد خلف حدود الخادم

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

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

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

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

الخطوة ٤: اجعل الخادم صاحب السلطة في اختيار النموذج

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

يقدم الوصف المقدّم لـ KISS Sorcar مثالًا مفيدًا على المفهوم العام؛ إذ يذكر كتالوجًا يضم فئات نماذج OpenAI وAnthropic، ويصف تبديل الواجهة الخلفية عندما تشير مهمة إلى معرّف نموذج مختلف. هذه أدلة على قدرات KISS Sorcar، وليست إثباتًا لتنفيذ موجّه Next.js المقترح في هذا الشرح. لا توحِ بأن KISS Sorcar تبعية لهذا التنفيذ، أو أن كتالوج نماذجه ينطبق على تطبيقك، أو أن سلوكه يتحقق من صحة تنفيذ SDK محدد.

عند إضافة نموذج آخر، راجع أولًا وثائق المزوّد الحالية وتحقق من صلاحية الوصول إليه ضمن الحساب. ثم حدّث السجل المملوك للخادم، والتسمية الظاهرة للمستخدم، والاختبارات الخاصة بالاقترانات الصحيحة وغير الصحيحة. تجنّب تثبيت اسم النموذج في مواضع متعددة؛ فالتكرار يجعل انفصال الواجهة عن سياسة الخادم أسهل.

الخطوة ٥: تحقّق من إصدارات أمان Next.js والنشر

تُعد مراجعة الأمان جزءًا من بناء الموجّه، وليست مهمة تنظيف بعد الإطلاق. يسرد سياق NVD المقدّم عدة مشكلات في Next.js ونطاقات محددة للإصدارات المتأثرة. يؤثر CVE-٢٠٢٦-٤٤٥٧٢ في الإصدارات من ١٢.٢.٠ حتى ما قبل ١٥.٥.١٦، وفي الإصدارات من ١٦.٠.٠ حتى ما قبل ١٦.٢.٥. ويتعلق الوصف المقدّم بسلوك إعادة توجيه في middleware يتضمن ترويسة x-nextjs-data واحتمال تخزين استجابات إعادة التوجيه مؤقتًا في عمليات النشر التي تستخدم CDN أو وكيلًا عكسيًا.

يسرد السياق أيضًا CVE-٢٠٢٦-٤٤٥٨١ وCVE-٢٠٢٦-٤٤٥٨٠، مع عتبات الإصلاح المذكورة عند ١٥.٥.١٦ و١٦.٢.٥. وتصف الملخصات مشكلات تتعلق بـ CSP nonces مع ذاكرات التخزين المؤقت المشتركة، وببرامج beforeInteractive النصية ذات المحتوى غير الموثوق، على التوالي. راجع سجلات NVD ونشرات المزوّد ذات الصلة لمعرفة الأثر الدقيق والإعدادات المتأثرة والمعالجة قبل اتخاذ قرار النشر.

لا تفترض أن اختيار إصدار موصوف بأنه «Next.js 15 أو أحدث» كافٍ. فقد يتضمن هذا النطاق إصدارات متأثرة. تحقّق من الإصدار الدقيق الذي يحله lockfile والموجود في artifact المنشور، ثم استخدم إصدارًا يتضمن الإصلاحات المناسبة. راجع بنية النشر أيضًا؛ إذ قد تؤثر ذاكرات التخزين المؤقت المشتركة وmiddleware واستخدام البرامج النصية والوكلاء العكسية في مستوى التعرض. ولا يثبت وجود سجل ثغرة أن كل تطبيق معرض للخطر بالطريقة نفسها.

الخطوة ٦: اختبر العقود قبل اختبار استدعاءات النماذج المدفوعة

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

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

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

أخيرًا، شغّل اختبارات البناء والنشر المعتادة للتطبيق باستخدام إصدار Next.js المحدد بدقة. اختبر المسار المنشور، وليس خادم التطوير فقط. تحقّق من عدم وجود الأسرار في ملفات المتصفح أو الاستجابات العامة، ومن توافق إعدادات الإنتاج مع التصميم المعتمد على الخادم.

الخطوة ٧: أصلح عيوب تنفيذ المسودة قبل إعادة استخدامها

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

تحتاج أمثلة shell المعروضة إلى فحص أيضًا. يستخدم أمر Git ignore رموزًا غير معتادة لأسطر جديدة، كما تفتقر أمثلة curl متعددة الأسطر إلى محارف استمرار السطر في shell كما عُرضت. لا تفترض أن كتلة الشيفرة تعمل لمجرد أنها تبدو منطقية. انسخها إلى بيئة نظيفة، وشغّلها، وأدرج الأمر الدقيق الذي ينجح. وبالمثل، تحقّق من نصوص الاختبار وlint مقابل إصدارات Next.js وأدواته المحددة، بدل افتراض استمرار صلاحية نص من قالب أقدم.

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

ما الذي يجب تأكيده قبل إضافة الميزات؟

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

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

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

المصادر وملاحظات التحقق

• Getting Started with Next.js: A Beginner’s Guide يصف Next.js بأنه إطار عمل مبني على React لتطبيقات الويب.
• KISS Sorcar يصف كتالوج النماذج متعدد المزوّدين وتبديل النموذج في كل استدعاء. وهذه قدرات خاصة بـ KISS Sorcar، وليست إثباتًا لتنفيذ هذا الشرح.
• NVD: CVE-2026-44572 يسرد نطاقات Next.js المتأثرة ويصف مشكلة التخزين المؤقت لإعادة التوجيه.
• NVD Next.js search results تتضمن الملخصات المقدّمة لكل من CVE-2026-44580 وCVE-2026-44581.

النسبة التحريرية: فِرق تحرير وهندسة Gate of AI، شركة GateOfAI، LLC.