הרחבות לוח

עיון בהרחבות מותקנות ומקוונות

  1. פתחו התאמת הלוח הימני בסרגל הלשוניות של הלוח הימני.
  2. הרחיבו הרחבות מתחת לקו ההפרדה.
  3. השתמשו ב־חיפוש הרחבות לחיפוש ברשימה המאוחדת של תוספים מותקנים והקטלוג המקוון הרשמי. רחפו מעל רשומה או מקדו אותה להצגת המטא־נתונים שלה.

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

אם הקטלוג אינו זמין, ההרחבות המותקנות ו־התקנה מקובץ ZIP… נשארות זמינות. רעננו כדי לנסות שוב לגלות רשומות. כיווץ החלונית או סגירתה זונחים את ממשק הבדיקה/האישור הממתין; הם אינם מתקינים דבר בשקט.

בדיקה והתקנה ללא הפעלה

  1. בחרו התקנה… ברשומת קטלוג, או התקנה מקובץ ZIP… עבור חבילה שהשגתם בנפרד.
  2. בדקו את מזהה החבילה, המחבר, המאגר, הגרסה, ה־API/ההרשאות ותקציר SHA-256. הרחיבו פרטים טכניים לפי הצורך.
  3. אמתו את המפרסם, וכשאפשר השוו את התקציר בערוץ מהימן.
  4. רק אם אתם נותנים אמון בקוד, סמנו אני סומך על החבילה ועל המחבר שלה, ואז התקנה ללא הפעלה.

הבדיקה מורידה/מאמתת מחדש את החבילה שנבחרה; קוד המחבר אינו מורץ בבדיקה. תקציר מזהה בתים מדויקים, לא את זהות המחבר. חבילות הקטלוג מגיעות מנכס ההפצה המדויק שהוצהר ב־GitHub, לא מכתובת שרירותית. חבילות ידניות הן קובצי ZIP המכילים רק manifest.json ו־panel.html עצמאי; חבילות לא תקינות או לא נתמכות נדחות.

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

הפעלה והבנת ההיקף

  1. חזרו לשורת התוסף מעל הסעיף הרחבות ב־התאמת הלוח הימני. תוספים מותקנים ומושבתים נשארים ברשימה.
  2. סמנו את תיבת הסימון שלו כדי להפעילו. נקו את אותה תיבה כדי להשביתו.

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

מאגר ההרחבות הוא panel-extensions/ לצד תצורת CodeNomad שנבחרה. פרופילי נתונים נפרדים לשולחן העבודה אינם מבודדים הרחבות כאשר הפרופילים משתמשים באותה תיקיית תצורה. מנגד, פתיחת תצורה אחרת אינה מעניקה רשות להריץ תוסף שהותקן במקום אחר. ראו חלונות ונתונים בשולחן העבודה להבחנה.

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

החלפה או הסרה

  1. השתמשו ב־שינוי גרסה… או בדקו ZIP אחר בעל אותו מזהה כדי להחליף חבילה מותקנת.
  2. בדקו את התקציר וההרשאות החדשים, אשרו אמון והתקינו ללא הפעלה.
  3. הפעילו מחדש בתיבת הסימון הרגילה רק לאחר שהחלטתם לתת אמון בתחליף.
  4. להסרה, השתמשו ב־הסרה… וב־אישור הסרה לאחר בדיקת היעד.

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

הקשר, הסכמה לנכסים ומגבלות ארגז החול

חוזה מה ההפעלה מתירה
API 1 / session.context מזהה הסשן הנוכחי (או ללא מזהה), שפת הממשק והמראה. ללא טקסט תמליל או גישה למערכת הקבצים.
API 2 / session.assets.read נוסף על ההקשר הרשאה שנבדקה במפורש לרשימה מוגבלת של מטא־נתוני תמונות/קבצים מצורפים מתוצאות כלים בסשן הנוכחי ולקריאת בתים מוטמעים נתמכים. זו אינה גישה כללית לתמליל, לקבצים או לכתובות URL.

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

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

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