Publicarea în marketplace
Încarci un plugin, îl instalezi într-un proiect, apoi îl publici, trei pași separați, în spatele a trei metode diferite și al unei verificări de aprobare.
Punerea codului unui plugin pe disc, instalarea lui într-un proiect și afișarea lui în fața altor persoane sunt trei acțiuni separate, fiecare în spatele propriei metode. Niciuna nu se execută automat odată cu celelalte.
Upload
upload_plugin salvează documentul de catalog al pluginului: manifestul lui (calculat prin
scanarea pachetului, așa cum descrie pagina despre manifest), plugin_type,
eticheta, descrierea, etichetele și version. Aici creezi înregistrarea unui plugin sau încarci o
versiune nouă a unuia existent. Din tabloul de bord, acesta este editorul Sheet din fila Plugins
(Tab_plugins.vue), la care ajungi din secțiunea Pluginuri a unui proiect.
Install
install_plugin pune pachetul pluginului într-un singur proiect: îl instalează cu npm în propriul
node_modules al proiectului și îl înregistrează în harta app_plugins_purchased a proiectului. Un
plugin poate fi instalat într-un proiect fără să fie vreodată public, așa dezvolți pe baza propriei
încărcări înainte ca altcineva să o poată vedea.
Publish
publish_plugin este comutatorul explicit și separat care face un plugin deja încărcat vizibil în
catalogul marketplace (visibility: 'public') sau îl retrage la accesul doar pentru proprietar
(visibility: 'private'). În tabloul de bord, acesta este comutatorul Marketplace Visibility de
pe un plugin al tău. Încărcarea sau actualizarea codului unui plugin nu îl publică niciodată
de la sine.
Verificarea de aprobare
Trecerea la public rulează publish_plugin printr-o verificare de aprobare
(marketplace_module.review_and_notify_external), cu excepția cazului în care contul care încarcă
este un editor de încredere (contul de sistem Xuda vechi sau un supervizor de platformă configurat).
Rezultatul pune documentul pluginului într-una din trei stări, oglindite atât în publish_stat, cât
și în câmpul vechi stat: 3 aprobat și activ, 6 respins (cu publish_reason setat și un link de
contestație construit din approval.appeal_token) sau 1 încă în verificare. Un plugin respins sau
aflat în verificare este readus forțat la visibility: 'private'.
publish_plugin refuză trecerea la public (code: -403) dacă contul nu are un cont de vânzător
Stripe Connect activ, aceeași condiție ca la listările de proiecte din marketplace. Un editor de
încredere (pluginurile proprii ale platformei) trece și peste această condiție.
Consimțământul, de partea celui care instalează
Înainte să scrie ceva, install_plugin apelează install_consent.build_plugin_consent() și cere ca
în cerere să existe un consent acceptat, potrivit (cu un content_hash pe care serverul îl
recalculează și îl verifică). Ecranul este construit direct din manifestul pluginului, vezi
pagina despre manifest pentru ce adaugă exact fiecare fișier prezent, plus
id-ul pachetului npm și versiunea care se instalează și dacă pluginul depinde de altul.
Acordul de încărcare a pluginurilor
dist/xuda_plugin_upload_user_agreement.html este un document juridic permanent: încărcarea unui
plugin acordă Xuda o licență mondială, fără redevențe, de utilizare, reproducere, distribuire și
afișare, iar cel care încarcă declară că pluginul este creația lui, fără malware, și garantează că
va despăgubi Xuda în legătură cu el. Se află alături de alte două acorduri în același folder dist/,
un acord de încărcare a aplicațiilor și de împărțire a veniturilor și un exemplu de acord de licență
proprietară, toate servite ca fișiere statice de pe calea dist/ a platformei, la fel ca
xuda-runtime-slim.js și alte resurse de runtime.
Suprafața API
Dintre metodele pentru plugin, doar get_plugins și get_plugins_categories au clearance public,
răsfoirea catalogului nu cere un cont. upload_plugin, install_plugin, uninstall_plugin și
get_app_plugins au clearance admin, limitat la un proiect. publish_plugin și archive_plugin
sunt acțiuni doar din tabloul de bord și nu fac parte din API-ul public.
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.