Siirry sisältöön
Tarkistettu

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'.

Myyjätili vaaditaan

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.

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.

POST/cpi/get_install_consent
user

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.