Julkaiseminen marketplacessa
Lataa lisäosa, asenna se projektiin ja julkaise se. Nämä ovat kolme erillistä vaihetta kolmen eri metodin takana, ja yksi tarkistusportti.
Lisäosan koodin tallentaminen levylle, sen asentaminen projektiin ja sen tuominen muiden nähtäville ovat kolme erillistä toimintoa, joilla kullakin on oma metodinsa. Mikään niistä ei käynnisty automaattisesti toisen perässä.
Lataus
upload_plugin tallentaa lisäosan katalogidokumentin: sen manifestin (lasketaan skannaamalla paketti
tavalla, jonka manifestisivu kuvaa), plugin_type-arvon, nimen, kuvauksen,
tunnisteet ja version-arvon. Tässä luodaan lisäosan tietue tai viedään olemassa olevasta uusi versio.
Hallintapaneelista tämä tapahtuu Lisäosat-välilehden muokkauspaneelissa (Tab_plugins.vue), johon
pääset projektin Lisäosat-osiosta.
Asennus
install_plugin vie lisäosan paketin yhteen projektiin: se asentaa paketin npm:llä projektin omaan
node_modules-kansioon ja kirjaa sen projektin app_plugins_purchased-karttaan. Lisäosan voi asentaa
projektiin, vaikka se ei olisi koskaan julkinen. Näin kehität oman latauksesi kanssa, ennen kuin kukaan
muu näkee sen.
Julkaisu
publish_plugin on erillinen, nimenomainen kytkin, joka tekee jo ladatusta lisäosasta näkyvän
marketplacen katalogissa (visibility: 'public') tai palauttaa sen vain omistajan nähtäville
(visibility: 'private'). Hallintapaneelissa tämä on omistamasi lisäosan Marketplace Visibility
-kytkin. Lisäosan koodin lataaminen tai päivittäminen ei koskaan julkaise sitä itsestään.
Tarkistusportti
Julkiseksi siirtyminen ajaa publish_plugin-metodin hyväksyntätarkistuksen
(marketplace_module.review_and_notify_external) läpi, ellei lataava tili ole luotettu julkaisija
(vanha Xudan järjestelmätili tai määritetty alustan valvoja). Tuloksena lisäosan dokumentti päätyy
yhteen kolmesta tilasta, jotka kirjataan sekä publish_stat- että vanhaan stat-kenttään: 3
hyväksytty ja julkaistu, 6 hylätty (publish_reason asetettuna ja valituslinkki rakennettuna
approval.appeal_token-arvosta) tai 1 vielä tarkistettavana. Hylätty tai tarkistuksessa oleva
lisäosa pakotetaan takaisin tilaan visibility: 'private'.
publish_plugin kieltäytyy siirtämästä lisäosaa julkiseksi (code: -403), ellei tilillä ole aktiivista
Stripe Connect -myyjätiliä. Sama portti koskee projektien marketplace-listauksia. Luotettu julkaisija
(alustan omat ensimmäisen osapuolen lisäosat) ohittaa tämänkin.
Suostumus asentavalla puolella
Ennen kuin install_plugin kirjoittaa mitään, se kutsuu install_consent.build_plugin_consent()-funktiota
ja vaatii pyynnössä vastaavan hyväksytyn consent-arvon (jonka content_hash-arvon palvelin laskee
uudelleen ja tarkistaa). Näyttö rakennetaan suoraan lisäosan manifestista. Katso
manifestisivulta, mitä kukin läsnä oleva tiedosto siihen lisää. Mukana ovat
myös asennettavan npm-paketin tunnus ja versio sekä tieto siitä, riippuuko lisäosa toisesta.
Lisäosan latausehdot
dist/xuda_plugin_upload_user_agreement.html on pysyvä oikeudellinen asiakirja: lisäosan lataaminen
antaa Xudalle maailmanlaajuisen, rojaltivapaan oikeuden käyttää, jäljentää, jakaa ja esittää sitä, ja
lataaja vakuuttaa lisäosan olevan hänen omaa työtään ja vapaa haittaohjelmista sekä sitoutuu
korvaamaan Xudalle siihen liittyvät vahingot. Samassa dist/-kansiossa on kaksi muuta asiakirjaa,
sovelluksen latausta ja tulonjakoa koskeva sopimus sekä esimerkki omistusoikeudellisesta
lisenssisopimuksesta. Kaikki tarjoillaan staattisina tiedostoina alustan dist/-polusta samalla tavalla
kuin xuda-runtime-slim.js ja muut ajonaikaiset resurssit.
API-pinta
Lisäosametodeista vain get_plugins ja get_plugins_categories ovat public-tasoisia, eli katalogin
selaaminen ei vaadi tiliä. upload_plugin, install_plugin, uninstall_plugin ja get_app_plugins
ovat admin-tasoisia ja rajattu yhteen projektiin. publish_plugin ja archive_plugin ovat vain
hallintapaneelin toimintoja, eivätkä ne kuulu julkiseen API:in.
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.