Preskočiť na obsah
Overené

Zverejnenie v marketplace

Nahrajte plugin, nainštalujte ho do projektu a potom ho zverejnite: tri samostatné kroky za tromi rôznymi metódami a jednou kontrolnou bránou.

Dostať kód pluginu na disk, nainštalovať ho do projektu a ukázať ho iným ľuďom sú tri samostatné akcie, každá za vlastnou metódou. Žiadna z nich sa nespúšťa automaticky pre ostatné.

Upload

upload_plugin uloží katalógový dokument pluginu: jeho manifest (vypočítaný prehľadaním balíka spôsobom, ktorý opisuje stránka manifestu), jeho plugin_type, označenie, popis, štítky a version. Tu vytvoríte záznam pluginu alebo nahráte novú verziu existujúceho. V dashboarde je to editorový Sheet karty Pluginy (Tab_plugins.vue), dostupný zo sekcie Pluginy projektu.

Install

install_plugin vloží balík pluginu do jedného projektu: nainštaluje ho cez npm do vlastného node_modules projektu a zapíše ho do mapy app_plugins_purchased projektu. Plugin sa dá nainštalovať do projektu bez toho, aby bol kedy verejný, takto vyvíjate proti vlastnému nahratiu, skôr než ho uvidí ktokoľvek iný.

Publish

publish_plugin je výslovný, samostatný prepínač, ktorý urobí už nahraný plugin viditeľným v katalógu marketplace (visibility: 'public') alebo ho vráti len vlastníkovi (visibility: 'private'). V dashboarde je to prepínač Viditeľnosť v marketplace pri plugine, ktorý vlastníte. Nahranie alebo aktualizácia kódu pluginu ho sama o sebe nikdy nezverejní.

The review gate

Zverejnenie vedie publish_plugin cez kontrolu schválenia (marketplace_module.review_and_notify_external), pokiaľ nahrávajúci účet nie je dôveryhodný vydavateľ (starý systémový účet Xuda alebo nakonfigurovaný supervízor platformy). Výsledok zaradí dokument pluginu do jedného z troch stavov, zrkadlených do publish_stat aj do starého poľa stat: 3 schválené a živé, 6 zamietnuté (s nastaveným publish_reason a odkazom na odvolanie zostaveným z approval.appeal_token), alebo 1 stále v posudzovaní. Zamietnutý alebo posudzovaný plugin sa násilne vráti na visibility: 'private'.

Vyžaduje sa účet predajcu

publish_plugin odmietne zverejnenie (code: -403), pokiaľ účet nemá aktívny účet predajcu Stripe Connect, tú istú bránu, aké používajú záznamy projektov v marketplace. Dôveryhodný vydavateľ (vlastné pluginy platformy od prvej strany) ju tiež preskočí.

Skôr než install_plugin čokoľvek zapíše, zavolá install_consent.build_plugin_consent() a v požiadavke vyžaduje zodpovedajúci prijatý consent (s content_hash, ktorý server prepočíta a skontroluje). Táto obrazovka sa zostavuje priamo z manifestu pluginu, presne čo každý prítomný súbor pridáva, nájdete na stránke manifestu, plus ID balíka npm a verzia, ktorá sa inštaluje, a či plugin závisí od iného.

The plugin upload agreement

dist/xuda_plugin_upload_user_agreement.html je trvalý právny dokument: nahratím pluginu udeľujete Xude celosvetovú licenciu bez licenčných poplatkov na jeho použitie, reprodukciu, distribúciu a zobrazenie a nahrávajúci vyhlasuje, že plugin je jeho vlastné dielo, bez malvéru, a zaručuje sa, že Xudu v súvislosti s ním odškodní. Leží vedľa dvoch súvisiacich zmlúv v tom istom priečinku dist/, zmluvy o nahrávaní aplikácie a zdieľaní tržieb a vzorovej zmluvy o proprietárnej licencii, všetky sa poskytujú ako statické súbory z cesty dist/ platformy tak, ako xuda-runtime-slim.js a ďalšie prostriedky runtime.

The API surface

Z metód pluginov majú clearance public iba get_plugins a get_plugins_categories, prezeranie katalógu nepotrebuje účet. upload_plugin, install_plugin, uninstall_plugin a get_app_plugins majú clearance admin, viazané na projekt. publish_plugin a archive_plugin sú akcie len pre dashboard a nie sú súčasťou verejné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.