פרסום בזירת המסחר
העלאת תוסף, התקנתו בפרויקט, ואז פרסומו, שלושה שלבים נפרדים מאחורי שלוש שיטות שונות ושער בדיקה אחד.
להעלות את הקוד של תוסף לדיסק, להתקין אותו בפרויקט ולהציג אותו לאנשים אחרים הן שלוש פעולות נפרדות, כל אחת מאחורי שיטה משלה. אף אחת מהן לא רצה אוטומטית בגלל האחרות.
העלאה
upload_plugin שומרת את מסמך הקטלוג של התוסף: המניפסט שלו (שמחושב בסריקת
החבילה כמתואר בדף המניפסט), ה-plugin_type, התווית,
התיאור, התגיות וה-version. כאן יוצרים את הרשומה של תוסף או דוחפים גרסה חדשה
של תוסף קיים. מהדשבורד זה עורך ה-Sheet של לשונית התוספים
(Tab_plugins.vue), שמגיעים אליו מהחלק תוספים של פרויקט.
התקנה
install_plugin מכניסה את החבילה של התוסף לפרויקט אחד: מתקינה אותה ב-npm אל
node_modules של אותו פרויקט, ורושמת אותה במפה app_plugins_purchased של הפרויקט. אפשר
להתקין תוסף בפרויקט בלי שהוא יהיה ציבורי אי פעם, כך מפתחים מול ההעלאה שלכם
לפני שמישהו אחר יכול לראות אותה.
פרסום
publish_plugin היא המתג המפורש והנפרד שהופך תוסף שכבר הועלה לגלוי
בקטלוג זירת המסחר (visibility: 'public') או מחזיר אותו לבעלים בלבד
(visibility: 'private'). בדשבורד זה המתג נראות בזירת המסחר בתוסף
שבבעלותכם. העלאה או עדכון של קוד התוסף לעולם לא מפרסמים אותו
מעצמם.
שער הבדיקה
מעבר לציבורי מריץ את publish_plugin דרך בדיקת אישור
(marketplace_module.review_and_notify_external), אלא אם החשבון המעלה הוא מפרסם מהימן
(חשבון המערכת הישן של Xuda, או מפקח פלטפורמה מוגדר). התוצאה מציבה
את מסמך התוסף באחד משלושה מצבים, שמשתקפים גם ב-publish_stat וגם בשדה הישן stat:
3 אושר ופעיל, 6 נדחה (עם publish_reason מוגדר, וקישור ערעור שנבנה מ-
approval.appeal_token), או 1 עדיין בבדיקה. תוסף שנדחה או שעדיין בבדיקה מוחזר בכוח
ל-visibility: 'private'.
publish_plugin מסרבת לעבור לציבורי (code: -403) אלא אם לחשבון יש חשבון מוכר פעיל ב-Stripe
Connect, אותו שער שרישומי זירת המסחר של פרויקטים משתמשים בו. מפרסם מהימן
(התוספים של הפלטפורמה עצמה) מדלג גם על זה.
הסכמה, בצד המתקין
לפני ש-install_plugin כותבת משהו, היא קוראת ל-install_consent.build_plugin_consent() ו
דורשת consent מאושר תואם (עם content_hash שהשרת מחשב מחדש ובודק) בבקשה.
המסך הזה נבנה ישירות מהמניפסט של התוסף, ראו
דף המניפסט בדיוק מה כל קובץ נוכח מוסיף לו, ובנוסף
מזהה חבילת npm והגרסה שמותקנים, והאם התוסף תלוי בתוסף אחר.
הסכם העלאת תוספים
dist/xuda_plugin_upload_user_agreement.html הוא מסמך משפטי קבוע: העלאת תוסף
מעניקה ל-Xuda רישיון עולמי ללא תמלוגים להשתמש בו, לשכפל אותו, להפיץ אותו ולהציג אותו, והמעלה
מצהיר שהתוסף הוא עבודה שלו, נקי מתוכנות זדוניות, ומתחייב לשפות את
Xuda בגינו. הוא ממוקם לצד שני הסכמים קשורים באותה תיקיית dist/, הסכם העלאת אפליקציה
ושיתוף הכנסות והסכם רישיון קנייני לדוגמה, כולם מוגשים כקבצים סטטיים מנתיב dist/ של הפלטפורמה
כמו xuda-runtime-slim.js ונכסי runtime אחרים.
משטח ה-API
מבין שיטות התוספים, רק get_plugins ו-get_plugins_categories הן ברמת הרשאה public,
עיון בקטלוג לא צריך חשבון. upload_plugin, install_plugin, uninstall_plugin ו-get_app_plugins
הן ברמת הרשאה admin, ברמת פרויקט. publish_plugin ו-archive_plugin
הן פעולות של הדשבורד בלבד ואינן חלק מה-API הציבורי.
Get Install Consent
Returns the install consent screen for one marketplace AI agent or plugin: what it does, who wrote it, the liability text, and the content hash the install has to echo back.