Install
npx ai-elements@latestلمن هذا الدليل
هذا الدليل لمطوّري الواجهات الذين يريدون بناء واجهات تطبيقات أصلية للذكاء الاصطناعي أسرع فوق shadcn/ui. رسميًا يُكتب AI Elements كمكتبة مكوّنات مبنية على shadcn/ui.
قبل البدء يجب أن تتحقق معًا: Node.js 18 or later؛ مشروع Next.js قائم فيه AI SDK مثبت؛ shadcn/ui مهيأ أصلًا في المشروع (الصفحة تكتب npx shadcn@latest init). يجب أيضًا ضبط Tailwind CSS، وAI Elements يدعم CSS Variables mode فقط. إن نقص بند فلا تشغّل التثبيت.
هذا تثبيت مكوّنات وليس إضافة سوق Agent. لا تعمم npx ai-elements@latest إلى إضافة IDE غير ظاهرة.
إكمال أول محاولة في 3 دقائق
استخدم فقط أمر التثبيت الموصى به الوارد في الصفحة:
npx ai-elements@latest
الشرط المسبق: الدليل الحالي هو مشروع Next.js ذلك الذي هُيئ فيه shadcn/ui وثُبّت AI SDK؛ Node.js هو 18+؛ وTailwind في وضع CSS Variables. موضع التثبيت هو دليل components المضبوط لديك، إضافة إلى اعتماديات المشروع.
نقطة تأكيد الأثر الجانبي: الصفحة تنص على أن تثبيت كل المكوّنات سيقوم بـ: Set up shadcn/ui إن لم يكن مضبوطًا؛ تثبيت كل مكوّنات AI Elements في دليل components المضبوط؛ وإضافة الاعتماديات اللازمة إلى المشروع. هذا يغيّر ملفات واعتماديات package. إذا كان الدليل خاطئًا، أو أردت مراجعة الشروط أولًا، فتوقف. أكّد ثم نفّذ.
إشارة النجاح: ينتهي الأمر بشكل طبيعي، وتظهر مكوّنات جديدة في دليل components، وتُكتب الاعتماديات. المحاولة الأولى فحص فقط: افتح أحد ملفات المكوّنات المثبتة حديثًا وأكّد أنه وقع في الدليل المضبوط. لا تصله فورًا بصفحة محادثة أو مسار إنتاج غير ظاهر في المقتطف. إذا أراد المعالج تغيير مزيد من الملفات، فتوقف عند نقطة التأكيد.
حالات الاستخدام
الحالة 1: تنفيذ التثبيت الرسمي في مشروع يستوفي الشروط. بعد تأكيد Node.js 18+ وNext.js + AI SDK واكتمال npx shadcn@latest init وكون Tailwind في CSS Variables mode، نفّذ npx ai-elements@latest. الدليل يغطي هذا الأمر الموصى به وقائمة الشروط. معيار الإنجاز يتوقف عند نجاح التثبيت ودخول المكوّنات إلى الدليل المضبوط. لا تضف أسماء مكوّنات منفردة أو URL سجل غير ظاهرين.
الحالة 2: انظر أولًا ماذا سيفعل «تثبيت كل المكوّنات» ثم قرر المتابعة. المقتطف ينص على أنه سيضبط shadcn/ui عند الحاجة، ويثبّت كل AI Elements في دليل components، ويضيف الاعتماديات اللازمة. في المحاولة الأولى، إن لم تكن جاهزًا لقبول هذه الكتابات فلا تشغّل الأمر؛ راجع فقط ما إذا كانت الآثار الثلاثة مقبولة. إشارة النجاح القابلة للملاحظة هي أن تقارن حال المشروع وتؤكد أن shadcn مهيأ ودليل components المستهدف موجود. لا تقرأ «تثبيت الكل» كإذن لتجاوز حد Tailwind CSS Variables.
حدود الاستخدام
مسار التثبيت الأساسي هو فقط npx ai-elements@latest. npx shadcn@latest init شرط مسبق وليس مثبّتًا أساسيًا ثانيًا. يلزم Node.js 18+ وNext.js + AI SDK وshadcn/ui مهيأ، وTailwind يدعم CSS Variables mode فقط. التثبيت يغيّر دليل المكوّنات والاعتماديات. إلغاء التثبيت واختيار المكوّن الواحد غير مكتوبين ولا يُتخذان خلاصة أمان.