Udgiv i marketplace
Upload et plugin, installer det i et projekt og udgiv det, tre adskilte trin bag tre forskellige metoder og én gennemgangsport.
At få et plugins kode ind på disken, installere det i et projekt og vise det frem for andre er tre adskilte handlinger, og hver har sin egen metode. Ingen af dem udløser de andre automatisk.
Upload
upload_plugin gemmer pluginets katalogdokument: dets manifest (beregnet ved at scanne pakken, som
manifestsiden beskriver), dets plugin_type, label, beskrivelse, tags og
version. Her opretter du et plugins post eller sender en ny version af et eksisterende. I
dashboardet er det Plugins-fanens redigeringspanel (Tab_plugins.vue), som du når fra et projekts
afsnit Plugins.
Installer
install_plugin lægger pluginets pakke i ét projekt: den npm-installerer den i projektets egen
node_modules og registrerer den i projektets app_plugins_purchased-oversigt. Et plugin kan
installeres i et projekt uden nogensinde at være offentligt. Sådan udvikler du mod dit eget upload,
før andre kan se det.
Udgiv
publish_plugin er det eksplicitte, adskilte kontaktpunkt, der gør et allerede uploadet plugin
synligt i marketplace-kataloget (visibility: 'public') eller trækker det tilbage til kun ejeren
(visibility: 'private'). I dashboardet er det kontakten Marketplace Visibility på et plugin,
du ejer. At uploade eller opdatere et plugins kode udgiver det aldrig af sig selv.
Gennemgangsporten
Når et plugin gøres offentligt, kører publish_plugin en godkendelseskontrol
(marketplace_module.review_and_notify_external), medmindre den uploadende konto er en betroet
udgiver (den gamle Xuda-systemkonto eller en konfigureret platformsupervisor). Resultatet lander
plugin-dokumentet i en af tre tilstande, som spejles på både publish_stat og det gamle
stat-felt: 3 godkendt og live, 6 afvist (med publish_reason sat og et appel-link bygget af
approval.appeal_token) eller 1 stadig under gennemgang. Et afvist plugin eller et plugin under
gennemgang tvinges tilbage til visibility: 'private'.
publish_plugin nægter at gå offentligt (code: -403), medmindre kontoen har en aktiv Stripe
Connect-sælgerkonto, den samme port som projekternes marketplace-opslag bruger. En betroet udgiver
(platformens egne førsteparts-plugins) springer også denne over.
Samtykke, på installationssiden
Før install_plugin skriver noget, kalder den install_consent.build_plugin_consent() og kræver et
matchende accepteret consent (med en content_hash, som serveren genberegner og kontrollerer) i
forespørgslen. Den skærm bygges direkte ud fra pluginets manifest, se
manifestsiden for præcis, hvad hver tilstedeværende fil tilføjer til den,
plus npm-pakke-id'et og den version, der installeres, og om pluginet afhænger af et andet.
Aftalen om upload af plugins
dist/xuda_plugin_upload_user_agreement.html er et stående juridisk dokument: når du uploader et
plugin, giver du Xuda en verdensomspændende, royaltyfri licens til at bruge, gengive, distribuere og
vise det, og uploaderen erklærer, at pluginet er vedkommendes eget arbejde og fri for malware, og
garanterer, at vedkommende holder Xuda skadesløs i den forbindelse. Det ligger sammen med to
beslægtede aftaler i samme dist/-mappe, en aftale om upload af applikationer og indtægtsdeling og
en eksempelaftale om proprietær licens, alle serveret som statiske filer fra platformens
dist/-sti, på samme måde som xuda-runtime-slim.js og andre runtime-ressourcer.
API-fladen
Af plugin-metoderne har kun get_plugins og get_plugins_categories adgangsniveauet public: du
behøver ingen konto for at browse kataloget. upload_plugin, install_plugin, uninstall_plugin
og get_app_plugins har adgangsniveauet admin og er afgrænset til ét projekt. publish_plugin
og archive_plugin er handlinger kun i dashboardet og er ikke en del af det offentlige 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.