Naar de inhoud springen
Concept

Publiceren in de marketplace

[object Object]

De code van een plug-in op schijf krijgen, de plug-in in een project installeren en hem aan andere mensen laten zien zijn drie aparte acties, elk met een eigen methode. Geen van de drie draait automatisch voor een van de andere.

Uploaden

upload_plugin slaat het cataloogdocument van de plug-in op: het manifest (berekend door het pakket te scannen zoals de manifestpagina beschrijft), het plugin_type, het label, de beschrijving, de tags en de version. Hier maak je het record van een plug-in aan of push je een nieuwe versie van een bestaande. In het dashboard is dit de editor-Sheet van het tabblad Plug-ins (Tab_plugins.vue), bereikbaar via het onderdeel Plug-ins van een project.

Installeren

install_plugin zet het pakket van de plug-in in één project: het wordt met npm geïnstalleerd in de eigen node_modules van dat project en vastgelegd in de app_plugins_purchased-map van het project. Een plug-in kan in een project worden geïnstalleerd zonder ooit openbaar te zijn. Zo ontwikkel je tegen je eigen upload voordat iemand anders hem kan zien.

Publiceren

publish_plugin is de expliciete, aparte schakelaar die een al geüploade plug-in zichtbaar maakt in de marketplacecatalogus (visibility: 'public') of hem terugzet naar alleen-eigenaar (visibility: 'private'). In het dashboard is dit de schakelaar Marketplace Visibility bij een plug-in die van jou is. Het uploaden of bijwerken van de code van een plug-in publiceert hem nooit vanzelf.

De beoordelingspoort

Openbaar maken laat publish_plugin door een goedkeuringscontrole lopen (marketplace_module.review_and_notify_external), tenzij het uploadende account een vertrouwde uitgever is (het oude Xuda-systeemaccount of een geconfigureerde platformsupervisor). Het resultaat zet het plug-indocument in een van drie toestanden, die zowel in publish_stat als in het oude veld stat worden gespiegeld: 3 goedgekeurd en live, 6 afgewezen (met publish_reason ingevuld en een beroepslink die is opgebouwd uit approval.appeal_token), of 1 nog in beoordeling. Een afgewezen plug-in of een plug-in in beoordeling wordt teruggezet naar visibility: 'private'.

Een verkopersaccount is vereist

publish_plugin weigert openbaar te maken (code: -403) tenzij het account een actief Stripe Connect-verkopersaccount heeft, dezelfde poort die de projectlijstingen in de marketplace gebruiken. Een vertrouwde uitgever (de eigen first-party plug-ins van het platform) slaat dit ook over.

Toestemming, aan de kant van de installatie

Voordat install_plugin iets schrijft, roept het install_consent.build_plugin_consent() aan en eist het een bijpassende geaccepteerde consent (met een content_hash die de server opnieuw berekent en controleert) in het verzoek. Dat scherm wordt rechtstreeks uit het manifest van de plug-in opgebouwd. Zie de manifestpagina voor wat elk aanwezig bestand eraan toevoegt, plus de npm-pakket-id en de versie die wordt geïnstalleerd, en of de plug-in van een andere plug-in afhangt.

De uploadovereenkomst voor plug-ins

dist/xuda_plugin_upload_user_agreement.html is een vaststaand juridisch document: door een plug-in te uploaden geef je Xuda een wereldwijde, royaltyvrije licentie om hem te gebruiken, te reproduceren, te distribueren en weer te geven. De uploader verklaart dat de plug-in zijn eigen werk is, vrij van malware, en garandeert dat hij Xuda daarvoor schadeloos stelt. Het staat naast twee verwante overeenkomsten in dezelfde map dist/: een overeenkomst voor het uploaden van applicaties en omzetdeling, en een voorbeeld van een licentieovereenkomst voor propriëtaire software. Alle drie worden als statische bestanden geserveerd vanaf het dist/-pad van het platform, op dezelfde manier als xuda-runtime-slim.js en andere runtime-assets.

Het API-oppervlak

Van de plug-inmethoden hebben alleen get_plugins en get_plugins_categories de clearance public: voor het bladeren door de catalogus is geen account nodig. upload_plugin, install_plugin, uninstall_plugin en get_app_plugins hebben de clearance admin en gelden voor één project. publish_plugin en archive_plugin zijn acties die alleen in het dashboard bestaan en maken geen deel uit van de publieke API.

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.