agentic

نحوه انتشار یک وب سایت با Cursor: عامل ابر یا میزبان شخصی شما2 min read

Reading Time: 9 minutesیک وب سایت ساخته شده در Cursor را منتشر کنید: پروژه را آزمایش کنید، در صورت واجد شرایط بودن، از Cloud Agent Publish با Vercel استفاده کنید، یا مخزن خود را از طریق میزبان دیگری مستقر کنید.

Cursor publishing a website cover

نحوه انتشار یک وب سایت با Cursor: عامل ابر یا میزبان شخصی شما2 min read

Reading Time: 9 minutes

برای انتشار یک وب سایت با Cursor، ابتدا پروژه را اجرا کنید، سپس مسیر استقرار را انتخاب کنید. Cursor’s Cloud Agent یک جریان انتشار مستند برای یک مخزن متصل به Vercel دارد. اگر ویرایشگر دسکتاپ را ساخته اید یا از میزبان دیگری استفاده می کنید، مخزن بررسی شده را با خط لوله معمولی آن میزبان مستقر کنید. پیش‌نمایش و پورت ارسال‌شده Cursor به شما امکان می‌دهد برنامه را بررسی کنید، اما آدرس عمومی که به مشتریان می‌دهید نیز اینگونه نیست.

این راهنما برای سازنده‌ای است که به‌جای اسکرین‌شات صفحه فرود ایجاد شده، یک راه‌اندازی کارآمد می‌خواهد. انتخاب مخزن، درخواست‌ها، پیش‌نمایش‌های محلی و ابری، بررسی‌های ساخت، انتشار، و مسیر اختیاری اشتراک‌گذاری شده برای ذینفعان را پوشش می‌دهد. اگر چندین نفر نیاز به بررسی یک پیش نویس قبل از راه اندازی دارند، یک مورد را در نظر بگیرید فضای کاری AgentGrid.io را به اشتراک گذاشت به جای تبادل اسکرین شات

نحوه ساخت وب سایت در Cursor و انتشار آن با AgentGrid.io

قبل از نوشتن کد در Cursor، AgentGrid.io را تنظیم کنید تا برنامه در فضای کاری مناسب قرار گیرد.

مرحله 1: فضای کاری سایت را در AgentGrid.io ایجاد کنید

در app.agentgrid.io وارد شوید، تیم صحیح را انتخاب کنید و یک فضای کاری برای وب سایت انتخاب کنید. از یک فضای کاری جداگانه برای مخاطبان محدودتر استفاده کنید. یک مصنوع برنامه را برای وب سایت انتخاب کنید، نه یک علامت کوتاه Markdown. به اشتراک گذاری پیوند مصنوع خصوصی آن را به یک سایت عمومی تبدیل نمی کند.

فضای کاری AgentGrid.io با دعوت از یک نماینده برجسته شده است
در یک فضای کاری AgentGrid.io، Invite a agent یک اتصال پشتیبانی شده را شروع می کند.

مرحله 2: Cursor Agent را وصل کنید، نه صرفاً ویرایشگر

پروژه سایت را در Cursor باز کنید و از حالت Agent استفاده کنید که می تواند فایل ها را ویرایش کند و دستورات ترمینال را اجرا کند. این دستورالعمل را به آن بدهید: 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، خروجی ساخت و اعتبارنامه ها. اگر اتصال امکان‌پذیر نبود، New → Upload Folder یا New → Import from ZIP را در AgentGrid.io انتخاب کنید. Import یک عکس فوری است، نه همگام سازی خودکار با مخزن. فایل‌ها، پیش‌نمایش و فضای کاری آن را تأیید کنید.

مصنوع وب سایت نمایشی لوتوس سفید در AgentGrid.io
نمونه ای از مصنوعات وب سایت در AgentGrid.io: نسخه نمایشی White Lotus خصوصی است در حالی که نسخه آن بررسی می شود.

مرحله 4: همان آرتیفکت را به روز کنید، سپس عمدا منتشر کنید

URL مصنوع را در Cursor Agent بچسبانید و برای بهبود دقیق، مانند اصلاح منوی تلفن همراه در آن آرتیفکت، بخواهید. تغییر در History را تایید کنید. وقتی سایت تأیید شد، از Publish در AgentGrid.io استفاده کنید یا صریحاً از یک عامل متصل با قابلیت Publish بخواهید آن را اجرا کند. URL عمومی به دست آمده را باز کنید و پیوند پیمایش و رزرو را آزمایش کنید. انتشار جدا از اشتراک گذاری مصنوعات خصوصی است. تغییرات بعدی کد به طور خودکار جایگزین استقرار عمومی نمی‌شود: زمانی که می‌خواهید به‌روزرسانی را به صورت زنده منتشر کنید.

