هل تريد إنشاء موقع صغير أو تطبيق حسابي من وصف عربي دون البدء بملف كود فارغ؟ يتيح Qwen Coder بناء مشاريع ويب من وصف نصي، مع إمكانية نقل العمل إلى GitHub. لكن قد تصادف أيضًا اسم Qwen Code، وهو وكيل برمجي مفتوح المصدر يعمل من الطرفية والمحرر. الخلط بين الاسمين يجعل بعض الشروحات تعد المستخدم بميزات مجانية أو خطوات تثبيت لا تخص الخدمة التي فتحها.
في هذا الدليل سنشرح مسار المبتدئ في Qwen Coder على الويب، ثم مسار المطور عبر Qwen Code، مع تجربة مشروع عربي بسيط، وإرشادات لتحسين الأوامر واختبار الواجهة وتصحيح الأعطال وحماية المفاتيح. استندنا إلى صفحات Qwen الرسمية ومستودع المشروع، ولم ندّع اختبار اشتراك مدفوع أو إتمام مشروع حقيقي على حساب خاص.
الخلاصة: ابدأ بخدمة الويب إذا أردت تجربة فكرة تطبيق بسرعة، واستخدم Qwen Code إذا كنت ترغب في العمل على مشروع محلي ومستودع كود. لا تفترض أن الحصة المجانية القديمة في الطرفية ما زالت تعمل؛ انتهت طريقة Qwen OAuth المجانية في 15 أبريل 2026 وفق وثائق المطور.
ما هو Qwen Coder؟
إنشاء تطبيق من الوصف بدل البدء من الصفر
تعرض واجهة Qwen Coder خيارات لإنشاء موقع ومتجر تجريبي ولعبة Snake وأداة Pomodoro، مع مساحة لكتابة وصف التطبيق وإمكانية تصدير العمل إلى GitHub. هذا يجعلها نقطة انطلاق مناسبة لتحويل فكرة صغيرة إلى تصور قابل للتجربة. لا يعني نجاح المعاينة أن المشروع جاهز للاستخدام التجاري؛ فالتخزين والحسابات والأمان والنشر تحتاج إلى مراجعة مستقلة.
الفرق بين Qwen Coder وQwen Code
Qwen Coder اسم واجهة بناء التطبيقات على الويب في coder.qwen.ai. أما Qwen Code فهو وكيل برمجي مفتوح المصدر يمكن تشغيله في الطرفية أو المحرر أو سطح المكتب وبعض الواجهات الأخرى، مع إمكانية الاتصال بمزود نماذج. الأدوات مرتبطة بمنظومة Qwen لكنها ليست واجهة واحدة بحدود استخدام متطابقة.
هل يمكن استخدام العربية؟
يمكن أن تصف احتياجات التطبيق بالعربية وتطلب واجهة RTL، لكن هذا لا يعني أن جميع القوالب والتخطيطات والأرقام المختلطة بالإنجليزية ستظهر بصورة سليمة تلقائيًا. اختبر أسماء الأزرار، والرسائل، وتنسيق الوقت والعملات، والعرض على الهاتف. وأضف نصًا واضحًا في المواصفات مثل «الواجهة العربية من اليمين إلى اليسار» حتى لا يترك النظام الاتجاه الافتراضي للمتصفح.
شرح إنشاء موقع باستخدام Qwen Coder على الويب
1. افتح المنصة وحدد فكرة واضحة
ادخل إلى الموقع الرسمي واختر إنشاء مشروع ويب أو ابدأ من وصف. قد تتغير الواجهة ومتطلبات الحساب. لا تعتمد على قالب «متجر» إذا كنت تحتاج آلة حاسبة، بل اختر الفكرة الأقرب إلى هدفك. ابدأ بمشروع لا يحفظ بيانات شخصية أو معلومات دفع إلى أن تتحقق من طريقة التخزين والمصادقة.
2. اكتب وصف المشروع بوظائف محددة
مثال: «أنشئ تطبيق ويب عربيًا لحساب مصروفات رحلة. أدخل اسم البند والمبلغ بالدينار، واعرض جدول البنود والإجمالي وزر حذف. اجعل النصوص RTL، واحفظ البيانات محليًا إن أمكن، ولا تضف تسجيل دخول أو بوابة دفع». يعالج هذا الوصف الجمهور والحقول والسلوك وما لا تحتاج إليه، بدل عبارة عامة مثل «أنشئ تطبيقًا احترافيًا».
3. راجع التصميم الناتج قبل إضافة وظائف جديدة
افتح المعاينة، وأنشئ بندًا بقيمة 20 ثم آخر بقيمة 30، وتأكد أن الإجمالي يظهر 50. جرّب إدخال نص في حقل المبلغ أو تركه فارغًا. إذا فشل التحقق، اشرح الخطأ بالتفصيل: الصفحة والخطوات والنتيجة المتوقعة وما ظهر بالفعل. لا تطلب إعادة بناء المشروع كله بسبب رسالة خطأ واحدة.
4. اختبر حفظ البيانات والتوافق مع الهاتف
أعد تحميل الصفحة ثم أغلقها وأعد فتحها لتعرف هل بقيت البيانات. إذا كان الهدف استخدام التطبيق من أجهزة متعددة فالتخزين المحلي لا يكفي؛ ستحتاج إلى قاعدة بيانات ومصادقة مناسبة. جرّب العرض على شاشة ضيقة وتأكد أن جدول البنود لا يخرج خارجها، وأن أزرار الحذف تظل قابلة للنقر. وإذا احتجت بعد إضافة قاعدة البيانات إلى صياغة استعلامات من وصف مكتوب وفحص نتائجها، فراجع شرح AI2sql بالعربي لإنشاء استعلامات SQL ومراجعة النتائج.
5. صدّر المشروع أو شاركه بعد المراجعة
تذكر واجهة Qwen Coder إمكانية التصدير إلى GitHub. تأكد من ربط المستودع الصحيح ومن عدم نشر أي مفاتيح أو ملفات خاصة. فتح مستودع عام لا يساوي إطلاق موقع يعمل للجمهور؛ تحتاج إلى استضافة وإعدادات بناء ونطاق وربما قاعدة بيانات. اقرأ ملفات المشروع وتعليمات التشغيل قبل اختيار جهة النشر.
ما هو Qwen Code للمطورين؟
وكيل يستطيع قراءة المشروع وتغيير عدة ملفات
Qwen Code أداة وكيلة مفتوحة المصدر تتيح فهم ملفات المشروع واقتراح تعديلات وتشغيل أدوات برمجية ضمن الصلاحيات الممنوحة. يمكن استعمالها لتحديد مكان خطأ في صفحة، وإنشاء اختبار لوظيفة أو مراجعة تغيير متعدد الملفات. لكن قدرة الوكيل على إجراء العمليات تجعل مراجعة الأوامر والنتائج ضرورية، خصوصًا عند التعامل مع مستودعات تخص العملاء.
التثبيت من الطرفية بحسب النظام
يوصي الدليل الرسمي بمثبت مستقل للأنظمة المدعومة، مع إمكانية تثبيت حزمة qwen-code عبر npm لمن لديه Node.js 22 أو أحدث. لا تنفذ سكربت تثبيت من الإنترنت دون مراجعة المصدر والصلاحيات. ويمكن استعراض ملفات التثبيت في مستودع المشروع أولًا، وتثبيت نسخة مناسبة في بيئة تجريبية لا تحتوي على أسرار أو ملفات إنتاج مهمة.
بدء الجلسة وتحديد مزود النموذج
بعد التثبيت افتح طرفية داخل مجلد مشروع تجريبي، وشغّل الأمر qwen ثم خيار المصادقة /auth. تذكر وثائق المصادقة خيارات Alibaba ModelStudio وخططها، ومزودات خارجية ومزودًا مخصصًا. لا تفترض أن تسجيل الدخول إلى Qwen Coder على الويب يمنح رصيد API تلقائيًا في الطرفية.
تنبيه بشأن Qwen OAuth المجاني القديم
هذه نقطة غالبًا ما تتجاهلها شروحات قديمة: تؤكد الوثائق الرسمية أن الطريقة المجانية القديمة Qwen OAuth أُوقفت في 15 أبريل 2026، ولم تعد خيارًا متاحًا في قائمة /auth الجديدة. تحتاج إلى اختيار وسيلة مصادقة أو مزود صالح مع قراءة شروط الحصة والتكلفة. لا تُدخل مفتاح API في منشور عام أو لقطة شاشة تعليمية.
تجربة عملية: إنشاء أداة Pomodoro عربية
تحديد النطاق قبل أي كود
لنفترض أنك تريد مؤقت تركيز يعمل لمدة 25 دقيقة وراحة لمدة 5 دقائق. لا تحتاج قاعدة بيانات أو حساب مستخدم في المرحلة الأولى. اطلب صفحة واحدة فيها ساعة تنازلية وأزرار تشغيل وإيقاف وإعادة ضبط، مع عرض الحالة بالعربية والتنبيه عند انتهاء الجلسة إذا سمح المتصفح. احصر المتطلبات كي تعرف إن كانت الأداة تعمل فعلًا.
طلب جاهز يمكن نسخه وتعديله
«ابنِ أداة Pomodoro عربية متجاوبة. وقت التركيز الافتراضي 25 دقيقة والراحة 5 دقائق. وفر تشغيلًا وإيقافًا مؤقتًا وإعادة ضبط واختيار المدة. لا ترسل بيانات إلى أي خادم. ضع أسماء الأزرار بالعربية واتجاه RTL، وأضف التحقق من المدخلات ومنع المدة السالبة أو الصفرية». هذا الوصف يحقق فائدة أكثر من مطالبة الأداة بواجهة تشبه تطبيقًا مشهورًا فقط.
اختبارات يجب إجراؤها بعد الإنشاء
ابدأ مؤقتًا لثوانٍ ثم أوقفه واستأنفه. تأكد ألا يتضاعف العد عند الضغط مرتين، وألا تتحول الثواني إلى قيمة سالبة. اختبر تغيير مدة التركيز أثناء الجلسة، وتحديث الصفحة، وعودة التبويب بعد تركه فترة. في مشاريع المؤقتات، دقة حساب الوقت وفصل حالة التشغيل أهم من مظهر زر التشغيل وحده.
مراجعة النسخة العربية قبل النشر
افتح الأداة على هاتف، وجرب نصوصًا طويلة أو تكبير الخط، وألق نظرة على صف الأزرار. يجب ألا يتداخل نص «إيقاف مؤقت» مع أيقونة الساعة أو يختفي عند شاشة ضيقة. إذا احتجت إلى إضافة وضع داكن فاطلبه كمرحلة مستقلة مع اختبار التباين وسهولة القراءة. لا تخلط بين اختبار الوظيفة وتصميم الألوان.
كيفية تحسين الأوامر والحصول على كود قابل للصيانة
اكتب الهدف وحالة الخطأ والقيود
قبل مطالبة Qwen Code بإصلاح خطأ، اشرح ما الذي يحدث بالفعل وما الذي يجب أن يحدث، مع خطوات لإعادة المشكلة. مثال: «عند حذف آخر بند يبقى الإجمالي القديم حتى تحديث الصفحة. أصلح الحالة دون تغيير وظيفة إضافة البنود، وأضف اختبارًا». الطلب المحدد يقلل تغييرات جانبية لا داعي لها.
اطلب خطة قبل تغييرات كبيرة
في مستودع كبير اطلب أولًا تحديد الملفات المتأثرة وخطوات الإصلاح والاختبارات التي ينبغي تشغيلها. بعد مراجعة الخطة اسمح بتنفيذ جزء واحد وتفقد فرق الملفات في Git. لا تمنح الوكيل حرية تحديث عشرات الاعتماديات أو حذف مجلدات لمجرد تحسين الكود؛ التحسين غير المبرر قد يزيد التعقيد ويكسر ميزات تعمل.
احتفظ بنقطة رجوع واضحة
استخدم نظام التحكم بالإصدارات واحفظ تغييراتك قبل بدء تعديل آلي واسع. بعد انتهاء الوكيل، راجع الملفات المضافة والحزم والصلاحيات، ثم شغّل اختبارات مستقلة. إذا لم تفهم سبب وجود ملف جديد أو أمر بناء، اسأل عن ضرورته قبل الدمج. النجاح الحقيقي هو مشروع يمكن اختباره وصيانته وليس حجم الكود الناتج.
العمل مع GitHub والخصوصية والأمان
الفرق بين مشاركة المشروع ونشره
يتيح Qwen Coder التصدير إلى GitHub، لكن ذلك ينقل ملفات المشروع إلى مستودع ولا ينشره بالضرورة على نطاق عام. تأكد من اختيار مستودع خاص عند الحاجة، ومن أن ملفات الأسرار مستبعدة. إذا كان المشروع يحتوي صورة عميل أو بيانات حقيقية، افحص سياسة الأذونات والتخزين لدى الخدمة قبل ربطها.
لا تضع كلمات مرور في الكود
إذا احتجت ربط API أو قاعدة بيانات، استخدم متغيرات بيئية على الخادم، ولا تضع مفاتيح الوصول في JavaScript المتاح للزوار أو في صور الدروس. جرب أولًا مفاتيح محدودة الصلاحيات وبيئة اختبار. قد ينشئ الوكيل تكاملًا يبدو جاهزًا لكنه يكشف أسرارًا إذا نُشر دون مراجعة بشرية.
تحقق من الملفات التي يطلب الوكيل تعديلها
قبل الموافقة على تشغيل أمر حذف أو تنزيل أو تشغيل حزمة خارجية، تأكد من مصدره وأثره. لا تفتح مستودعات مجهولة على جهاز يحتوي بيانات حساسة باستخدام صلاحيات مدير. صلاحية قراءة الكود ليست مبررًا للسماح بتشغيل أوامر على ملفات غير مرتبطة بالمهمة.
هل Qwen Coder مجاني؟ وما حدود الخطط؟
خدمة الويب ليست مساوية لحصة الطرفية
قد تتيح واجهة Qwen Coder إنشاء مشروع تجريبي في المتصفح، لكن حدود الرسائل والتوليد والنشر قد تتغير بحسب الحساب. لا تنقل حصة نموذج آخر في qwen.ai على أنها رصيد مضمون لخدمة coder.qwen.ai. افحص شاشة الحساب، وما إذا كانت المعاينة والتصدير والنشر تحتاج اشتراكًا منفصلًا.
تكاليف Qwen Code المفتوح المصدر
الكود نفسه مفتوح، لكن تشغيل الوكيل قد يتصل بخدمة نماذج مدفوعة أو مزود محلي. تتفاوت التكلفة حسب نموذج الاستدلال وعدد الرموز وحجم الملفات والاختبارات. انتبه إلى اختلاف خطط Alibaba ModelStudio بين Coding Plan وToken Plan ومفتاح API العادي، وإلى أن المصادقة المجانية القديمة Qwen OAuth لم تعد متاحة.
كيفية اختيار مسار يوفر المال
إذا أردت إثبات فكرة واجهة أولية، فابدأ بمشروع واحد بسيط وقيّم التصدير قبل شراء اشتراك. أما عند العمل على مستودع يوميًا، فاحسب تكلفة جلسات الإصلاح والفهم والاختبارات، وليس سعر التوليد الأول. لا تفعّل خدمة استهلاك تلقائي قبل تحديد سقف إنفاق واختبار نتيجة نموذجية.
مقارنة Qwen Coder بمسارات برمجة أخرى
لمن يناسب إنشاء التطبيقات من المتصفح؟
إذا كانت أولويتك بناء واجهة وتجربتها دون إعداد طرفية أو مستودع، ابدأ بخدمة Qwen Coder أو أي خدمة بناء تعتمد الوصف. للمقارنة بين مسارات إنشاء التطبيقات يمكنك قراءة دليل Lovable وBolt وReplit المنشور، الذي يركز على تجربة البناء والاستضافة والنشر ولا يكرر شرح Qwen هنا.
لمن يناسب الوكيل داخل محرر الكود؟
إذا كنت تتعامل مع مشروع قائم وتريد إصلاح اختبارات أو مراجعة كود، فQwen Code ووكلاء التطوير المشابهون أكثر ملاءمة للتجربة. يتوفر في AIFekra أيضًا شرح Mistral Vibe للمقارنة بين أسلوب الوكيل وواجهاته دون إعادة شرح هذا المقال.
ما المعيار الصحيح للاختيار؟
اختبر مهمة واحدة ومخرجاتها: هل بقيت القيم بعد تحديث الصفحة؟ هل احترمت الواجهة RTL؟ هل يسهل نقل الملفات؟ وهل تسمح صلاحيات الخطة والتراخيص بتشغيل التطبيق؟ لا تجعل عدد الميزات المعلن وحده سبب الترقية؛ فالمهم حصولك على مشروع صغير يعمل ويمكنك إصلاحه.
