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'.
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čí.
Consent, on the installing side
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.
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.