كيفية نشر موقع ويب باستخدام Cursor: وكيل السحابة أو مضيفك الخاص1 min read
Reading Time: 7 minutesلنشر موقع ويب باستخدام Cursor، قم أولاً بتشغيل المشروع، ثم اختر مسار النشر. يحتوي وكيل السحابة الخاص بـ Cursor على تدفق نشر موثق لمستودع متصل بـ Vercel. إذا قمت بإنشاء محرر سطح المكتب أو استخدمت مضيفًا مختلفًا، فقم بنشر المستودع الذي تمت مراجعته باستخدام المسار العادي لذلك المضيف. تتيح لك معاينة Cursor والمنفذ المعاد توجيهه فحص التطبيق، ولكن لا ينطبق الأمر أيضًا على العنوان العام الذي تقدمه للعملاء.
هذه الإرشادات مخصصة للمنشئ الذي يريد إطلاقًا عمليًا بدلاً من لقطة شاشة تم إنشاؤها للصفحة المقصودة. ويغطي اختيار المستودع، والمطالبات، والمعاينات المحلية والسحابية، وعمليات فحص البناء، والنشر، ومسار العناصر المشتركة الاختياري لأصحاب المصلحة. إذا احتاج العديد من الأشخاص إلى مراجعة نفس المسودة قبل الإطلاق، ففكر في أ مساحة العمل AgentGrid.io المشتركة بدلاً من تبادل لقطات الشاشة.
كيفية إنشاء موقع على شبكة الإنترنت في Cursor ونشره مع AgentGrid.io
قم بإعداد AgentGrid.io قبل كتابة التعليمات البرمجية في Cursor حتى يصل التطبيق إلى مساحة العمل الصحيحة.
الخطوة 1: قم بإنشاء مساحة عمل الموقع في AgentGrid.io
قم بتسجيل الدخول على app.agentgrid.io، وحدد الفريق الصحيح، واختر مساحة عمل لموقع الويب. استخدم مساحة عمل منفصلة لجمهور أضيق. اختر عنصرًا من عناصر التطبيق لموقع الويب، وليس ملخص Markdown. إن مشاركة رابط عنصر خاص لا يؤدي إلى تحويله إلى موقع عام.

الخطوة 2: قم بتوصيل وكيل Cursor، وليس المحرر فقط
افتح مشروع الموقع في Cursor واستخدم وضع الوكيل، الذي يمكنه تحرير الملفات وتشغيل الأوامر الطرفية. أعطها هذه التعليمات: Connect this Cursor Agent to agentgrid.io. Run npx @animaapp/cli@latest login, show me the verification URL and code, and wait for my approval. Do not publish yet. قم بالموافقة على اسمه ومساحة العمل والقراءة والكتابة في متصفحك. اترك النشر متوقفًا إلا إذا كنت تريد نشر الوكيل. ثم اطلب تشغيل Cursor npx @animaapp/cli@latest workspaces والتحقق من أنه يمكنه رؤية مساحة العمل المقصودة. إذا تم تعطيل الوصول إلى المحطة الطرفية، فاستخدم استيراد المجلد اليدوي بدلاً من ذلك.
الخطوة 3: إنشاء المشروع واختباره واستيراده مرة واحدة
موجه Cursor: أنشئ صفحة مقصودة سريعة الاستجابة للحجز لورشة عمل الدراجات. استخدم هذا المستودع، وأضف قائمة خدمات واضحة وعبارة تحث المستخدم على اتخاذ إجراء للحجز، وقم بإجراء عمليات التحقق المتاحة، وأخبرني بالملفات التي تمثل نقطة دخول الموقع. لا تقم بتغيير التعليمات البرمجية غير ذات الصلة. راجع الفرق وافتح المعاينة المحلية. قم بتشغيل الوكيل المتصل npx @animaapp/cli@latest create -t import --from ./project --artifact-type app --workspace <workspace-id>، مع استبدال المجلد الفعلي ومعرف مساحة العمل المذكور فيه. افتح عنوان URL للعنصر الذي تم إرجاعه. بالنسبة لموقع ثابت، تأكد index.html والأصول المشار إليها موجودة. استبعاد node_modulesوبناء المخرجات وبيانات الاعتماد. إذا لم يكن الاتصال ممكنًا، فاختر جديد → تحميل مجلد أو جديد → استيراد من ZIP في AgentGrid.io. يعتبر الاستيراد لقطة، وليس مزامنة تلقائية مع المستودع. تحقق من ملفاته ومعاينته ومساحة العمل.

