Vai al contenuto
Bozza

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

Serve un account venditore

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.

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.