Publisering i markedsplassen
Last opp en plugin, installer den i et prosjekt og publiser den. Tre separate trinn bak tre ulike metoder og én gjennomgangsport.
Å få en plugins kode på disk, installere den i et prosjekt og vise den frem for andre er tre separate handlinger, hver bak sin egen metode. Ingen av dem kjøres automatisk av de andre.
Last opp
upload_plugin lagrer pluginens katalogdokument: manifestet (beregnet ved å skanne pakken slik
manifestsiden beskriver), plugin_type, etikett, beskrivelse, tagger og
version. Her oppretter du pluginens post eller sender en ny versjon av en eksisterende. Fra
dashbordet skjer dette i redigeringspanelet i Plugins-fanen (Tab_plugins.vue), som du når fra
Plugin-moduler-delen i et prosjekt.
Installer
install_plugin legger pluginens pakke inn i ett prosjekt: den npm-installerer den i prosjektets
egen node_modules og registrerer den i prosjektets app_plugins_purchased-kart. En plugin kan
installeres i et prosjekt uten å noensinne være offentlig. Slik utvikler du mot din egen opplasting
før noen andre kan se den.
Publiser
publish_plugin er den eksplisitte, separate bryteren som gjør en allerede opplastet plugin synlig
i markedsplassens katalog (visibility: 'public') eller trekker den tilbake til bare eieren
(visibility: 'private'). I dashbordet er dette Marketplace Visibility-bryteren på en plugin du
eier. Å laste opp eller oppdatere pluginens kode publiserer den aldri av seg selv.
Gjennomgangsporten
Når du går offentlig, kjører publish_plugin en godkjenningssjekk
(marketplace_module.review_and_notify_external), med mindre kontoen som laster opp er en betrodd
utgiver (den gamle Xuda-systemkontoen eller en konfigurert plattformveileder). Resultatet setter
plugin-dokumentet i én av tre tilstander, speilet på både publish_stat og det gamle stat-feltet:
3 godkjent og live, 6 avvist (med publish_reason satt og en ankelenke bygget fra
approval.appeal_token), eller 1 fortsatt under gjennomgang. En avvist plugin eller en plugin
under gjennomgang tvinges tilbake til visibility: 'private'.
publish_plugin nekter å gå offentlig (code: -403) med mindre kontoen har en aktiv Stripe
Connect-selgerkonto, den samme porten som prosjektoppføringene i markedsplassen bruker. En betrodd
utgiver (plattformens egne førstepartsplugins) hopper også over dette.
Samtykke, på installasjonssiden
Før install_plugin skriver noe, kaller den install_consent.build_plugin_consent() og krever et
samsvarende godkjent consent (med en content_hash som serveren beregner på nytt og sjekker) i
forespørselen. Den skjermen bygges rett fra pluginens manifest, se
manifestsiden for nøyaktig hva hver fil som finnes legger til, pluss
npm-pakke-ID-en og versjonen som installeres, og om pluginen er avhengig av en annen.
Avtalen for plugin-opplasting
dist/xuda_plugin_upload_user_agreement.html er et stående juridisk dokument: ved å laste opp en
plugin gir du Xuda en verdensomspennende, royaltyfri lisens til å bruke, kopiere, distribuere og vise
den, og den som laster opp erklærer at pluginen er eget verk og fri for skadevare, og garanterer at
vedkommende holder Xuda skadesløs i den forbindelse. Den ligger ved siden av to beslektede avtaler i
den samme dist/-mappen, en avtale om opplasting av applikasjoner og inntektsdeling og en eksempelavtale
om proprietær lisens. Alle serveres som statiske filer fra plattformens dist/-sti, på samme måte
som xuda-runtime-slim.js og andre kjøretidsressurser.
API-flaten
Av plugin-metodene er det bare get_plugins og get_plugins_categories som har public
tilgangsnivå, så det kreves ingen konto for å bla i katalogen. upload_plugin, install_plugin,
uninstall_plugin og get_app_plugins har admin-nivå og gjelder ett prosjekt. publish_plugin og
archive_plugin er handlinger kun for dashbordet og er ikke en del av det offentlige API-et.
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.