الخطوة 4: قم بتحديث نفس القطعة الأثرية، ثم انشرها عمدًا
الصق عنوان URL للعنصر في Cursor Agent واطلب تحسينًا دقيقًا، مثل إصلاح قائمة الهاتف المحمول على هذا العنصر. تأكيد التغيير في التاريخ. عندما تتم الموافقة على الموقع، استخدم النشر في AgentGrid.io أو اطلب صراحةً من وكيل متصل يتمتع بإمكانية النشر نشره. افتح عنوان URL العام الناتج واختبر رابط التنقل والحجز. النشر منفصل عن مشاركة القطعة الأثرية الخاصة. لا تحل تغييرات التعليمات البرمجية اللاحقة محل النشر العام تلقائيًا: انشر تحديثًا عندما تريد نشره.

ما يمكن لـ Cursor نشره مباشرة
Cursor وثائق إعداد البيئة السحابية يصف تسلسلًا محددًا: احفظ العمل في أحد المستودعات، وقم بتوصيل حساب Vercel، وحدد نشر في نافذة الوكلاء، واحصل على عنوان URL للنشر. يربط Cursor الريبو بمشروع Vercel وينشر فرعه الافتراضي. يتم نشر التزامات الفرع الافتراضي اللاحقة تلقائيًا. يحتاج فريق Cursor الذي يتم نشره إلى فريق Vercel إلى خطة أعلى من Hobby. هذه المتطلبات ليست زر نشر عالمي لكل مشروع محرر محلي.
الخطوة 1: ابدأ في المستودع الصحيح
بالنسبة لموقع موجود، افتح مستودعه في Cursor واطلب من الوكيل اتباع إطار العمل والمكونات والاختبارات واتفاقيات التصميم الحالية. اطلب منه تحديد ما تم نشره بالفعل وأي فرع يتم إنتاجه قبل تغيير الكود. بالنسبة لمشروع Cloud Agent جديد، يقوم Cursor بتوثيق مسار البدء من الصفر وخطوة إنشاء مستودع الأصل؛ تحقق من التوفر في حسابك قبل الاعتماد عليه. بيئة المسودة التي لا تحتوي على مستودع محفوظ ليست جاهزة لمسار Vercel Publish الموثق.
مثال موجه: “في هذا المستودع، أنشئ موقعًا رئيسيًا وورش عمل وزيارة سريع الاستجابة لمتجر مصنع Cedar House. استخدم الشعار المزود وجدول ورشة العمل، وليس التوفر المخترع. احتفظ بالإطار الحالي واتفاقيات التصميم. أضف عناوين الصفحات وأوصافها، وروابط تسجيل العمل من project-notes.md، وقائمة متنقلة صديقة للوحة المفاتيح. اعرض خطة، ونفذها، وأدرج الملفات والاختبارات التي تم تغييرها، وتوقف قبل النشر.”
إذا كان المشروع يحتوي على مسارات واجهة برمجة التطبيقات (API)، أو مصادقة، أو صفحات معروضة بواسطة الخادم، فحددها الآن. قد لا يدعم المضيف الثابت فقط وقت التشغيل. اسأل عن متغيرات البيئة التي يتوقعها التطبيق وما إذا كان سيتم عرض أي منها للمتصفح. لا تقم أبدًا بلصق أسرار الإنتاج في موجه الوكيل أو إلزامها بالتحكم بالمصادر.
الخطوة 2: معاينة التطبيق قيد التشغيل
تثبيت التبعيات وتشغيل أمر التطوير المحدد بواسطة المشروع. بالنسبة لجلسة محرر Cursor المحلية، افتح عنوان URL للتطوير المحلي في المتصفح. بالنسبة إلى وكيل السحابة، اكتشفت مستندات Cursor المنافذ المعاد توجيهها وقمت بتكوينها يدويًا في نافذة الوكلاء. افتح التطبيق المُعاد توجيهه في المتصفح الداخلي وتفحص الصفحات الحقيقية. لا يمكن لسجل البناء الذي يشير إلى “مكتمل” التحقق من صحة التنقل سريع الاستجابة أو مكالمات العمل التي تحث المستخدم على اتخاذ إجراء.
تحقق من الموقع بعرض ضيق وواسع. اتبع الروابط إلى الوجهات المقصودة ونماذج الاختبار. جرب التنقل عبر لوحة المفاتيح والتركيز المرئي. افحص بدائل الصور والبيانات التعريفية وترتيب العناوين والأصول المفقودة وحالات التحميل. التحقق من صحة ساعات عمل المتجر وتفاصيل الاتصال والنسخة القانونية وحقوق الصورة مقابل المصدر المعتمد. إذا كان الموقع يعتمد على واجهة برمجة التطبيقات (API)، فتحقق من الطلب الفاشل وتأكد من عدم ظهور أي بيانات اعتماد في حزم المتصفح.
موجه الاختبار: “قم بتشغيل البرامج النصية للاختبار والإنتاج وبناء المستودع. افتح الصفحات الثلاث في المتصفح بعرض الهاتف المحمول وسطح المكتب. أبلغ عن الأصول المعطلة، والروابط الميتة، وعناصر التحكم التي لا يمكن الوصول إليها، ثم أصلح عيوب التعليمات البرمجية. لا تغير تكوين النشر أو النشر. قم بتلخيص حالات الفشل التي تتطلب قرارًا بشريًا.” افتح المتصفح بنفسك بالفعل بعد أن أبلغ الوكيل عن النجاح.
الخطوة 3: اختر مسار الإطلاق
| المسار | الأفضل متى | ما يصبح عاما |
|---|---|---|
| وكيل السحابة ينشر إلى Vercel | المستودع واتصال Vercel جاهزان | عنوان URL لنشر Vercel والمجال الذي تم تكوينه |
| سير عمل النشر الخاص بمضيفك | أنت تستخدم بالفعل خط أنابيب CI/CD أو نظام أساسي آخر | عنوان URL لنشر المضيف |
| قطعة أثرية AgentGrid.io | يحتاج الفريق إلى نسخة عمل قابلة للمراجعة أولاً | لا شيء حتى يتم نشر القطعة الأثرية بشكل منفصل |
المساران الأولان هما طرق النشر. والثالث هو سير عمل التعاون والنشر مع نسخته الخاصة من التطبيق. اختر مصدرًا واحدًا للحقيقة وسجل الإصدار الذي شاهده المراجعون.
الخطوة 4: النشر باستخدام Cursor Cloud Agent وVercel
بمجرد وجود العمل في أحد المستودعات، قم بتوصيل حساب Vercel في Cursor. في نافذة الوكلاء، حدد نشر أعلى إدخال الوكيل. إذا كان Cursor يعرض Add Vercel، فأكمل هذا الاتصال أولاً. قم بمراجعة المستودع وفريق Vercel الوجهة والفرع الافتراضي ومتغيرات البيئة وإعدادات البناء قبل الموافقة. يقوم التدفق الموثق لـ Cursor بعد ذلك بربط الريبو ونشر الفرع الافتراضي وإرجاع عنوان URL.
لا تستخدم فرع المعاينة كدليل على ما سيصل إلى الفرع الافتراضي. تحقق من الفرق وأي مراجعة مطلوبة للكود البشري قبل الدمج. يمكن أن يؤدي الالتزام اللاحق بهذا الفرع إلى إعادة نشر الموقع المباشر تلقائيًا، لذا حدد إجراءات الموافقة والتراجع الآن. إذا كان الموقع الذي تم إنشاؤه ثابتًا، قم بتأكيد دليل الإخراج؛ إذا كانت مسارات الخادم متضمنة، فتأكد من أن المضيف يدعم وقت تشغيل التطبيق. تعامل مع المجال DNS والفوترة كقرارات ملكية منفصلة.
الخطوة 5: النشر من خلال مضيف آخر، أو المشاركة للمراجعة
مع مضيف آخر، قم بتنفيذ التعليمات البرمجية التي تمت مراجعتها واتبع المستودع الخاص بإطار العمل الخاص بالموفر أو سير عمل التحميل. قم بتكوين أمر البناء وموقع الإخراج ومتغيرات البيئة وعمليات إعادة التوجيه والمجال المخصص على هذا المضيف. استخدم نشر المعاينة للحصول على موافقة أصحاب المصلحة عندما يكون ذلك متاحًا. يساعد Cursor في التعليمات البرمجية والأوامر؛ يمتلك المضيف عنوان URL العام وإعدادات الإنتاج.
لمراجعة الفريق، يوثق AgentGrid.io أ اتصال Cursor. تأكد من أن بيئة الوكيل يمكنها تشغيل تدفق الاتصال، ومنح الوصول فقط إلى مساحة العمل المقصودة، واطلب منه إرجاع الرابط الاصطناعي. إذا كان الاتصال غير مناسب، فقم باستيراد مجلد المشروع الذي تمت مراجعته أو ضغطه بنفسك. فحص معاينة القطعة الأثرية ومصدرها بعد النقل؛ الرابط الخاص ليس موقعًا إلكترونيًا للإنتاج، ولا تتم مزامنة التعديلات في الريبو الأصلي تلقائيًا مع النسخة المستوردة.
موجه التسليم المحدد النطاق: “بعد أن أأذن بالاتصال، ضع مشروع Cedar House الذي تمت مراجعته في مساحة العمل المحددة كعنصر تطبيق غير منشور. أعد عنوان URL الخاص به وأدرج أي تبعيات أو ميزات خلفية فشل نقلها. لا تنشر أو تشارك خارجيًا أو تختار مساحة عمل أخرى.” عندما يقوم الفريق بتوقيع الخروج، استخدم القطعة الأثرية تدفق نشر منفصل إذا كان AgentGrid.io هو المضيف المختار.
الخطوة 6: التحقق من النشر الفعلي
افتح عنوان URL العام أثناء تسجيل الخروج ومن الهاتف. قارن صفحاته بالمعاينة المعتمدة. اختبار التنقل والنماذج ووجهة الاشتراك وHTTPS والبيانات التعريفية وتحميل الصور وأي مجال مخصص. سجل الالتزام المنشور أو مراجعة القطعة الأثرية. إذا كانت الصفحة العامة أقدم، فتحقق من اختيار الفرع ومخرجات البناء ومتغيرات البيئة وسجلات النشر والتخزين المؤقت قبل الإعلان عنها. أعد تشغيل الاختبارات بعد كل تحديث للإنتاج.
اجعل التحديث القادم متعمدًا
سجل النسخة المعتمدة وعنوان URL العام. التعديلات الجديدة هي مسودات حتى تتم مراجعتها ونشرها مرة أخرى.
الأسئلة المتداولة
هل يمكن لـ Cursor نشر موقع ويب بدون Vercel؟
نعم، من خلال إنتاج تعليمات برمجية لسير عمل موفر استضافة آخر. يستخدم عنصر تحكم نشر Cloud Agent الموثق الذي تمت مناقشته هنا Vercel. لا تعد معاينة محرر سطح المكتب والمنافذ المعاد توجيهها من خدمات الاستضافة المستقلة.
لماذا لا يتوفر النشر في جلسة Cloud Agent الخاصة بي؟
تأكد من حفظ المشروع في مستودع ومن اتصال Vercel. يمكن أن تكون الأهلية والخطة وإعدادات المؤسسة وأذونات المستودع مهمة أيضًا. اتبع دليل الإعداد الحالي لـ Cursor بدلاً من افتراض ظهور نفس عناصر التحكم في كل حساب.
هل ستقوم معاينة Cursor بتحديث موقع الويب المباشر الخاص بي؟
لا. تعرض المعاينة المحلية أو المعاد توجيهها عملية تطوير للفحص. النشر هو حدث منفصل. في مسار Vercel الخاص بـ Cursor، يمكن للالتزامات المستقبلية للفرع الافتراضي تحديث الإنتاج بعد إعداد التكامل.
هل يمكنني استخدام AgentGrid.io للموافقة فقط؟
نعم. احتفظ بعنصر غير منشور للمراجعة المشتركة، ثم قم إما بنشر هذا العنصر المعتمد أو نشر المستودع الذي تمت مراجعته المقابل من خلال مضيفك الحالي. حافظ على محاذاة كلا النسختين إذا كنت تستخدم كليهما.
لمقارنة عملية التسليم، راجع دليلنا لـ مشاركة مخرجات الوكيل كرابط. ال نشر موقع تصميم Claude يغطي نقطة بداية أخرى، في حين أن إرشادات النشر على موقع Muse يظهر قطعة أثرية تمت مراجعتها تنتقل إلى النشر. هذه هي مسارات عمل مختلفة، وليست ميزات منتج قابلة للتبديل.

Figma
Adobe XD
Blog


