מציג האפליקציה

האתר נטען, ומציג האפליקציה פועל כרגיל, תן לו רגע. אם זה נמשך יותר מ-2 דקות, לחץ על סמל Refresh או בדוק שגיאות בחלונית Console.

סוכנים עלולים להיתקל בבעיות במהלך הבנייה, מה שלפעמים גורם לשגיאות בדף האינטרנט. לחץ על Resolve והסוכנים יתקנו זאת עבורך; לאחר התיקון, התצוגה המקדימה תחזור למצב תקין. הודעות אדומות הן סימן, לא משבר.

הסרת תג דורשת Pro או גבוה יותר. לחץ על האווטאר שלך בפינה הימנית העליונה, בחר Settings, ואז עבור אל Plans & Billing ובחר בתוכנית Pro או Max. לאחר השדרוג, תג Atoms יוסר אוטומטית מהעמודים שפרסמת.

1. פתח Design Mode ובחר את הרכיב המדויק שאינו מיושר או מעוצב בצורה שגויה.
2. ציין את העמוד ואת נקודת השבירה, את הבעיה הנוכחית, את התוצאה הרצויה, ומה אסור שישתנה.
3. השתמש בהוראות מדידות כמו padding, יישור, רוחב, צבע או התנהגות גלישה לשורה. צרף תמונת ייחוס כאשר התאמה חזותית חשובה.
4. החל שינוי אחד, ואז אמת את פריסות שולחן העבודה והנייד וגם מצבים חשובים כמו טעינה, ריק, hover ושגיאה.
5. אם התוצאה שוברת אזור אחר, חזור לגרסה האחרונה שעבדה ונסה שוב עם יעד מצומצם יותר.

1. אשר אם הבעיה משפיעה רק על App Viewer, על Preview URL, או גם על האתר שפורסם.
2. רענן פעם אחת, פתח את ה-Preview בלשונית חדשה, ובדוק בחלון Incognito.
3. בדוק אם המשימה או הבנייה הנוכחית עדיין רצה. המתן לסיומה לפני שתנסה שוב.
4. אם הודעה מפורשת אומרת שה-Cloud & AI balance אינו מספיק או שהאפליקציה מושעית, פתח Settings → Cloud & AI ובדוק את היתרה הזו. אל תטען יתרה רק על סמך מסך ריק.
5. תעד כל שגיאת Console או Network בלי לשתף cookies, tokens או ערכים סודיים.

אם המסך נשאר ריק, פנה ל-Support עם ה-Chat Link, כתובת ה-Viewer URL המלאה, השעה ואזור הזמן, הסביבות המושפעות, צילום מסך, ופרטי שגיאה מנוקים.

1. בדוק אם רק App Viewer, ה-Preview URL, או האתר שפורסם מושפעים.
2. רענן פעם אחת, פתח את ה-Preview בלשונית חדשה, ובדוק בחלון Incognito.
3. בדוק אם המשימה או הבנייה הנוכחית עדיין רצה והמתן לסיומה.
4. בדוק את הגרסה האחרונה שידוע שעבדה. אם היא עובדת, השווה לשינוי האחרון שהכניס את המסך הריק.
5. פתח Settings → Cloud & AI רק כאשר המוצר מדווח במפורש על יתרה לא מספקת או אפליקציה מושעית.

אם הבעיה נמשכת, פנה ל-Support עם ה-Chat Link, כתובת ה-Viewer URL המלאה, הגרסה, השעה ואזור הזמן, הסביבות המושפעות, צילום מסך, ושגיאת Console או Network מנוקה.

Preview והאתר שפורסם הם ערוצים נפרדים. שמירה או תצוגה מקדימה אינן דוחפות שינויים ל-production.