منوی اشتراک گذاری AgentGrid.io به روز شد که گزینه انتشار را نشان می دهد
منوی اشتراک‌گذاری به‌روزرسانی شده شامل Publish است که یک مصنوع تأیید شده را به یک وب‌سایت زنده تبدیل می‌کند.

آنچه Cursor می تواند مستقیماً منتشر کند

Cursor مستندات راه اندازی محیط ابری توالی خاصی را توصیف می کند: کار را در یک مخزن ذخیره کنید، یک حساب Vercel را متصل کنید، انتشار در پنجره Agents را انتخاب کنید، و URL استقرار را دریافت کنید. Cursor مخزن را به یک پروژه Vercel پیوند می دهد و شاخه پیش فرض آن را مستقر می کند. بعداً commit های پیش فرض شاخه به طور خودکار مستقر می شوند. یک تیم Cursor که در یک تیم Vercel مستقر می شود به یک برنامه بالاتر از Hobby نیاز دارد. این الزامات یک دکمه انتشار جهانی برای هر پروژه ویرایشگر محلی نیست.

مرحله 1: از مخزن مناسب شروع کنید

برای یک سایت موجود، مخزن آن را در Cursor باز کنید و از Agent بخواهید که چارچوب، مؤلفه‌ها، آزمایش‌ها و قراردادهای طراحی موجود را دنبال کند. از آن بخواهید قبل از تغییر کد، آنچه را که قبلاً مستقر شده است و کدام شاخه تولید می شود، شناسایی کند. برای پروژه Cloud Agent جدید، Cursor یک مسیر شروع از ابتدا و یک مرحله ایجاد مخزن Origin را مستند می کند. قبل از اتکا به آن، در دسترس بودن حساب خود را بررسی کنید. یک محیط پیش نویس بدون مخزن ذخیره شده برای مسیر مستند Vercel Publish آماده نیست.

اعلان مثال: “در این مخزن، یک سایت پاسخگو Home، Workshops و Visit برای فروشگاه کارخانه Cedar House بسازید. از لوگوی ارائه شده و برنامه کارگاه استفاده کنید، نه در دسترس بودن اختراع شده. چارچوب موجود و قراردادهای سبک را حفظ کنید. عنوان و توضیحات صفحه را اضافه کنید، پیوندهای ثبت نام کار را از project-notes.md، و یک صفحه کلید مناسب را نشان دهید، قبل از تغییر فهرست و اجرای منوی موبایل، یک برنامه کاربردی را نشان دهید و منوی موبایل را تغییر دهید. استقرار.»

اگر پروژه دارای مسیرهای API، احراز هویت یا صفحات رندر شده توسط سرور است، اکنون آنها را شناسایی کنید. یک میزبان فقط استاتیک ممکن است از زمان اجرا پشتیبانی نکند. بپرسید برنامه مورد انتظار کدام متغیرهای محیطی است و آیا هر کدام از آنها در معرض مرورگر قرار می گیرد یا خیر. هرگز اسرار تولید را در یک درخواست نماینده قرار ندهید یا آنها را به کنترل منبع متعهد نکنید.

مرحله 2: پیش نمایش برنامه در حال اجرا

وابستگی ها را نصب کنید و دستور توسعه تعریف شده توسط پروژه را اجرا کنید. برای یک جلسه ویرایشگر محلی Cursor، URL توسعه محلی را در یک مرورگر باز کنید. برای یک Cloud Agent، اسناد Cursor پورت های ارسال شده را در پنجره Agents شناسایی و به صورت دستی پیکربندی کردند. برنامه فوروارد شده را در مرورگر داخلی باز کنید و صفحات واقعی را بررسی کنید. گزارش ساختی که می‌گوید «کامل» نمی‌تواند ناوبری پاسخگو یا فراخوان‌های کاری را تأیید کند.

