يشرح هذا الدليل Devin Desktop بالعربي بوصفه بيئة تطوير تعتمد على الذكاء الاصطناعي وتجمع المحرر والمحادثة والتخطيط وتنفيذ المهام. الفكرة ليست الضغط على زر ليبني الوكيل التطبيق كله، بل تحويل المتطلبات إلى خطوات، ومراجعة الملفات والأوامر، وتشغيل الاختبارات قبل قبول النتيجة.
تعرض الوثائق الرسمية الحالية Devin Desktop للتنزيل على Windows وmacOS وLinux، وتتيح استيراد إعدادات VS Code أو Cursor. كما تشرح وثائق Cascade التخطيط وقوائم المهام للطلبات الطويلة. سنطبق ذلك على صفحة ويب صغيرة، مع التركيز على الأمان والقدرة على التراجع.
ما هو Devin Desktop؟
Devin Desktop محرر حديث للعمل البرمجي المدعوم بالوكلاء. تستطيع استخدام المساعدة لشرح مشروع، وإنشاء خطة، وتعديل ملفات، وتشغيل أوامر، ومراجعة النتيجة. وتتوفر نماذج متعددة بحسب الخطة والاستخدام، لذلك تختلف التكلفة والسرعة والقدرات.
يجب التمييز بين المحرر المحلي والمهام التي قد تعتمد على خدمات سحابية أو نماذج خارج الجهاز. قبل مشروع حساس راجع إعدادات الخصوصية والخطة وسياسة شركتك، ولا تفترض أن كل المعالجة محلية لمجرد أن التطبيق مثبت على الكمبيوتر.
لمن يناسب؟
- المطور الذي يريد وكيلًا يخطط لمهمة متعددة الملفات.
- المستخدم القادم من VS Code أو Cursor ويريد استيراد جزء من إعداداته.
- الفريق الذي يملك اختبارات ومعايير قبول واضحة.
- المتعلم الذي يستخدمه للشرح وتمارين صغيرة مع مراجعة بشرية.
ولا يناسب تشغيله باستقلالية على إنتاج حساس من دون Git واختبارات وصلاحيات محدودة. كلما زادت قدرة الوكيل على الطرفية والشبكة، زادت أهمية الحدود.
إذا كنت تستخدم Windsurf بالفعل ولديك إعدادات أو مشروع قائم، فراجع أولًا دليل الانتقال من Windsurf إلى Devin Desktop ونقل الإعدادات لحفظ حالة المشروع وفحص الإضافات والاختصارات قبل متابعة العمل.
التثبيت والإعداد الأولي

