Aller au contenu
Brouillon

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

Un compte vendeur est requis

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.

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.