Pubblicare nel marketplace
[object Object]
Portare il codice di un plugin su disco, installarlo in un progetto e metterlo davanti ad altre persone sono tre azioni separate, ciascuna dietro un proprio metodo. Nessuna di esse esegue automaticamente le altre.
Carica
upload_plugin salva il documento di catalogo del plugin: il suo manifest (calcolato scansionando il
pacchetto come descrive la pagina del manifest), il suo plugin_type,
l'etichetta, la descrizione, i tag e la version. È qui che crei il record di un plugin o carichi
una nuova versione di uno esistente. Dalla dashboard si fa con lo Sheet dell'editor della scheda
Plugin (Tab_plugins.vue), raggiungibile dalla sezione Plugin di un progetto.
Installa
install_plugin porta il pacchetto del plugin in un progetto: lo installa con npm nel node_modules
del progetto stesso e lo registra nella mappa app_plugins_purchased del progetto. Un plugin può
essere installato in un progetto senza essere mai pubblico: è così che sviluppi contro il tuo
caricamento prima che chiunque altro possa vederlo.
Pubblica
publish_plugin è l'interruttore esplicito e separato che rende visibile nel catalogo del
marketplace un plugin già caricato (visibility: 'public') oppure lo riporta alla sola visibilità
del proprietario (visibility: 'private'). Nella dashboard è l'interruttore Visibilità nel
Marketplace su un plugin di cui sei proprietario. Caricare o aggiornare il codice di un plugin non
lo pubblica mai da solo.
Il controllo di revisione
Per diventare pubblico, publish_plugin passa attraverso un controllo di approvazione
(marketplace_module.review_and_notify_external), a meno che l'account che carica non sia un
publisher attendibile (il vecchio account di sistema di Xuda, o un supervisor di piattaforma
configurato). Il risultato porta il documento del plugin in uno di tre stati, rispecchiati sia su
publish_stat sia sul vecchio campo stat: 3 approvato e online, 6 rifiutato (con
publish_reason impostato e un link di ricorso costruito da approval.appeal_token), oppure 1
ancora in revisione. Un plugin rifiutato o in revisione viene riportato a forza a
visibility: 'private'.
publish_plugin si rifiuta di rendere pubblico un plugin (code: -403) a meno che l'account non
abbia un account venditore Stripe Connect attivo, lo stesso requisito delle schede del marketplace
dei progetti. Un publisher attendibile (i plugin proprietari della piattaforma) salta anche questo.
Il consenso, lato installazione
Prima che install_plugin scriva qualsiasi cosa, chiama install_consent.build_plugin_consent() e
richiede nella richiesta un consent accettato corrispondente (con un content_hash che il server
ricalcola e controlla). Quella schermata è costruita direttamente dal manifest del plugin, vedi
la pagina del manifest per sapere esattamente cosa aggiunge ciascun file
presente, più l'id del pacchetto npm e la versione che si sta installando, e se il plugin dipende da
un altro.
L'accordo di caricamento dei plugin
dist/xuda_plugin_upload_user_agreement.html è un documento legale permanente: caricare un plugin
concede a Xuda una licenza mondiale e libera da royalty per usarlo, riprodurlo, distribuirlo e
mostrarlo, e chi lo carica dichiara che il plugin è opera sua e privo di malware, e garantisce che
manleverà Xuda al riguardo. Si trova insieme ad altri due accordi correlati nella stessa cartella
dist/, un accordo di caricamento di applicazioni e di ripartizione dei ricavi e un esempio di
accordo di licenza proprietaria, tutti serviti come file statici dal percorso dist/ della
piattaforma, come xuda-runtime-slim.js e altri asset di runtime.
La superficie API
Tra i metodi dei plugin, solo get_plugins e get_plugins_categories hanno clearance public:
sfogliare il catalogo non richiede alcun account. upload_plugin, install_plugin,
uninstall_plugin e get_app_plugins hanno clearance admin, limitata a un progetto.
publish_plugin e archive_plugin sono azioni solo da dashboard e non fanno parte dell'API pubblica.
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.