Publikálás a piactérre
Töltsön fel egy bővítményt, telepítse egy projektbe, majd publikálja, három külön lépés három különböző metódus mögött és egy ellenőrzési kapuval.
A bővítmény kódjának a lemezre juttatása, projektbe telepítése és mások elé helyezése három külön művelet, mindegyik a saját metódusa mögött. Egyik sem fut le automatikusan a többiért.
Feltöltés
Az upload_plugin elmenti a bővítmény katalógusdokumentumát: a manifestjét (amelyet a csomag átvizsgálásával számít ki, ahogyan a manifest oldal leírja), a plugin_type értékét, a címkét, leírást, címkéket és a version értéket. Itt hozza létre a bővítmény rekordját, vagy tölt fel új verziót egy meglévőhöz. Az irányítópultról ez a Bővítmények lap szerkesztő panelje (Tab_plugins.vue), amely a projekt Bővítmények szakaszából érhető el.
Telepítés
Az install_plugin a bővítmény csomagját egy projektbe teszi: npm-mel telepíti a projekt saját node_modules mappájába, és rögzíti a projekt app_plugins_purchased térképében. A bővítmény úgy is telepíthető egy projektbe, hogy sosem nyilvános, így fejleszthet a saját feltöltése ellen, mielőtt bárki más láthatná.
Publikálás
A publish_plugin a kifejezett, különálló kapcsoló, amely egy már feltöltött bővítményt láthatóvá tesz a piactéri katalógusban (visibility: 'public'), vagy visszahúzza csak a tulajdonos számára láthatóvá (visibility: 'private'). Az irányítópulton ez a Piactéri láthatóság kapcsoló egy általa birtokolt bővítményen. A bővítmény kódjának feltöltése vagy frissítése önmagában soha nem publikálja.
Az ellenőrzési kapu
A nyilvánossá tétel a publish_plugin hívást egy jóváhagyási ellenőrzésen futtatja át (marketplace_module.review_and_notify_external), kivéve, ha a feltöltő fiók megbízható kiadó (a régi Xuda rendszerfiók, vagy egy beállított platformfelügyelő). Az eredmény a bővítménydokumentumot három állapot egyikébe teszi, amelyek a publish_stat és a régi stat mezőn is tükröződnek: 3 jóváhagyva és élő, 6 elutasítva (a publish_reason beállítva, és az approval.appeal_token alapján épített fellebbezési hivatkozással), vagy 1 még ellenőrzés alatt. Az elutasított vagy ellenőrzés alatt álló bővítményt a rendszer visszakényszeríti visibility: 'private' értékre.
A publish_plugin nem hajlandó nyilvánossá tenni (code: -403), hacsak a fióknak nincs aktív Stripe Connect eladói fiókja, ugyanaz a kapu, amelyet a projekt piactéri listázásai is használnak. A megbízható kiadó (a platform saját elsődleges gyártói bővítményei) ezt is átugorja.
Hozzájárulás, a telepítő oldalán
Mielőtt az install_plugin bármit írna, meghívja az install_consent.build_plugin_consent() függvényt, és megköveteli egy egyező, elfogadott consent meglétét (egy content_hash értékkel, amelyet a szerver újraszámol és ellenőriz) a kérésben. Ez a képernyő közvetlenül a bővítmény manifestjéből épül fel, lásd a manifest oldalt, hogy pontosan mit ad hozzá minden jelen lévő fájl, plusz a telepített npm csomagazonosítót és verziót, és hogy a bővítmény függ-e másiktól.
A bővítmény-feltöltési szerződés
A dist/xuda_plugin_upload_user_agreement.html egy állandó jogi dokumentum: a bővítmény feltöltése világszerte érvényes, jogdíjmentes licencet ad a Xudának a használatra, sokszorosításra, terjesztésre és megjelenítésre, a feltöltő pedig kijelenti, hogy a bővítmény saját munkája, kártevőmentes, és szavatolja, hogy kártalanítja a Xudát érte. Két kapcsolódó szerződés mellett áll ugyanabban a dist/ mappában, egy alkalmazásfeltöltési és bevételmegosztási szerződés és egy minta szabadalmaztatott licencszerződés mellett, mind statikus fájlként szolgálva a platform dist/ útvonaláról, ahogyan az xuda-runtime-slim.js és más futtatókörnyezeti eszközök.
Az API-felület
A bővítménymetódusok közül csak a get_plugins és a get_plugins_categories public jogosultsági szintű, a katalógus böngészéséhez nem kell fiók. Az upload_plugin, install_plugin, uninstall_plugin és get_app_plugins admin jogosultsági szintű, projektre szűkítve. A publish_plugin és az archive_plugin csak irányítópult-műveletek, és nem részei a nyilvános API-nak.
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.