ورشة مجانية 21–22.11ورشة مجانية لمدة يومين في Vibecoding يومي 21–22 نوفمبر الساعة 16:00 بتوقيت موسكو · الدفعة 3 تبدأ 23.11سجّل مجاناً ←الدفعة 3 (23.11)
إصدارAPI / منتج · جاهز للعملHabr AI→ المصدر

مكتبة vue-llm تشغّل دردشة ذكاء اصطناعي على Vue مباشرة في المتصفح: نموذج من 400 ميغابايت

تُكتب الأدوات الجاهزة لدردشات الذكاء الاصطناعي في الغالب لـ React، أما في Vue وNuxt فكان على المطوّرين بناء بث الإجابة واستدعاءات الأدوات يدويًا. تقدّم مكتبة vue-llm لهذا الغرض الـ composable المسمّى useChat، وهو يعمل مع OpenAI وAnthropic وGemini وOllama. وهناك أيضًا وضع بلا خادم: يعمل النموذج داخل المتصفح على بطاقة الرسوميات عبر WebGPU، والتحميل الأول من 400 ميغابايت، ثم يُحمَّل من الذاكرة المؤقتة خلال ثانية أو ثانيتين. وبالنسبة لفرق Vue، فهذا أساس جاهز بدلًا من حل مكتوب ذاتيًا.

معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
مكتبة vue-llm تشغّل دردشة ذكاء اصطناعي على Vue مباشرة في المتصفح: نموذج من 400 ميغابايت
المصدر: Habr AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليHabr AI ↗
رئيس التحرير
حقيقة رئيسية #1ترخيص MIT، الإصدار 1.3، ولا تعتمد وقت التشغيل إلا على Vue
حقيقة رئيسية #2يبقى مفتاح API على الخادم، وفي المثال حدّ قدره 30 طلبًا في الدقيقة
حقيقة رئيسية #3تمتلئ البطاقة بالإجابة بينما لا يزال النموذج يكتب استدعاء الأداة

إذا كنت قد بنيت ميزة ذكاء اصطناعي على Vue (إطار الواجهات الأمامية الشائع) أو على Nuxt (امتداده لبناء المواقع المتكاملة)، فالأرجح أنك واجهت المشكلة نفسها: فمعظم الأدوات الجاهزة لدردشات النماذج اللغوية مكتوبة لـ React. وفي Vue يتعيّن تكييفها، أو كتابة البث (عرض الإجابة أثناء توليدها لا دفعة واحدة) واستدعاء الأدوات وحالة المحادثة يدويًا. أطلق مطوّر مكتبة vue-llm مفتوحة المصدر تتولى هذا العمل الروتيني لـ Vue 3 وNuxt وحتى Vue 2.7. أوضح سيناريو لها: نموذج صغير يعمل مباشرة في متصفح المستخدم على بطاقته الرسومية عبر WebGPU. بلا خادم ولا مفتاح API، لكن مع تحميل لمرة واحدة لنموذج حجمه من 400 ميغابايت. تُوزَّع المكتبة بترخيص MIT، وإصدارها الحالي 1.3، ولا تجلب وقت التشغيل أي تبعيات سوى Vue نفسه.

دردشة في عشرة أسطر ومفتاح على الخادم

أساس المكتبة هو الـ composable المسمّى useChat. فهو يعرض إجابة النموذج رمزًا بعد رمز داخل حالة تفاعلية: الرسائل، والحالة، والخطأ، والإلغاء، وإعادة التوليد. وتتكوّن الرسائل من «أجزاء»: نص، واستدلالات النموذج، واستدعاءات الأدوات، وملفات، ومصادر. لذلك يعرض قالب واحد الإجابة العادية واستدلالات Claude أو Qwen3 واستدعاء الأداة.

يبقى مفتاح API على الخادم. والجزء الخادمي معالج عادي من نوع Request → Response وفق معيار الويب. ويعمل في Nuxt/Nitro وNode وBun وDeno وبيئات edge. وفي مثال المؤلف يُفعَّل هناك أيضًا حدّ قدره 30 طلبًا في الدقيقة. وهذه تفصيلة مفيدة للإنتاج: ففي غيابها تتحوّل الدردشة العامة سريعًا إلى وصول مجاني لغيرك على حسابك من الرموز.

