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

תצוגה מקדימה של האפליקציה

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

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

הלשונית App Preview ב-Ingot: חנות במסגרת iPhone 15 Pro בתצוגת מובייל, עם שורת הכתובת, צ'יפ הפורט, צ'יפ המכשיר ו-Pick elementהלשונית App Preview ב-Ingot: חנות במסגרת iPhone 15 Pro בתצוגת מובייל, עם שורת הכתובת, צ'יפ הפורט, צ'יפ המכשיר ו-Pick element
הלשונית App Preview ב-Ingot: חנות במסגרת iPhone 15 Pro בתצוגת מובייל, עם שורת הכתובת, צ'יפ הפורט, צ'יפ המכשיר ו-Pick element

פתיחת התצוגה המקדימה

איךאיפה
Open App Previewב-Find Action, או ⌘⌥⇧9 (Ctrl+Alt+Shift+9 ב-Windows וב-Linux)
Open in App Previewכפתור הטלפון ליד פורט בחלון Ports
שרת פיתוח בלשונית הריקההתצוגה המקדימה מציגה את שרתי הפיתוח שהיא מוצאת; לחצו על אחד כדי לפתוח אותו

הלשונית זוכרת את הכתובת, המכשיר והזום בין הפעלות.

שורת הכתובת והפורטים

הקלידו כתובת מלאה, מארח ונתיב (localhost:3000/cart) או רק פורט (5173) ולחצו Enter. אחורה, קדימה ורענון עובדים כמו בדפדפן.

צ'יפ הפורט מראה באיזה פורט אתם. לחצו עליו כדי לראות את שרתי הפיתוח ודפי האינטרנט שרצים במחשב שלכם:

קבוצהמה יש בה
Dev serversפורטים של פריימוורק פיתוח (Vite, Next.js, Nuxt, SvelteKit, Astro, Remix, Storybook, Gatsby, Expo, Angular, Webpack) או של סביבת ריצה (node, bun, deno, python, ruby, php, …), עם כותרת הדף
Other web pagesפורטים מקומיים אחרים שמגישים דף HTML, למשל אפליקציה שמפורסמת מקונטיינר Docker, עם התהליך שמחזיק בהם

מעבר פורט שומר על הדף: localhost:5173/cart?step=2 הופך ל-localhost:5174/cart?step=2. הקלידו פורט בתפריט כדי לפתוח פורט שלא מופיע. הרשימה מתעדכנת כל עוד התפריט פתוח. Switch Preview Port… ב-Find Action עושה את אותו הדבר מהמקלדת.

תפריט הפורטים של App Preview: שרתי פיתוח עם הפריימוורק וכותרת הדף, הפורט הנוכחי מסומן, ואחריהם דפי אינטרנט אחריםתפריט הפורטים של App Preview: שרתי פיתוח עם הפריימוורק וכותרת הדף, הפורט הנוכחי מסומן, ואחריהם דפי אינטרנט אחרים
תפריט הפורטים של App Preview: שרתי פיתוח עם הפריימוורק וכותרת הדף, הפורט הנוכחי מסומן, ואחריהם דפי אינטרנט אחרים

אילו פורטים מופיעים

תפריט הפורטים והלשונית הריקה מציעים רק פורטים שיכולים להיות האפליקציה שלכם. פורט מופיע כשהוא עונה ב-HTTP, ובנוסף:

  • התהליך שמחזיק בו הוא שרת פיתוח או סביבת ריצה: node, bun, deno, vite, next, webpack, python, uvicorn, ruby, rails, php, java, go וכדומה, או
  • הוא מגיש דף HTML (סטטוס מתחת ל-400).

אלה לא מופיעים אף פעם:

מה מושמטדוגמאות
הפורטים של Ingotהשרת של Ingot (INGOT_PORT, 3100 בגרסת הדפדפן), המקלט של האוטומציות (7391 כברירת מחדל), וכל פורט שחלון Ingot עצמו מחזיק
חלונות Ingot אחריםIngot נוסף, למשל גרסת הדפדפן שרצה על :3100, ושירותי העזר המקומיים של כל חלון Ingot אחר (כל אחד עונה עם כותרת x-ingot-service, ולכן אף פעם לא נחשב לשרת פיתוח)
שירותי מערכת ואפליקציות שולחן עבודהAirPlay (ControlCenter), rapportd, תהליכי עזר כמו Discord Helper או Slack Helper, שרתי שפה של סביבות פיתוח, Spotify, Postman
שירותי HTTP שאינם דפיםAPI מקומי של JSON שתהליך שאינו שרת פיתוח מחזיק, או דף שגיאה
מסדי נתונים ופורטי מערכתפורטים מתחת ל-1024, Postgres, MySQL, Redis, MongoDB וה-inspector של Node