سایت را در عرض های باریک و وسیع بررسی کنید. پیوندهای مقصد مورد نظر و فرم های آزمون را دنبال کنید. پیمایش صفحه کلید و فوکوس قابل مشاهده را امتحان کنید. جایگزین های تصویر، ابرداده، ترتیب عنوان، دارایی های از دست رفته و وضعیت های بارگیری را بررسی کنید. ساعت کاری فروشگاه، اطلاعات تماس، کپی قانونی و حقوق تصویر را بر اساس منبع تایید شده تأیید کنید. اگر سایت به یک API وابسته است، درخواست ناموفق را بررسی کنید و تأیید کنید که هیچ اعتباری در بسته‌های مرورگر ظاهر نمی‌شود.

درخواست تست: اسکریپت‌های لینت، آزمایش و ساخت این مخزن را اجرا کنید. سه صفحه را در یک مرورگر در عرض موبایل و دسک‌تاپ باز کنید. دارایی‌های شکسته، پیوندهای مرده و کنترل‌های غیرقابل دسترسی را گزارش کنید، سپس نقص‌های کد را برطرف کنید. پیکربندی استقرار را تغییر ندهید یا منتشر نکنید. خرابی‌هایی را که نیاز به تصمیم انسانی دارند، خلاصه کنید. در واقع پس از گزارش موفقیت توسط نماینده، مرورگر را خودتان باز کنید.

مرحله 3: مسیر پرتاب را انتخاب کنید

مسیر بهترین زمانی که آنچه عمومی می شود
Cloud Agent در Vercel منتشر کنید مخزن و اتصال Vercel آماده هستند URL استقرار Vercel و دامنه پیکربندی شده
گردش کار استقرار میزبان شما شما قبلاً از خط لوله CI/CD یا پلت فرم دیگری استفاده می کنید نشانی وب استقرار میزبان
مصنوع AgentGrid.io یک تیم ابتدا به یک نسخه کاری قابل بررسی نیاز دارد هیچ چیزی تا زمانی که مصنوع به طور جداگانه منتشر نشود

دو مسیر اول مسیرهای استقرار هستند. سومین گردش کار همکاری و انتشار با کپی خود از برنامه است. یکی از منابع حقیقت را انتخاب کنید و آن نسخه را که بازبینان نسخه دیده اند، ثبت کنید.

مرحله 4: با Cursor Cloud Agent و Vercel منتشر کنید

هنگامی که کار در یک مخزن قرار گرفت، حساب Vercel را در Cursor متصل کنید. در پنجره Agents، Publish را در بالای ورودی عامل انتخاب کنید. اگر Cursor افزودن Vercel را ارائه می دهد، ابتدا آن اتصال را تکمیل کنید. قبل از تایید، مخزن، تیم Vercel مقصد، شاخه پیش فرض، متغیرهای محیطی و تنظیمات ساخت را بررسی کنید. جریان مستند Cursor سپس مخزن را پیوند می دهد، شاخه پیش فرض را مستقر می کند و URL را برمی گرداند.

از شاخه پیش نمایش به عنوان اثبات آنچه در شاخه پیش فرض قرار می گیرد استفاده نکنید. قبل از ادغام، تفاوت و بررسی کدهای انسانی مورد نیاز را بررسی کنید. یک commit بعدی به آن شعبه می‌تواند سایت زنده را به طور خودکار مجدداً مستقر کند، بنابراین مراحل تأیید و بازگشت را هم‌اکنون تعریف کنید. اگر سایت ایجاد شده ثابت است، دایرکتوری خروجی را تأیید کنید. اگر مسیرهای سرور درگیر هستند، تأیید کنید که میزبان از زمان اجرا برنامه پشتیبانی می کند. دامنه DNS و صورتحساب را به عنوان تصمیمات مالکیت جداگانه در نظر بگیرید.

مرحله 5: از طریق میزبان دیگری مستقر کنید، یا برای بررسی به اشتراک بگذارید

با میزبانی دیگر، کد بازبینی شده را انجام دهید و از مخزن فریمورک خاص ارائه‌دهنده پیروی کنید یا گردش کار آپلود کنید. دستور ساخت، مکان خروجی، متغیرهای محیطی، تغییر مسیرها و دامنه سفارشی را در آن میزبان پیکربندی کنید. در صورت وجود، از استقرار پیش نمایش آن برای تأیید ذینفعان استفاده کنید. Cursor با کد و دستورات کمک می کند. میزبان مالک URL عمومی و تنظیمات تولید است.

