Publier sur la place de marché
[object Object]
Mettre le code d'un plugin sur disque, l'installer dans un projet et le présenter à d'autres personnes sont trois actions distinctes, chacune derrière sa propre méthode. Aucune ne déclenche automatiquement les autres.
Envoyer
upload_plugin enregistre le document de catalogue du plugin : son manifeste (calculé en analysant le paquet comme le
décrit la page du manifeste), son plugin_type, son libellé, sa description, ses
étiquettes et sa version. C'est ici que vous créez l'enregistrement d'un plugin ou que vous poussez une nouvelle
version d'un plugin existant. Depuis le tableau de bord, c'est la feuille d'édition de l'onglet Plugins
(Tab_plugins.vue), accessible depuis la section Plugins d'un projet.
Installer
install_plugin place le paquet du plugin dans un projet : il l'installe avec npm dans le propre node_modules de ce
projet, et l'enregistre dans la table app_plugins_purchased du projet. Un plugin peut être installé dans un projet
sans jamais être public : c'est ainsi que vous développez à partir de votre propre envoi avant que quiconque d'autre
puisse le voir.
Publier
publish_plugin est le commutateur explicite et distinct qui rend un plugin déjà envoyé visible dans le catalogue de
la place de marché (visibility: 'public') ou le ramène au propriétaire seul (visibility: 'private'). Dans le
tableau de bord, c'est le commutateur Visibilité sur la Marketplace d'un plugin dont vous êtes propriétaire.
Envoyer ou mettre à jour le code d'un plugin ne le publie jamais de lui-même.
La barrière de revue
Passer en public fait passer publish_plugin par un contrôle d'approbation
(marketplace_module.review_and_notify_external), sauf si le compte qui envoie est un éditeur de confiance (l'ancien
compte système de Xuda, ou un superviseur de plateforme configuré). Le résultat place le document du plugin dans l'un
de trois états, répercutés à la fois sur publish_stat et sur l'ancien champ stat : 3 approuvé et en ligne, 6
rejeté (avec publish_reason renseigné, et un lien d'appel construit à partir de approval.appeal_token), ou 1
encore en cours de revue. Un plugin rejeté ou en cours de revue est ramené de force à visibility: 'private'.
publish_plugin refuse de passer en public (code: -403) à moins que le compte n'ait un compte vendeur Stripe
Connect actif, la même barrière que celle des annonces de projets sur la place de marché. Un éditeur de confiance (les
propres plugins de première partie de la plateforme) en est aussi dispensé.
Le consentement, côté installation
Avant que install_plugin n'écrive quoi que ce soit, il appelle install_consent.build_plugin_consent() et exige
dans la requête un consent accepté correspondant (avec un content_hash que le serveur recalcule et vérifie). Cet
écran est construit directement à partir du manifeste du plugin, voir la page du manifeste
pour savoir exactement ce que chaque fichier présent y ajoute, ainsi qu'à partir de l'identifiant du paquet npm et de
la version installés, et du fait que le plugin dépende ou non d'un autre.
L'accord d'envoi de plugin
dist/xuda_plugin_upload_user_agreement.html est un document juridique permanent : envoyer un plugin accorde à Xuda
une licence mondiale et libre de redevance pour l'utiliser, le reproduire, le distribuer et l'afficher, et
l'expéditeur déclare que le plugin est son propre travail, exempt de logiciel malveillant, et garantit qu'il
indemnisera Xuda à ce sujet. Il se trouve à côté de deux accords liés dans le même dossier dist/, un accord d'envoi
d'application et de partage des revenus et un exemple d'accord de licence propriétaire, tous servis comme fichiers
statiques depuis le chemin dist/ de la plateforme, comme xuda-runtime-slim.js et d'autres ressources du runtime.
La surface d'API
Parmi les méthodes de plugin, seules get_plugins et get_plugins_categories ont l'habilitation public :
parcourir le catalogue ne demande aucun compte. upload_plugin, install_plugin, uninstall_plugin et
get_app_plugins ont l'habilitation admin, limitées à un projet. publish_plugin et archive_plugin sont des
actions réservées au tableau de bord et ne font pas partie de l'API publique.
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.