עדיין אפשר לפתוח כל פורט: הקלידו אותו בתפריט או בשורת הכתובת.

תפריט הפורטים ותפריט המכשירים תמיד נשארים בתוך פאנל App Preview, גם כשהפאנל צר יותר מהתפריט: התפריט תופס לכל היותר את רוחב הפאנל ומתחיל בקצה השמאלי שלו.

תפריט הפורטים בפאנל App Preview ברוחב 388 פיקסלים ליד הצ׳אט: שני הקצוות בתוך הפאנל, Local servers עם שני שרתי פיתוח,‏ :40689 Vite Forge Shop ו-:33995 Forge Admin, ושום דבר של Ingotתפריט הפורטים בפאנל App Preview ברוחב 388 פיקסלים ליד הצ׳אט: שני הקצוות בתוך הפאנל, Local servers עם שני שרתי פיתוח,‏ :40689 Vite Forge Shop ו-:33995 Forge Admin, ושום דבר של Ingot
תפריט הפורטים בפאנל App Preview ברוחב 388 פיקסלים ליד הצ׳אט: שני הקצוות בתוך הפאנל, Local servers עם שני שרתי פיתוח,‏ :40689 Vite Forge Shop ו-:33995 Forge Admin, ושום דבר של Ingot
תפריט הפורטים של App Preview עם שרתי פיתוח ודפי אינטרנט בלבד: חנות Vite, אפליקציית Docker ושרתי node, בלי הפורט של Ingot ושירותי מערכתתפריט הפורטים של App Preview עם שרתי פיתוח ודפי אינטרנט בלבד: חנות Vite, אפליקציית Docker ושרתי node, בלי הפורט של Ingot ושירותי מערכת
תפריט הפורטים של App Preview עם שרתי פיתוח ודפי אינטרנט בלבד: חנות Vite, אפליקציית Docker ושרתי node, בלי הפורט של Ingot ושירותי מערכת

גדלי מכשירים

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

קטגוריהמכשירים
Responsiveממלא את הפאנל; הצ'יפ מראה את הגודל הנוכחי
טלפוניםiPhone SE (375×667), iPhone 15 Pro (393×852), iPhone 15 Pro Max (430×932), Pixel 8 (412×915), Galaxy S23 (360×780)
טאבלטיםiPad mini (768×1024), iPad Pro 11" (834×1194)
מחשביםLaptop (1280×800), Desktop (1440×900), Full HD (1920×1080)
Customרוחב וגובה משלכם, מ-200 עד 3840 פיקסלים
  • סיבוב מחליף בין רוחב לגובה לתצוגה לרוחב. בחירת מכשיר אחר חוזרת לתצוגה לאורך.
  • זום הוא Fit כברירת מחדל: מכשיר גדול מהפאנל מוקטן כדי להיכנס, והתפריט מראה את קנה המידה, למשל Fit (64%). בחרו 50%, 75%, 100% או 125% לגודל קבוע.
  • באפליקציית הדסקטופ, טלפונים וטאבלטים שולחים גם את ה-user agent הנייד שלהם, כך שאפליקציות שמגישות דפים אחרים לטלפונים מראות את דפי המובייל.

Choose Preview Device…, Rotate Preview Device ו-Reload App Preview נמצאים ב-Find Action.

Beta כדי לפתוח את הדף בסימולטורים של iOS, באמולטורים של Android ובטלפונים אמיתיים, עם מסגרות מכשיר וקוד QR, הפעילו את התצוגה המקדימה במובייל.

בחירת רכיב בשביל הסוכן

לחצו על Pick element (⌘⇧C, Ctrl+Shift+C כשהפוקוס בתצוגה המקדימה). העבירו את הסמן על הדף: הרכיב שמתחת לסמן מקבל מסגרת עם התגית, המחלקות והגודל שלו. לחצו כדי לבחור אותו. הדף לא מקבל את הלחיצה הזאת, כך שקישורים לא נפתחים וכפתורים לא עושים כלום. Escape או Cancel מפסיקים.

בחירה ב-App Preview: הכפתור Buy now מסומן במסגרת עם התווית button.buy.primary 138×35, ופס הבחירה עם Cancelבחירה ב-App Preview: הכפתור Buy now מסומן במסגרת עם התווית button.buy.primary 138×35, ופס הבחירה עם Cancel
בחירה ב-App Preview: הכפתור Buy now מסומן במסגרת עם התווית button.buy.primary 138×35, ופס הבחירה עם Cancel

הרכיב שנבחר מופיע בכרטיס מתחת לדף:

