Přeskočit na obsah
Ověřeno

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

Je potřeba účet prodejce

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čí.

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.

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.