1. לחץ על Update בחלונית Publish — פתח את חלונית Publish ולחץ על Update. המתן עד שהסטטוס יציג Up to date.
2. בצע רענון קשיח לאתר החי — לחץ על Cmd+Shift+R (Mac) או Ctrl+F5 (Windows), או פתח את ה-URL בחלון Incognito כדי לשלול מטמון דפדפן.
3. בדוק את מספר הגרסה שפורסמה — בחלונית Publish, אשר שהגרסה תואמת למה שאתה רואה ב-Preview. אם הן שונות, פרסם שוב.
4. בדוק את תת-הדומיין Prod של הפלטפורמה — אם אתה משתמש בדומיין מותאם אישית, פתח בנפרד את כתובת ה-Prod ברירת המחדל. אם תת-הדומיין Prod מעודכן אבל הדומיין המותאם אישית לא, הבעיה היא במטמון DNS או CDN.

אם הבעיה נמשכת, ספק את כתובת ה-Preview URL, כתובת ה-Prod URL, צילומי מסך להשוואה זה לצד זה, ואת הזמן שבו לחצת על Publish או Update.

כאשר הסוכן משנה פריסה או עיצוב, הוא עלול בלי כוונה לשבור התנהגות רספונסיבית במסכים קטנים יותר.

1. הצג תחילה ברוחב נייד — השתמש במתג המכשיר בסרגל הכלים של מציג האפליקציה כדי לעבור לתצוגת נייד ולבדוק את התוצאה לפני פרסום.
2. השתמש ב-Design Mode בתצוגת נייד — עבור ל-Design Mode בזמן שמתג המכשיר מוגדר לנייד. לחץ על הרכיב השבור כדי שהסוכן יכוון רק לאותו רכיב בגודל המסך הזה.
3. ספק מגבלות רספונסיביות מפורשות — אמור לסוכן בדיוק איך פריסת הנייד צריכה להיראות. דוגמה: "במסכים צרים מ-768px, סדר את הכרטיסים בעמודה אחת והגדר padding ל-16px."
4. בקש מהסוכן לשמר media queries קיימים — כאשר מבקשים שינויים לשולחן עבודה, הוסף: "Do not modify any existing responsive or mobile styles."

אם הבעיה נמשכת, ספק את ה-Chat Link, צילום מסך של פריסת הנייד השבורה, ותמונת ייחוס של הפריסה הצפויה.

אם תמונות נראות שבורות, מציגות אייקוני מציין-מקום, או לא נטענות:

1. בדוק נתיבי קבצי תמונה — פתח את מקטע Files וודא שקבצי התמונה קיימים בנתיבים שאליהם הקוד שלך מפנה. ייתכן שהסוכן העביר או שינה את שמות הקבצים במהלך העריכות.
2. אמת גודל קובץ ופורמט — תמונות גדולות מאוד או פורמטים לא נתמכים עלולים לא להיטען. דחוס תמונות או המר ל-PNG, JPG, או WebP.
3. בדוק את אחסון Cloud — עבור אל Settings > Cloud & AI כדי לאשר שיש לך שטח אחסון זמין.
4. בצע רענון קשיח — לחץ על Cmd+Shift+R (Mac) או Ctrl+F5 (Windows) כדי לנקות הפניות שמורות לתמונות במטמון.

אם הבעיה נמשכת, ספק את ה-Chat Link, את ה-URL של התמונה החסרה, וצילום מסך של המצב השבור.

כאשר הסוכן משנה רכיבים לא קשורים או מכניס רגרסיות בחלקים אחרים של העמוד:

1. חזור לאחור — עבור אל History ובצע Remix מהגרסה היציבה האחרונה. זה מאפס את הקשר הצ'אט תוך שמירה על הקוד שלך.
2. השתמש ב-Design Mode כדי לבודד — עבור ל-Design Mode ולחץ ישירות על הרכיב הספציפי. זה מעגן את טווח העריכה של הסוכן לאותו רכיב.
3. הוסף מגבלות מפורשות — ציין בבירור מה אסור שישתנה. דוגמה: "Change only the header background color to #1A365D. Do not modify the navigation bar, footer, or any other component."
4. שינוי אחד לכל prompt — בצע שינוי אחד, אמת את התוצאה, ואז המשך לבא אחריו.

אם הסוכן שוב ושוב גורם לרגרסיה ברכיבים אחרים, בצע Remix מגרסה יציבה וגש שוב עם הוראה ממוקדת מאוד.