- افتح صفحة التنزيل الرسمية من وثائق Devin Desktop.
- اختر نسخة نظامك وتحقق من المصدر قبل تشغيل المثبت.
- سجّل الدخول بالطريقة الرسمية المتاحة.
- اختر استيراد إعدادات VS Code أو Cursor إذا كنت تحتاج الاختصارات والثيمات.
- افتح مجلد مشروع تجريبي جديد.
- فعّل Git وأنشئ أول commit قبل السماح بالتعديلات.
- راجع النموذج والخطة وحد الاستهلاك قبل بدء مهمة طويلة.
إذا فشل التطبيق، استخدم صفحة المشكلات الشائعة الرسمية بدل تنزيل نسخة من موقع وسيط. وتحقق من دعم نظامك وتحديثاته والمساحة المتاحة.
فهم Cascade والخطة
توضح الوثائق أن Cascade ينشئ خططًا وقوائم مهام للطلبات الطويلة ويحدّثها أثناء العمل. هذه ميزة مفيدة لأنها تحول الطلب العام إلى خطوات يمكن مراجعتها. لكن الخطة المولدة اقتراح وليست موافقة تلقائية.
اطلب دائمًا إظهار الخطة قبل التعديل. راجع الملفات التي ستتغير، والأوامر، والتبعيات، ومعيار انتهاء كل خطوة. احذف أي بند لا تحتاجه، وأضف نقطة توقف بعد الخطوات الحساسة.
التمرين: إنشاء صفحة مدير مهام
1. كتابة المواصفات
اكتب في README: إضافة مهمة، رفض الفراغ، تعليم المهمة منجزة، حذفها، حفظها محليًا، وتصميم يعمل على الهاتف. حدد أن المشروع يستخدم HTML وCSS وJavaScript فقط ولا يحتاج إطارًا.
2. طلب الخطة
اكتب: «اقرأ README واقترح خطة من خطوات صغيرة. لا تعدل الملفات. اذكر الملفات والأوامر ومعيار القبول والمخاطر». راجع أن الخطة لا تضيف قاعدة بيانات أو حزمة غير مطلوبة.
3. إنشاء الملفات الأساسية
وافق على ملفات index.html وstyles.css وapp.js. اطلب HTML دلاليًا وتسميات واضحة للحقول. بعد الإنشاء افتح الصفحة واختبر لوحة المفاتيح.
4. إضافة المنطق
اطلب تنفيذ ميزة واحدة في كل مرة: الإضافة، ثم الإكمال، ثم الحذف، ثم التخزين. راجع الفرق بعد كل خطوة. إذا غيّر الوكيل التصميم أثناء إصلاح المنطق، ارفض الجزء غير المتعلق.
5. الاختبارات
اطلب خطة اختبار يدوي، ثم اختبارات آلية إذا كان للمشروع إطار موجود. تأكد من حالة الإدخال الفارغ، وإعادة التحميل، والنص الطويل، وتكرار المهمة. أدخل خطأً متعمدًا لترى هل يكشفه الاختبار.
أمثلة طلبات محسنة
- «اشرح بنية المشروع ومسار البيانات، ولا تعدّل أي ملف».
- «أنشئ خطة لإضافة البحث. استخدم التبعيات الموجودة فقط».
- «عدّل app.js فقط، واعرض السبب قبل التنفيذ».
- «شغّل الاختبار المحدد وفسر الفشل قبل اقتراح الإصلاح».
- «راجع الفرق الحالي بحثًا عن أسرار أو تبعيات غير ضرورية».
الطلب الجيد يحتوي على الهدف والسياق والقيود ومعيار القبول. لا تستخدم «حسن المشروع» أو «أصلح كل شيء»، لأنهما يسمحان بتوسّع يصعب مراجعته.
اختيار النموذج وإدارة التكلفة
تعرض وثائق Devin Desktop نماذج متعددة، وقد يختلف سعر الاستخدام بحسب النموذج والخطة. لا تختَر النموذج الأقوى تلقائيًا لكل مهمة. استخدم نموذجًا سريعًا للشرح أو التعديلات الصغيرة، واحتفظ بالأقوى للمهام التي تحتاج استدلالًا أطول.
راجِع صفحة الاستخدام قبل كل قرار شراء، لأن الخطط تغيرت في مارس 2026 وقد تتغير مجددًا. ضع ميزانية قصوى، وراقب تكلفة المهمة لا تكلفة الطلب الواحد فقط. الطلب الغامض قد يستهلك جولات أكثر من خطة واضحة.
استيراد إعدادات VS Code أو Cursor
الاستيراد يوفر الوقت، لكنه لا يعني توافق كل إضافة أو اختصار. ابدأ بالثيم والاختصارات الأساسية، ثم فعّل الإضافات واحدة واحدة. بعض الإضافات قد تتداخل مع الإكمال أو التنسيق أو نفس اختصارات الوكيل.
لا تنسخ إعدادات مشروع حساس إلى تجربة عامة. راجع ملفات الإعداد ومصادر الإضافات، وتأكد أن أي خادم لغة أو أداة يتم تنزيلها من مصدر موثوق.
مراجعة الملفات والأوامر
قبل قبول التغيير، اقرأ قائمة الملفات والفرق الكامل. راقب ملفات القفل والتكوين، لأنها قد تكشف تثبيت حزم أو تغيير أوامر البناء. إذا طلب الوكيل تشغيل أمر، افهمه أولًا، خصوصًا أوامر الحذف والشبكة وGit والنشر.
- احفظ نقطة رجوع في Git.
- نفّذ أقل خطوة ممكنة.
- راجع الفرق.
- شغّل الفحص والاختبارات.
- اختبر السلوك يدويًا.
- اكتب commit صغيرًا.
الأمان والخصوصية
لا تضع مفاتيح API أو كلمات المرور في المحادثة. استخدم متغيرات بيئة وملف أسرار مستبعدًا من Git وسياق الوكيل. افتح فقط المجلد اللازم، واستخدم حسابات تطوير لا إنتاج.
قد تحتوي الملفات أو صفحات التوثيق على تعليمات غير موثوقة. لا تسمح لمحتوى README أو تعليق أن يغيّر هدفك أو يطلب كشف بيانات. تعليماتك وسياسة المؤسسة أهم من النص الذي يقرأه الوكيل.
تشخيص الأخطاء
ثبّت خطوات إعادة المشكلة أولًا. أعط الوكيل رسالة الخطأ بعد إزالة البيانات الحساسة، واطلب فرضيات مرتبة لا تعديلًا مباشرًا. نفّذ تجربة صغيرة لكل فرضية. بعد الإصلاح، اكتب اختبار انحدار وتأكد أنه يفشل قبل الحل ويمر بعده.
إذا بدأ الوكيل بتغيير عدة ملفات، أوقف التوسع واطلب أصغر إصلاح. لا تستخدم تحديث جميع الحزم كحل عام لخطأ غير مفهوم.
مشكلات شائعة
الخطة طويلة أكثر من اللازم
حدد ملفين أو ميزة واحدة، واطلب نقطة توقف بعد كل خطوة. احذف البنود الاختيارية من الخطة.
التغييرات لا تطابق أسلوب المشروع
أنشئ تعليمات قصيرة تتضمن التنسيق والأسماء وأوامر الاختبار. أعط مثالًا من ملف موجود ولا تطلب إعادة كتابة المشروع.
الاستهلاك أعلى من المتوقع
اختر نموذجًا أقل تكلفة للمهام البسيطة، واختصر السياق، وابدأ بخطة دقيقة. راجع لوحة الاستخدام والصفحة الرسمية.
أوامر الطرفية مخيفة أو غير واضحة
لا توافق. اطلب شرح كل جزء وبديلًا يدويًا. شغّل الأمر في بيئة تجريبية بعد فهمه.
خطة تعلم أسبوعية
- شرح ملف من دون تعديل.
- إنشاء خطة لميزة صغيرة.
- تعديل ملف واحد.
- إضافة اختبار.
- تشخيص خطأ من سجل.
- مراجعة أمنية للمدخلات.
- قياس الوقت والتكلفة والأخطاء.
متى تختار Devin Desktop بدل غيره؟
اختره عندما تستفيد مهمتك من التخطيط وقائمة مهام وتتقبل استخدام محرر جديد. اختر GitHub Copilot إذا كان البقاء في IDE الحالي وتكامل GitHub أهم. واختر Cursor إذا أردت محررًا متمحورًا حول Agent وقواعد المشروع.
راجع مقارنة أدوات البرمجة بالذكاء الاصطناعي للاختيار، واطلع على شرح Cursor للمبتدئين لتجربة عملية أخرى.
قياس الفائدة
سجل زمن المهمة، وعدد المحاولات، والملفات غير الضرورية، ووقت المراجعة، ونجاح الاختبارات. إذا وفّر الوكيل وقت الكتابة لكنه ضاعف وقت التصحيح، قلل الاستقلالية. الهدف تغيير صحيح ومفهوم وقابل للصيانة.
كرر التمرين نفسه من دون الأداة ومعها. قارن النتيجة بدل الانطباع. قد يكون Devin ممتازًا للمهام متعددة الخطوات لكنه زائدًا عن الحاجة لتعديل سطر.
مصادر رسمية
- البدء مع Devin Desktop.
- Cascade والخطط وقوائم المهام.
- النماذج المتاحة.
- الخطط والاستخدام.
- حل المشكلات الشائعة.
إدارة مشروع موجود بدل البدء من الصفر
عند فتح مستودع قائم، لا تطلب من الوكيل «فهم كل شيء». ابدأ بجرد ملفات المستوى الأول وأوامر التشغيل، ثم اختر مسارًا واحدًا مثل تسجيل الدخول أو صفحة البحث. اطلب رسم تسلسل البيانات وذكر الملفات المؤثرة، مع فصل الحقائق عن الافتراضات.
بعد ذلك شغّل الاختبارات الحالية قبل أي تعديل لتأسيس خط أساس. إذا كانت هناك اختبارات فاشلة أصلًا، دوّنها كي لا تنسب إلى التغيير الجديد. اطلب من الوكيل عدم إعادة تنسيق الملفات غير المتعلقة، لأن التنسيق الواسع يصعّب مراجعة الفرق.
استخدام الخطة كعقد عمل
الخطة الجيدة تذكر المدخلات والمخرجات والملفات والأوامر ومعيار القبول. حوّل كل بند إلى مهمة قصيرة يمكن إثبات نجاحها. مثال: «أضف دالة تحقق إلى الملف المحدد؛ النجاح يعني مرور اختبارين وعدم تغيير واجهة الدالة». هذا أفضل من بند مثل «حسن التحقق».
إذا اكتشف الوكيل حاجة إلى تغيير جديد، اطلب تحديث الخطة وذكر السبب قبل التنفيذ. بهذه الطريقة لا يتحول العمل تدريجيًا إلى مشروع مختلف. احتفظ ببنود مؤجلة واضحة بدل تنفيذ تحسينات جانبية.
العمل مع Git والفروع
أنشئ فرعًا لكل مهمة، واجعل الحفظات صغيرة ومفهومة. قبل بدء الوكيل نفّذ حفظًا نظيفًا، وبعد كل مرحلة راجع git diff وgit status. لا تسمح بإعادة كتابة التاريخ أو الدفع القسري في مستودع مشترك.
اطلب من الوكيل اقتراح رسالة حفظ تشرح السبب، لكن راجعها بنفسك. عند طلب دمج، اكتب خطوات الاختبار والمخاطر وخطة التراجع. الذكاء الاصطناعي يساعد على إعداد الوصف، لكنه لا يملك سياق المنتج الكامل.
تقييم الكود المولد
- الصحة: هل يحقق معايير القبول والحالات الحدودية؟
- الأمان: هل يتحقق من المدخلات ويحمي الأسرار والصلاحيات؟
- البساطة: هل توجد طبقات أو تبعيات غير ضرورية؟
- الأداء: هل أضاف استعلامات أو حلقات مكلفة؟
- الصيانة: هل الأسماء والهيكل متسقان مع المشروع؟
- الاختبارات: هل تقيس السلوك ويمكنها اكتشاف خطأ متعمد؟
لا تقيّم الحل لأنه أنيق في العرض. شغّل الأدوات الموجودة في المشروع، واختبر المدخلات السيئة، واقرأ المسار الحرج يدويًا. إذا كانت المهمة تتعلق بالمصادقة أو الدفع أو التشفير، اطلب مراجعة خبير.
تمرين ثالث: إضافة البحث إلى التطبيق
- اكتب معيار القبول: البحث غير حساس لحالة الأحرف ويعيد القائمة عند مسح النص.
- اطلب من Cascade خطة من خطوتين فقط.
- حدّد أن التعديل في ملفي HTML وJavaScript دون مكتبات.
- اطلب اختبارات للنص الكامل والجزئي والفراغ.
- راجع أن البحث لا يعدل البيانات الأصلية.
- اختبر الأداء بقائمة أطول.
- احفظ التغيير في Git بعد النجاح.
هذا التمرين يوضح فائدة الخطة الصغيرة: يمكن مراجعة كل قرار، ولا يحتاج الوكيل إلى صلاحيات واسعة أو خدمة خارجية.
التعاون داخل الفريق
اتفقوا على قواعد موحدة للوكيل: التقنيات المسموحة، وأوامر الاختبار، والملفات السرية، ومن يوافق على التبعيات. احتفظوا بالتعليمات داخل المستودع عندما تدعمها الأداة، كي لا تختلف النتائج حسب ذاكرة كل مطور.
لا تجعلوا السرعة تقلل جودة طلبات الدمج. يجب أن يراجع شخص آخر التغييرات المهمة، وأن تبقى الحماية الآلية للفرع والاختبارات مطبقة على الكود المولد مثل الكود اليدوي.
التعامل مع التغييرات السريعة في المنتج
واجهة Devin Desktop والنماذج والخطط قد تتغير. اكتب توثيق فريقك حول المبادئ والأوامر لا مواقع الأزرار فقط. اربط بالوثائق الرسمية، وسجل تاريخ التحقق من الأسعار والسياسات. إذا تغيّر اسم ميزة أو انتقل الإعداد، ارجع إلى صفحة البدء والملاحظات الرسمية بدل الاعتماد على فيديو قديم.
قبل تدريب فريق كامل، اختبر النسخة الحالية على جهاز واحد ومشروع تجريبي. راجع دعم النظام والإضافات والقيود المؤسسية، ثم حدّث دليل الفريق بعد تجربة موثقة.
قائمة تحقق قبل بدء أي مهمة
- المشروع على فرع منفصل والحالة نظيفة.
- الأسرار خارج المجلد أو مستبعدة بوضوح.
- معايير القبول مكتوبة ويمكن اختبارها.
- الخطة تعرض الملفات والأوامر قبل التنفيذ.
- الميزانية والنموذج وحدود الاستخدام مفهومة.
- الاختبارات الحالية تعمل أو فشلها موثق.
- هناك شخص مسؤول عن المراجعة والقرار النهائي.
إذا غاب أكثر من عنصر، اجعل المهمة استكشافية بلا تعديل. اطلب شرحًا أو خطة فقط، ثم جهز المشروع قبل منح الوكيل صلاحية العمل.
اختبر الأداة على مشروع غير حساس أولًا، وسجل ما نجح وما فشل، ثم حوّل الدروس إلى قواعد ثابتة للفريق.
الخلاصة
يصبح Devin Desktop مفيدًا عندما تحول العمل إلى خطة صغيرة قابلة للمراجعة، وتستخدم Git والاختبارات وصلاحيات محدودة. لا تعتمد على الوكيل لإصدار حكم نهائي، ولا ترسل الأسرار، وراجع كل ملف وأمر. ابدأ بمشروع تجريبي، قس التكلفة والجودة، ثم وسّع الاستخدام تدريجيًا قبل العمل الحقيقي، وراجع القواعد بعد كل مشروع لتتعلم من الأخطاء.

