Im Marketplace veröffentlichen
Ein Plugin hochladen, in ein Projekt installieren und dann veröffentlichen: drei getrennte Schritte hinter drei verschiedenen Methoden und einer Prüfstufe.
Den Code eines Plugins auf die Festplatte zu bringen, es in ein Projekt zu installieren und es anderen Leuten zu zeigen, sind drei getrennte Aktionen, jede hinter einer eigenen Methode. Keine davon läuft automatisch für die anderen.
Hochladen
upload_plugin speichert das Katalogdokument des Plugins: sein Manifest (berechnet durch Scannen des
Pakets, wie es die Manifest-Seite beschreibt), seinen plugin_type, Label,
Beschreibung, Tags und version. Hier legst du den Datensatz eines Plugins an oder lädst eine neue Version
eines bestehenden hoch. Im Dashboard ist das das Editor-Sheet des Tabs Plugins
(Tab_plugins.vue), erreichbar über den Bereich Plugins eines Projekts.
Installieren
install_plugin bringt das Paket des Plugins in ein Projekt: Es installiert es per npm in das eigene
node_modules dieses Projekts und trägt es in die app_plugins_purchased-Map des Projekts ein. Ein Plugin kann
in ein Projekt installiert werden, ohne je öffentlich zu sein, so entwickelst du gegen deinen eigenen
Upload, bevor ihn jemand anderes sehen kann.
Veröffentlichen
publish_plugin ist der ausdrückliche, separate Schalter, der ein bereits hochgeladenes Plugin im
Marketplace-Katalog sichtbar macht (visibility: 'public') oder es wieder auf nur für den Eigentümer zurückzieht
(visibility: 'private'). Im Dashboard ist das der Schalter Sichtbarkeit im Marketplace bei einem
Plugin, das dir gehört. Das Hochladen oder Aktualisieren des Codes eines Plugins veröffentlicht es nie
von selbst.
Die Prüfstufe
Wer öffentlich geht, lässt publish_plugin durch eine Genehmigungsprüfung laufen
(marketplace_module.review_and_notify_external), es sei denn, das hochladende Konto ist ein vertrauenswürdiger
Herausgeber (das alte Xuda-Systemkonto oder ein konfigurierter Plattform-Supervisor). Das Ergebnis legt das
Plugin-Dokument in einem von drei Zuständen ab, gespiegelt auf publish_stat und das alte stat-
Feld: 3 genehmigt und live, 6 abgelehnt (mit gesetztem publish_reason und einem Einspruchslink, gebaut aus
approval.appeal_token) oder 1 noch in Prüfung. Ein abgelehntes oder in Prüfung befindliches Plugin wird
zurück auf visibility: 'private' gezwungen.
publish_plugin weigert sich, öffentlich zu gehen (code: -403), es sei denn, das Konto hat ein aktives Stripe-
Connect-Verkäuferkonto, dieselbe Hürde wie bei den Projekt-Marketplace-Einträgen. Ein vertrauenswürdiger Herausgeber
(die eigenen First-Party-Plugins der Plattform) überspringt auch diese.
Zustimmung, auf der Installationsseite
Bevor install_plugin irgendetwas schreibt, ruft es install_consent.build_plugin_consent() auf und
verlangt in der Anfrage eine passende, akzeptierte consent (mit einem content_hash, den der Server neu berechnet und prüft). Diese Seite wird direkt aus dem Manifest des Plugins aufgebaut, siehe
die Manifest-Seite dazu, was jede vorhandene Datei hinzufügt, dazu die
npm-Paket-ID und die zu installierende Version und ob das Plugin von einem anderen abhängt.
Die Plugin-Upload-Vereinbarung
dist/xuda_plugin_upload_user_agreement.html ist ein dauerhaftes Rechtsdokument: Das Hochladen eines Plugins
gewährt Xuda eine weltweite, gebührenfreie Lizenz, es zu nutzen, zu vervielfältigen, zu verbreiten und anzuzeigen, und der
Hochladende versichert, dass das Plugin sein eigenes Werk und frei von Malware ist, und sichert zu, dass er
Xuda diesbezüglich schadlos hält. Sie steht neben zwei verwandten Vereinbarungen im selben dist/-Ordner, einer Vereinbarung
zum Hochladen von Anwendungen und zur Umsatzbeteiligung und einer Muster-Lizenzvereinbarung für proprietäre Software, alle als
statische Dateien über den dist/-Pfad der Plattform ausgeliefert, so wie xuda-runtime-slim.js und andere Runtime-
Assets.
Die API-Oberfläche
Von den Plugin-Methoden haben nur get_plugins und get_plugins_categories die Clearance public:
Den Katalog zu durchsuchen braucht kein Konto. upload_plugin, install_plugin, uninstall_plugin und
get_app_plugins haben die Clearance admin und sind auf ein Projekt begrenzt. publish_plugin und archive_plugin
sind reine Dashboard-Aktionen und nicht Teil der öffentlichen 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.