Fix with AI: یک کلیک وقتی انتشار ناموفق می‌شود

وقتی انتشار یک برنامه در Mythex ناموفق می‌شود، پنجره‌ی انتشار حالا می‌گوید واقعاً چه اتفاقی افتاده و در هر خطا دو دکمه دارد: Fix with AI و Try again. با Fix with AI، خطا و آنچه برنامه‌تان در خروجی‌اش چاپ کرده به عامل داده می‌شود تا پروژه را درست کند و دوباره منتشرش کند. و اگر چیزی در برنامه‌تان اشکال نداشته باشد، عامل فقط دوباره منتشرش می‌کند. همچنین دیگر مشکلات واقعی برنامه را به «سمت ما» نسبت نمی‌دهیم و حالا برنامه‌هایی را که چند دقیقه بعد از زنده شدن از کار می‌افتند هم پیدا می‌کنیم.

چه چیزی تغییر کرده

Fix with AI در هر خطا

پیش‌تر بعضی خطاها فقط دکمه Try again را نشان می‌دادند. این تفکیک بر اساس این بود که خطا به نظرمان از سمت ما بوده یا نه: اگر از سمت ما به نظر می‌رسید، نمی‌خواستیم عامل دنبال کدی برود که مشکلی ندارد و اعتبار شما را هدر دهد.

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

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

پیام‌هایی که می‌گویند چه اتفاقی افتاده

چند خطا قبلاً به «مشکلی از سمت ما؛ دوباره منتشر کنید» ختم می‌شدند. این حرف نادرست بود و دوباره منتشر کردن هم هرگز کمک نمی‌کرد. حالا برای هرکدام پیام جدا داریم:

• «برنامه‌ی شما بعد از انتشار شروع به کار نکرد.» برنامه منتشر شده اما هیچ‌وقت اتصال‌ها را نپذیرفت. اغلب به پورت دیگری گوش می‌دهد، یا فقط روی localhost. برنامه‌ی منتشرشده باید روی 0.0.0.0 و پورتی که در $PORT است گوش کند. به‌جای اینکه مدت ثابتی صبر کنیم و امیدوار بمانیم، حالا بررسی می‌کنیم که برنامه واقعاً روی پورتش اتصال می‌پذیرد.
• «این فایل خیلی بزرگ است» / تعداد فایل‌ها زیاد است. سایت‌های ایستا محدودیت حجم برای هر فایل دارند (حدود ۲۵ تا ۳۰ مگابایت، بسته به نوع سایت) و سقف ۲۰٬۰۰۰ فایل. حالا پوشه را پیش از آپلود اندازه می‌گیریم، به یک شیوه برای همه‌ی انواع فایل، و پیام همه‌ی فایل‌هایی را که از حد گذشته‌اند فهرست می‌کند.
• «برنامه‌ی شما بلافاصله بعد از شروع متوقف شد.» معمولاً یک تنظیم گم‌شده مثل متغیر محیطی یا رمز، یک کرش در اولین درخواست، یا خطا در دستور شروع.

گرفتن برنامه‌هایی که بعد از زنده شدن از کار می‌افتند

انتشار ممکن است موفق باشد و برنامه چند دقیقه بعد باز از کار بیفتد: مدام کرش کند یا اجرا شود اما اتصال نپذیرد. Mythex به‌طور منظم برنامه‌های منتشرشده را بررسی می‌کند. اگر برنامه‌ای در چند دقیقه‌ی کوتاه چند بار کرش کند، یا در حال اجرا باشد اما هیچ اتصالی نگیرد، انتشار به‌عنوان ناموفق علامت می‌خورد، ایمیلی برایتان فرستاده می‌شود و پروژه پیام را همراه با Fix with AI نشان می‌دهد.

یک کرشِ تنها که برنامه خودش از آن بهبود یافته، انتشار ناموفق حساب نمی‌شود. اگر به خاطر تمام شدن حافظه بوده، ایمیل جداگانه‌ای درباره‌ی آن دریافت می‌کنید.

وقتی یک برنامه‌ی زنده را ناموفق علامت می‌زنیم، خروجی‌ای را که برنامه همان لحظه چاپ کرده هم ذخیره می‌کنیم. این خروجی خام را نمی‌بینید، اما همان چیزی است که Fix with AI به عامل می‌دهد، تا از خطای واقعی شروع کند و حدس نزند.

نحوه استفاده

1. مثل همیشه روی Publish کلیک کنید.
2. اگر ناموفق شد، پیام داخل پنجره را بخوانید. این پیام نوشته شده تا بگوید چه اتفاقی افتاده، نه فقط اینکه مشکلی بوده.
3. روی Fix with AI کلیک کنید. عامل خروجی ساخت یا لاگ‌های برنامه را می‌خواند، پروژه را درست می‌کند و می‌توانید دوباره منتشر کنید.
4. اگر پیام می‌گوید اشکالی در برنامه‌تان نیست — «انتشار لحظه‌ای مشغول است» یا «انتشار قطع شد» — معمولاً Try again کافی است.
5. اگر ایمیلی گرفتید که برنامه‌ی زنده‌تان مدام کرش می‌کند، پروژه را باز کنید: همان پیام و Fix with AI آنجا منتظرند.

نام لینک را هنگام انتشار دوباره همان نگه دارید، مگر اینکه پیام بگوید مشکل از همان نام است.

چرا این را ساختیم

انتشار ناموفق اغلب اولین دیواری است که کسی به آن می‌خورد. برنامه در پیش‌نمایش کار می‌کند، کسی Publish را می‌زند و بالا نمی‌آید. برای کسی که توسعه‌دهنده نیست، «لاگ‌هایت را بررسی کن» توصیه‌ای قابل اجرا نیست. Fix with AI این لحظه را با یک کلیک قابل حل می‌کند و پیام‌های صادقانه باعث می‌شوند وقتی آن‌ها را می‌خوانید، به چیز درست اشاره کنند.

محدودیت‌ها

• Fix with AI از عامل استفاده می‌کند، پس مانند هر پیام دیگری از اعتبار مصرف می‌کند.
• می‌تواند چیزهایی را که در پروژه است درست کند: کد، پیکربندی، دستور شروع. نمی‌تواند نام لینک گرفته‌شده، ایمیل تأیید نشده یا موجودی خالی اعتبار را درست کند.
• برخی مشکلات به تصمیم شما نیاز دارند، مثلاً اینکه فایل بزرگی را به Storage ببرید یا کوچک‌ترش کنید.

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