تُدعَم جاهزةً OpenAI وأي واجهة API متوافقة مع OpenAI، وAnthropic، وGoogle Gemini، وOllama. وإذا كان لديك خادم خلفي خاص مع بث، فإن createSSEProvider يربط useChat به. تصف أنت كيف تتحوّل أحداث SSE لديك إلى أجزاء من الإجابة، ويعمل الباقي كالمعتاد.

Generative UI والإنسان في الحلقة

أكثر الأجزاء إثارة هو Generative UI. فعندما يستدعي النموذج أداة، يمكن عرض مكوّن Vue الخاص بك بدلًا من النص. وتُبثّ الوسائط إلى المكوّن أثناء التوليد: تبدأ بطاقة الطقس بالامتلاء بينما لا يزال النموذج يكمل كتابة الاستدعاء. ولكي يعمل ذلك، اضطر المؤلف إلى كتابة محلّل لـ JSON «غير المكتمل». فالسلسلة {"city":"Мос تتحوّل إلى { city: 'Мос' }، وتُهمَل المفاتيح غير المكتملة إلى أن يكتمل كتابتها.

الأداة التي لها دالة execute تُنفَّذ من تلقاء نفسها. أما الأداة التي تخلو منها فتوقف الدردشة مؤقتًا وتنتظر ردًّا من الواجهة. وبهذه الطريقة يُبنى نمط human-in-the-loop، حين يتخذ الإنسان القرار. مثلًا: يقترح النموذج حجز طاولة، فيضغط المستخدم «تأكيد» في البطاقة، وينقل addToolResult الإجابة، وتستمر المحادثة. وفي الإجراءات التي لا رجعة فيها (الدفع، وإرسال رسالة، والحذف) يُعدّ هذا أكثر موثوقية من أن تطلب من النموذج في الـ prompt «اطلب الإذن».

النماذج في المتصفح واقتصاديات الرموز

يشغّل المزوّد createWebLLM نماذج مفتوحة (Llama 3.2 وQwen وSmolLM وPhi) على WebGPU عبر WebLLM. لا حاجة إلى خادم أو مفتاح، ولا تغادر البيانات الجهاز. وفي الشيفرة يتغيّر المزوّد فقط، ويبقى useChat كما هو مع OpenAI.

من زاوية التكلفة، هذه خطوة لافتة. فالمهام البسيطة مثل إعادة الصياغة أو التصنيف أو الإكمال التلقائي القصير يمكن تسليمها إلى نموذج محلي دون دفع ثمن كل رمز. ويقترح المؤلف أيضًا نهجًا هجينًا: إعطاء المستخدمين الذين لا يملكون WebGPU نموذجًا خادميًا، والباقين نموذجًا محليًا. وثمن هذا النهج هو التحميل الأول من 400 ميغابايت. بعد ذلك يُؤخذ النموذج من ذاكرة المتصفح المؤقتة خلال ثانية أو ثانيتين. لكن النماذج المدمجة مثل Llama 3.2 1B في صيغتها المكمّمة أضعف بوضوح من النماذج السحابية الرائدة، لذا يُفضَّل ترك الاستدلال المعقّد والسياق الطويل للخادم.

الواجهة وDevTools وNuxt

صُمِّمت المكتبة بنهج هجين. ففي npm توجد المنطق headless (بلا تنسيق جاهز): usePromptInput وuseAutoScroll. وهما تعالجان تفاصيل مزعجة: تمرير تلقائي لا يزعج المستخدم الذي يتصفح إلى الأعلى؛ وزر Enter الذي لا يرسل الرسالة أثناء الكتابة بالصينية أو اليابانية؛ ولصق الصور من الحافظة وسحب الملفات وإفلاتها. أما المكوّنات الجاهزة فتُنسخ إلى المشروع بأمر shadcn-vue، وبعدها تصبح الشيفرة ملكًا لك. وهي تستخدم رموز سمة shadcn، لذلك تتكيّف مع بقية الواجهة، بما فيها الوضع الداكن.

وللتصحيح توجد وحدة vue-llm/devtools: ففي تبويب LLM داخل Vue DevTools تظهر كل نسخ useChat، والرموز، والزمن حتى أول رمز، وسرعة التوليد، واستدعاءات الأدوات، والخط الزمني للطلبات. وبدون هذه الإضافة لا تتتبّع المكتبة شيئًا ولا تُنفق موارد على ذلك. أما وحدة Nuxt فتُثبَّت بأمر واحد، وتوفّر الاستيراد التلقائي للـ composables والمزوّدين، وقد جرى اختبارها على Nuxt 3 و4.

القيود وما بعد ذلك

يقارن المؤلف مشروعه بحزم AI SDK الجاهزة ويصفه بأنه Vue-first. وتتمثل الفروق في وحدة Nuxt، ومكوّنات Generative UI، وDevTools، ومزوّد للنماذج داخل المتصفح، ومحوّل لخادم SSE الخلفي القائم، ودعم Vue 2.7 للـ composables، وهو أمر مهم للوحات الإدارة القديمة. ومع ذلك فالمشروع حديث ويتولاه مطوّر واحد، لذا فإن نضج منظومته لا يزال غير قابل للمقارنة بنظائره في React. وقبل اعتماده يجدر التحقق من سلوك مزوّديك وسيناريوهاتك تحت حمل حقيقي.

وفي الخطة عميل MCP لربط خوادم MCP كأدوات، وإجابات مع اقتباسات لـ RAG، وإدخال صوتي. وبالنسبة لفرق Vue التي تحتاج إلى دردشة أو واجهة وكلاء، تتيح بيئة التجربة التي لا تتطلب مفتاح API تقييم هذا النهج في بضع دقائق.

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول دردشة في عشرة أسطر ومفتاح على الخادم؟

أساس المكتبة هو الـ composable المسمّى useChat. فهو يعرض إجابة النموذج رمزًا بعد رمز داخل حالة تفاعلية: الرسائل، والحالة، والخطأ، والإلغاء، وإعادة التوليد. وتتكوّن الرسائل من «أجزاء»: نص، واستدلالات النموذج، واستدعاءات الأدوات، وملفات، ومصادر. لذلك يعرض قالب واحد الإجابة العادية واستدلالات Claude أو Qwen3 واستدعاء الأداة. يبقى مفتاح API على الخادم. والجزء الخادمي معالج عادي من نوع Request → Response وفق معيار الويب. ويعمل في Nuxt/Nitro وNode وBun وDeno وبيئات edge.

ما أبرز التفاصيل حول Generative UI والإنسان في الحلقة؟

أكثر الأجزاء إثارة هو Generative UI. فعندما يستدعي النموذج أداة، يمكن عرض مكوّن Vue الخاص بك بدلًا من النص. وتُبثّ الوسائط إلى المكوّن أثناء التوليد: تبدأ بطاقة الطقس بالامتلاء بينما لا يزال النموذج يكمل كتابة الاستدعاء. ولكي يعمل ذلك، اضطر المؤلف إلى كتابة محلّل لـ JSON «غير المكتمل». فالسلسلة {"city":"Мос تتحوّل إلى { city: 'Мос' }، وتُهمَل المفاتيح غير المكتملة إلى أن يكتمل كتابتها. الأداة التي لها دالة execute تُنفَّذ من تلقاء نفسها. أما الأداة التي تخلو منها فتوقف الدردشة مؤقتًا وتنتظر ردًّا من الواجهة.

ما أبرز التفاصيل حول النماذج في المتصفح واقتصاديات الرموز؟

يشغّل المزوّد createWebLLM نماذج مفتوحة (Llama 3.2 وQwen وSmolLM وPhi) على WebGPU عبر WebLLM. لا حاجة إلى خادم أو مفتاح، ولا تغادر البيانات الجهاز. وفي الشيفرة يتغيّر المزوّد فقط، ويبقى useChat كما هو مع OpenAI. من زاوية التكلفة، هذه خطوة لافتة. فالمهام البسيطة مثل إعادة الصياغة أو التصنيف أو الإكمال التلقائي القصير يمكن تسليمها إلى نموذج محلي دون دفع ثمن كل رمز. ويقترح المؤلف أيضًا نهجًا هجينًا: إعطاء المستخدمين الذين لا يملكون WebGPU نموذجًا خادميًا، والباقين نموذجًا محليًا.

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Unified AI Workspace · Nomad

Test Frontier LLMs & Autonomous Agents in One Workspace

Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.

Try Nomad AI →Launch Nomad Agent
ما رأيك؟
جارٍ تحميل التعليقات…