CodeNomad עזרה

תצוגות דפדפן ו־SideCars

פתיחת דפדפן לסשן

  1. בסרגל הכלים של שיחה, בחרו פתח תצוגה מקדימה של אתר.
  2. הזינו ב־כתובת URL לתצוגה מקדימה כתובת http:// או https:// ללא פרטי התחברות, ואז בחרו פתח תצוגה מקדימה. השתמשו בסרגל הכלים לניווט, לרענון ולמעבר אחורה/קדימה.
  3. השתמשו בכפתור הסגירה של התצוגה כדי לחזור לצ׳אט. פתחו אותה שוב באותה שיחה כדי להמשיך.

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

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

התחברויות משותפות וגבולות אוטומציה

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

לקוח מימוש התצוגה אוטומציית דפדפן של סוכן תבניות נייד
Electron בפלטפורמות שולחן עבודה נתמכות אורח Chromium מקורי נתמכת לתצוגת הסשן הגלויה שבבעלות היישום הדמיית זהות Android/Chromium, מגע וצפיפות
Tauri ב־Windows חלון־בת מקורי של WebView2 נתמכת לתצוגת הסשן הגלויה שבבעלות היישום הדמיית זהות Android/Chromium, מגע וצפיפות
Tauri ב־macOS/Linux iframe בארגז חול ללא אוטומציית דפדפן מקורית ממדים בלבד
דפדפן רגיל/תצוגה מרוחקת חלופת iframe ללא יעד תצוגה מקומית מקורית ממדים בלבד

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

בחירת אחת משש תבניות אזור התצוגה

  1. פתחו את תפריט אזור התצוגה של התצוגה המקדימה.
  2. בחרו תבנית להלן. השתמשו ישירות ברשומות לאורך/לרוחב; אין פקד סיבוב נפרד.
  3. צפו לטעינה מקורית מחדש בעת כניסה להדמיית נייד/שינויה או חזרה לתבנית של ממדים בלבד.
תבנית אזור תצוגה בפיקסלי CSS
אזור תצוגה מגיב שטח התצוגה המקדימה הזמין
אזור תצוגה לשולחן עבודה 1440 × 900
אזור תצוגה לטאבלט 768 × 1024
טאבלט לרוחב 1024 × 768
אזור תצוגה לנייד 390 × 844
נייד לרוחב 844 × 390

תבניות נייד מקוריות מגדירות זהות Android/Chromium, כיוון, מגע ו־DPR 2.75 באורח שבבעלות היישום בלבד. חזרה לתצוגה מגיבה/שולחן עבודה/טאבלט מנקה את הדריסות האלה וטוענת מחדש. חלופת iframe רק משנה גודל. אלו נקודות ייחוס לפריסה שניתנות לשחזור, לא הדמיית Safari/Firefox או סימולציות של מקלדות טלפון, סרגלי דפדפן/מערכת או הגדרות טקסט של מערכת הפעלה ניידת. שמרו עבודה בדף לפני החלפת תבניות כי טעינה מחדש עלולה להשליך מצב דף שלא נשלח.

רישום SideCar

  1. הפעילו את כלי הרשת בנפרד במארח שרת הקצה של CodeNomad, בהאזנה ב־127.0.0.1:<port>.
  2. פתחו הגדרות → SideCars. הזינו שם ו־פורט; בדקו את נתיב בסיס הנגזר (/sidecars/<id>).
  3. הגדירו פרוטוקול בהתאם לשירות שמאחוריו, ובחרו מצב קידומת.
  4. בחרו הוסף SideCar, ואז פתח SideCar מדף הבית לפתיחת הלשונית שלו.
בחירה השפעה מדויקת
HTTPS (ברירת המחדל בטופס) CodeNomad מתחבר לשירות שמאחוריו ב־https://127.0.0.1:<port>.
HTTP CodeNomad מתחבר לשירות שמאחוריו ב־http://127.0.0.1:<port>. הדבר אינו משנה את הגדרת TLS של חיבור CodeNomad הציבורי.
הסר קידומת (ברירת מחדל) /sidecars/<id>/path מועבר לשירות שמאחוריו בתור /path.
שמור קידומת /sidecars/<id>/path מועבר לשירות שמאחוריו ללא שינוי. הגדירו את נתיב הבסיס של השירות עצמו בהתאמה.

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

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

SideCar הוא הרחבה מהימנה של CodeNomad, לא תצוגה מקדימה בארגז חול: הדף שלו רץ במקור (origin) של CodeNomad עצמו, ולכן הסקריפטים שלו יכולים להשתמש ב־CodeNomad עם הגישה שלכם כמשתמשים מחוברים. רשמו רק שירותים שאתם סומכים על הקוד שלהם. CodeNomad אינו מעביר לשירות את עוגיות ההתחברות שלו, ואילו העוגיות של השירות עצמו נשמרות. שליטה מרחוק אינה חושפת תעבורת מתווך של יישומי SideCar; השתמשו בנתיב הגישה הישירה המתאים המתואר ב־גישה מרחוק וב־שליטה מרחוק.

מתכון ל־OpenVSCode Server

  1. במארח שרת הקצה, הריצו Docker כשהשירות מאזין ב־loopback:
docker run -it --init -p 127.0.0.1:8000:3000 -v "${HOME}:${HOME}:cached" -e HOME=${HOME} gitpod/openvscode-server --server-base-path /sidecars/vscode
  1. רשמו שם VSCode, פורט 8000, פרוטוקול HTTP, מצב קידומת שמור קידומת.
  2. ודאו שנתיב הבסיס המוצג הוא /sidecars/vscode, ואז פתחו את ה־SideCar.

מתכון מעטפת זה ממפה את תיקיית הבית שלכם למכל; השתמשו במיפוי מצומצם יותר אם זו כל הגישה שהעורך אמור לקבל. --server-base-path של השירות חייב להתאים בדיוק לרישום. עצרו את המכל בנפרד בסיום; מחיקת ה־SideCar אינה מסירה אותו או את קבציו.

מתכון למסוף ttyd

  1. במארח שרת הקצה, הפעילו מסוף מעטפת הניתן לכתיבה בהאזנת loopback:
ttyd --interface 127.0.0.1 --writable zsh
  1. רשמו שם Terminal, פורט 7681, פרוטוקול HTTP, מצב קידומת הסר קידומת.
  2. פתחו את ה־SideCar בנתיב הבסיס המוצג /sidecars/terminal.

המסוף פועל בהרשאות החשבון שהפעיל ttyd. בחרו מעטפת אחרת אם zsh אינו זמין. השתמשו ביציאה בפועל אם שיניתם את ברירת המחדל של ttyd, ועצרו ttyd בנפרד בסיום. אמתו והגנו על הגישה ל־CodeNomad; מסוף הניתן לכתיבה אינו ארגז חול.