אם חלונית Preview מציגה שגיאת build, באנר שגיאה אדום, או הודעה על חבילות חסרות:

1. השתמש בכפתור Resolve — אם מופיעה התראת Issue Report ב-App Viewer, לחץ על Resolve וה-AI ינתח ויתקן אוטומטית את כל השגיאות שזוהו. אם לא מופיע כפתור Resolve, העתק את הודעת השגיאה המדויקת מחלונית Console והדבק אותה לסוכן עם: "Fix this build error: [הודעת שגיאה]."
2. בדוק שינויים אחרונים — אם השגיאה הופיעה לאחר עריכה מסוימת, עבור אל History והשווה לגרסה האחרונה שעבדה כדי לזהות איזה שינוי גרם לשבירה.
3. בצע Remix מהגרסה האחרונה שעבדה — אם קשה לפתור את השגיאה, בצע Remix מנקודת הביקורת המוצלחת האחרונה שלך והחל מחדש שינויים בהדרגה.
4. בדוק תאימות חבילות — אם השגיאה מתייחסת לחבילה מסוימת, בקש מהסוכן: "Check whether [שם החבילה] is compatible with the current project setup and fix any version conflicts."

הערה: אם הודעת השגיאה מתייחסת לרכיבי פלטפורמה (App Viewer, startup script, Publish, deploy record) או לקבצים פנימיים של חבילות צד שלישי (למשל @vue/compiler-core, vite), ייתכן שזו בעיית פלטפורמה ולא בעיית סוכן. פנה ל-Support עם הודעת השגיאה המלאה.

אם הבעיה נמשכת, ספק את הודעת השגיאה המלאה, את ה-Chat Link, וצילום מסך של השגיאה.

אם הסוכן מאשר שהשינוי בוצע אבל התוצאה החזותית לא השתנתה:

1. בצע רענון קשיח — לחץ על Cmd+Shift+R (Mac) או Ctrl+F5 (Windows). שינויים ב-CSS נשמרים לעיתים קרובות במטמון הדפדפן.
2. בדוק התנגשויות CSS specificity — ייתכן שהסוכן הוסיף סגנונות שנדרסים על ידי כללים קיימים. בקש מהסוכן: "Check whether the style I requested is being overridden by another CSS rule, and fix the specificity if needed."
3. השתמש ב-Design Mode לבדיקה — עבור ל-Design Mode ולחץ על הרכיב. העורך החזותי משמאל מציג את הצבעים, המרווחים, הטיפוגרפיה ומאפייני הפריסה שמוחלים כרגע, כך שאפשר לראות אם השינוי שביקשת הוחל.
4. ודא את הקובץ הנכון — בפרויקטים עם גם גיליונות סגנון גלובליים וגם סגנונות ברמת רכיב, ייתכן שהסוכן ערך את הקובץ הלא נכון. שאל: "Where did you apply the change? Show me the file path and line."

אם הבעיה נמשכת, ספק את ה-Chat Link, צילום מסך של הרכיב שלא השתנה, ואת ערכי הסגנון המדויקים שביקשת.

Design Mode משתמש בפריסה החזותית כדי לקבוע לאיזה רכיב אתה מכוון. רכיבים מקוננים או חופפים עלולים לגרום לבחירה שגויה.

1. התקרב — בצע זום לאזור לפני הלחיצה. זה עוזר להבחין בין רכיבים מקוננים בצפיפות.
2. השתמש בתיאור טקסט כגיבוי — אם לחיצה חוזרת בוחרת שוב ושוב את הרכיב הלא נכון, תאר אותו בצ'אט במקום זאת. דוגמה: "Select the second button inside the pricing card in the right column."
3. התייחס לפי נתיב קובץ — אם אתה יודע איזה קובץ מכיל את הרכיב, אמור זאת ישירות לסוכן: "Edit the element in src/components/PricingCard.tsx, line 42."

אם בעיות הבחירה נמשכות, ספק צילום מסך שמדגיש את הרכיב הרצוי ואת ה-Chat Link.