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