בכרטיסמה זה
תוויתהתגית עם ה-id והמחלקות, הטקסט והגודל, למשל <button.buy.primary> "Buy now — 49 €" 138×35
Selectorסלקטור CSS ייחודי: ה-id, data-testid או תגיות עם מחלקות יציבות
Sourceהקובץ והשורה שמהם הרכיב מגיע, כשהאפליקציה מספרת: מאפיין data-source, data-loc או data-inspector מתוסף מקור, גרסת הפיתוח של React, ה-__file של Vue או מטא-נתוני הפיתוח של Svelte

כתבו מה אתם רוצים ולחצו Enter או Send to agent: הבקשה והרכיב מגיעים לסוכן בהודעה אחת. Add to chat מוסיף צ'יפ של הרכיב לתיבת הצ'אט, כדי לכתוב הודעה ארוכה יותר או לבחור עוד רכיבים. לחיצה על הצ'יפ פותחת את קובץ המקור בשורה.

כרטיס הרכיב שנבחר: התווית, הסלקטור וקובץ המקור של הכפתור, בקשה לסוכן, ו-Add to chat ו-Send to agentכרטיס הרכיב שנבחר: התווית, הסלקטור וקובץ המקור של הכפתור, בקשה לסוכן, ו-Add to chat ו-Send to agent
כרטיס הרכיב שנבחר: התווית, הסלקטור וקובץ המקור של הכפתור, בקשה לסוכן, ו-Add to chat ו-Send to agent

מה הסוכן מקבל

הרכיב נשלח עם ההודעה שלכם כבלוק קצר:

Page: Forge Shop (http://localhost:5173/)
Device: iPhone 15 Pro · 393×852
Element: <button.buy.primary> "Buy now — 49 €"
Selector: button.buy.primary
Path: body > main > section.card > button.buy.primary
Source: src/components/BuyButton.tsx:8:7 (data attribute)
Box: 138×35 at (37, 169)
Styles: display: inline-block; background-color: rgb(59, 111, 217); border-radius: 8px; …
Attributes: type="button" class="buy primary"
HTML: <button class="buy primary" type="button">Buy now — 49 €</button>

נשלחים רק סגנונות ששונים מברירות המחדל של הדפדפן. ה-HTML, הטקסט והמאפיינים נחתכים לכמה מאות תווים, כך שרכיב גדול לא ממלא את הפרומפט. נתיב המקור יחסי לפרויקט.

דסקטופ ו-web

אפליקציית דסקטופגרסת web
הדףהאפליקציה רצה חיה, כולל הסקריפטים, בסשן משלה (עוגיות בנפרד מ-Ingot ומהדפדפן של הסוכן)השרת של Ingot טוען את הדף בלי להריץ את הסקריפטים שלו
User agent של המכשירנשלחלא נשלח
בחירת רכיביםכןכן

קיצורי מקלדת

פעולהmacOSWindows / Linux
Open App Preview⌘⌥⇧9Ctrl+Alt+Shift+9
Pick Element for Agent⌘⇧CCtrl+Shift+C
Cancel Element PickEscEsc
Add Picked Element to Agent Chat⌘⇧LCtrl+L
Switch Preview Port…⌘⌥PCtrl+Alt+P
Choose Preview Device…⌘⌥GCtrl+Alt+G
Rotate Preview Device⌘⌥JCtrl+Alt+J
Reload App Preview⌘⌥UCtrl+Alt+U

כל הקיצורים חוץ מ-Open App Preview עובדים כשהפוקוס בתצוגה המקדימה. כולם נמצאים ב-Find Action ובהגדרות מפת המקשים.

פרטיות

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

מהטרמינל

ingot preview מציג את אותם שרתים וגדלים, ובודק פורט מתוך סקריפטים:

ingot preview servers                       # שרתי פיתוח קודם, אחר כך דפי אינטרנט אחרים; --dev, --json
ingot preview devices                       # הגדלים וה-ids שמקבל --device
ingot preview check 5173 --wait 30          # מחכה ששרת פיתוח יענה; יוצא עם 1 אם לא
ingot preview check localhost:3000/cart --device iphone-15-pro --json
פקודהמה היא עושה
serversאותם פורטים כמו בתפריט הפורטים (ראו אילו פורטים מופיעים), באותו סדר, עם פריימוורק, כותרת ותהליך. --dev משאיר רק שרתי פיתוח; --exclude <port> משמיט פורטים
devicesגדלי המכשירים וה-ids שלהם
check <port|url>סטטוס, כותרת הדף ופריימוורק. יוצא עם 1 כשאף אחד לא עונה או שהדף הוא שגיאה. --wait <seconds> ממשיך לנסות; --device <id> מוסיף את רוחב התצוגה וה-user agent

כל הפקודות מקבלות --json. לא נקרא שום מודל ולא צריך חשבון.