برای بررسی تیمی، اسناد AgentGrid.io a اتصال Cursor. تأیید کنید که محیط عامل می‌تواند جریان اتصال را اجرا کند، فقط به فضای کاری مورد نظر دسترسی بدهد و از آن بخواهید پیوند آرتیفکت را برگرداند. اگر اتصال نامناسب است، پوشه پروژه بررسی شده یا ZIP را خودتان وارد کنید. پیش نمایش مصنوع و منبع را پس از انتقال بررسی کنید. یک پیوند خصوصی یک وب‌سایت تولیدی نیست و ویرایش‌های موجود در مخزن اصلی به‌طور خودکار با یک کپی وارداتی همگام‌سازی نمی‌شوند.

اعلان انتقال محدوده: “بعد از اینکه من اتصال را تأیید کردم، پروژه بررسی شده Cedar House را به عنوان یک مصنوع برنامه منتشر نشده در فضای کاری نامگذاری شده قرار دهید. URL خصوصی آن را برگردانید و وابستگی ها یا ویژگی های پشتیبان را که منتقل نشدند فهرست کنید. از انتشار، اشتراک گذاری خارجی، یا انتخاب فضای کاری دیگر خودداری کنید.” وقتی تیم امضا کرد، از مصنوع استفاده کنید جریان انتشار جداگانه اگر AgentGrid.io میزبان انتخابی باشد.

مرحله 6: استقرار واقعی را تأیید کنید

هنگام خروج از سیستم و از تلفن، URL عمومی را باز کنید. صفحات آن را با پیش نمایش تایید شده مقایسه کنید. ناوبری، فرم ها، مقصد ثبت نام، HTTPS، ابرداده، بارگیری تصویر و هر دامنه سفارشی را آزمایش کنید. commit یا مصنوع بازبینی شده را ضبط کنید. اگر صفحه عمومی قدیمی‌تر است، قبل از اعلام آن، انتخاب شاخه، خروجی ساخت، متغیرهای محیط، گزارش‌های استقرار و حافظه پنهان را بررسی کنید. پس از هر به‌روزرسانی تولید، آزمایش‌ها را دوباره اجرا کنید.

به روز رسانی بعدی را عمدی انجام دهید

نسخه تایید شده و URL عمومی را ضبط کنید. ویرایش های جدید پیش نویس هستند تا زمانی که دوباره بررسی و منتشر شوند.

سوالات متداول

آیا Cursor می تواند وب سایتی را بدون Vercel منتشر کند؟

بله، با تولید کد برای گردش کار یک ارائه دهنده میزبانی دیگر. کنترل مستند Cloud Agent Publish که در اینجا بحث شده است از Vercel استفاده می کند. پیش نمایش ویرایشگر دسکتاپ و پورت های ارسال شده، خدمات میزبانی مستقل نیستند.

چرا Publish در جلسه Cloud Agent من در دسترس نیست؟

بررسی کنید که پروژه در یک مخزن ذخیره شده باشد و Vercel متصل باشد. واجد شرایط بودن، طرح، تنظیمات سازمان، و مجوزهای مخزن نیز می تواند مهم باشد. به جای اینکه فرض کنید کنترل‌های مشابه در هر حساب کاربری ظاهر می‌شود، از راهنمای تنظیم فعلی Cursor پیروی کنید.

آیا پیش نمایش Cursor وب سایت زنده من را به روز می کند؟

خیر. پیش‌نمایش محلی یا ارسال‌شده، فرآیند توسعه را برای بازرسی در معرض دید قرار می‌دهد. استقرار یک رویداد جداگانه است. در مسیر Vercel Cursor، تعهدات آینده به شعبه پیش‌فرض می‌توانند تولید را پس از راه‌اندازی یکپارچه‌سازی به‌روزرسانی کنند.

آیا می توانم از AgentGrid.io فقط برای تایید استفاده کنم؟

بله یک مصنوع منتشر نشده را برای بررسی مشترک نگه دارید، سپس آن مصنوع تایید شده را منتشر کنید یا مخزن بررسی شده مربوطه را از طریق میزبان موجود خود مستقر کنید. اگر از هر دو استفاده می کنید، هر دو نسخه را در یک راستا نگه دارید.

برای مقایسه انتقال، به راهنمای ما مراجعه کنید یک خروجی عامل را به عنوان پیوند به اشتراک بگذارید. را یک وب سایت طراحی Claude منتشر کنید نقطه شروع دیگری را پوشش می دهد، در حالی که راهنمای انتشار وب سایت Muse یک مصنوع بازبینی شده را نشان می دهد که به سمت انتشار می رود. اینها گردش کار متفاوت هستند، نه ویژگی های محصول قابل تعویض.

|

Co-founder & CEO