Publikování na marketplace
Nahrajte plugin, nainstalujte ho do projektu a pak ho publikujte. Jsou to tři samostatné kroky se třemi různými metodami a jednou schvalovací bránou.
Dostat kód pluginu na disk, nainstalovat ho do projektu a zpřístupnit ho ostatním jsou tři samostatné akce, každá se svou vlastní metodou. Žádná z nich neběží automaticky místo ostatních.
Nahrání
upload_plugin uloží katalogový dokument pluginu: jeho manifest (spočítaný prohledáním balíčku
způsobem popsaným na stránce o manifestu), jeho plugin_type, popisek,
popis, štítky a version. Tady vytvoříte záznam pluginu nebo nahrajete novou verzi existujícího.
V přehledu to děláte v editoru na kartě Pluginy (Tab_plugins.vue), který otevřete z části
Pluginy v projektu.
Instalace
install_plugin vloží balíček pluginu do jednoho projektu: nainstaluje ho přes npm do
node_modules tohoto projektu a zapíše ho do mapy app_plugins_purchased v projektu. Plugin lze
do projektu nainstalovat, aniž by byl kdy veřejný. Tak vyvíjíte proti vlastnímu nahrání, dřív než
ho uvidí kdokoli jiný.
Publikování
publish_plugin je výslovný, samostatný přepínač, který už nahraný plugin zviditelní v katalogu
marketplace (visibility: 'public') nebo ho vrátí jen vlastníkovi (visibility: 'private').
V přehledu je to přepínač Marketplace Visibility u pluginu, který vlastníte. Nahrání ani
aktualizace kódu pluginu ho nikdy samo nepublikuje.
Schvalovací brána
Při přechodu na veřejný plugin projde publish_plugin kontrolou schválení
(marketplace_module.review_and_notify_external), pokud nahrávající účet není důvěryhodný
vydavatel (starší systémový účet Xuda nebo nakonfigurovaný supervizor platformy). Výsledek zapíše
dokument pluginu do jednoho ze tří stavů, který se zrcadlí do publish_stat i do staršího pole
stat: 3 schváleno a živé, 6 zamítnuto (s nastaveným publish_reason a odkazem pro odvolání
sestaveným z approval.appeal_token), nebo 1 stále v kontrole. Zamítnutý plugin nebo plugin
v kontrole se vrátí na visibility: 'private'.
publish_plugin odmítne zveřejnění (code: -403), pokud účet nemá aktivní účet prodejce Stripe
Connect. Stejná brána platí pro nabídky projektů na marketplace. Důvěryhodný vydavatel (vlastní
pluginy platformy) ji také přeskočí.
Souhlas na straně instalujícího
Než install_plugin cokoli zapíše, zavolá install_consent.build_plugin_consent() a vyžaduje
v požadavku odpovídající přijatý consent (s content_hash, který server znovu spočítá a
zkontroluje). Tato obrazovka se sestavuje přímo z manifestu pluginu, přesně co k ní každý přítomný
soubor přidává, najdete na stránce o manifestu. Dále obsahuje ID balíčku
npm a instalovanou verzi a informaci, zda plugin závisí na jiném pluginu.
Smlouva o nahrávání pluginů
dist/xuda_plugin_upload_user_agreement.html je trvalý právní dokument: nahráním pluginu
udělujete Xuda celosvětovou licenci bez licenčních poplatků k jeho používání, rozmnožování,
šíření a zobrazování. Nahrávající prohlašuje, že plugin je jeho vlastní dílo bez malwaru, a
zaručuje se, že Xuda v této věci odškodní. Leží vedle dvou souvisejících smluv ve stejné složce
dist/, smlouvy o nahrávání aplikací a sdílení příjmů a vzorové smlouvy o proprietární licenci.
Všechny se servírují jako statické soubory z cesty dist/ platformy, stejně jako
xuda-runtime-slim.js a další runtime soubory.
Rozhraní API
Z metod pro pluginy mají úroveň oprávnění public jen get_plugins a get_plugins_categories,
procházení katalogu nevyžaduje účet. upload_plugin, install_plugin, uninstall_plugin a
get_app_plugins mají úroveň admin a jsou omezeny na projekt. publish_plugin a
archive_plugin jsou akce jen pro přehled a nejsou součástí veřejného 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.