Publikowanie w marketplace
Prześlij wtyczkę, zainstaluj ją w projekcie, a potem opublikuj. To trzy osobne kroki, trzy różne metody i jedna bramka przeglądu.
Zapisanie kodu wtyczki na dysku, zainstalowanie jej w projekcie i pokazanie jej innym to trzy osobne działania, każde za własną metodą. Żadne z nich nie uruchamia się automatycznie przez pozostałe.
Przesłanie
upload_plugin zapisuje dokument katalogowy wtyczki: jej manifest (wyliczany przez przeskanowanie
pakietu tak, jak opisuje strona o manifeście), jej plugin_type, etykietę,
opis, tagi i version. Tutaj tworzysz rekord wtyczki albo wysyłasz nową wersję istniejącej. W panelu
robisz to w edytorze (Sheet) na karcie Wtyczki (Tab_plugins.vue), do którego wchodzisz z sekcji
Wtyczki projektu.
Instalacja
install_plugin wstawia pakiet wtyczki do jednego projektu: instaluje go przez npm we własnym
node_modules projektu i zapisuje w mapie app_plugins_purchased projektu. Wtyczkę można zainstalować
w projekcie, nawet jeśli nigdy nie była publiczna. Tak rozwijasz wtyczkę na własnym przesłanym kodzie,
zanim zobaczy ją ktokolwiek inny.
Publikacja
publish_plugin to osobny, jawny przełącznik, który sprawia, że już przesłana wtyczka staje się
widoczna w katalogu marketplace (visibility: 'public') albo wraca do widoczności tylko dla właściciela
(visibility: 'private'). W panelu to przełącznik Marketplace Visibility przy wtyczce, którą
posiadasz. Przesłanie lub aktualizacja kodu wtyczki nigdy nie publikuje jej samo z siebie.
Bramka przeglądu
Przejście na publiczną widoczność przepuszcza publish_plugin przez kontrolę zatwierdzenia
(marketplace_module.review_and_notify_external), chyba że przesyłające konto jest zaufanym wydawcą
(dawne systemowe konto Xuda albo skonfigurowany administrator platformy). Wynik ustawia dokument
wtyczki w jednym z trzech stanów, odzwierciedlonych w publish_stat i w starszym polu stat: 3
zatwierdzona i dostępna, 6 odrzucona (z ustawionym publish_reason i linkiem odwoławczym zbudowanym
z approval.appeal_token) albo 1 nadal w przeglądzie. Wtyczka odrzucona lub będąca w przeglądzie jest
z powrotem wymuszana na visibility: 'private'.
publish_plugin odmawia upublicznienia (code: -403), jeśli konto nie ma aktywnego konta sprzedawcy
Stripe Connect. To ta sama bramka, której używają oferty w marketplace projektów. Zaufany wydawca
(własne wtyczki platformy) też to pomija.
Zgoda po stronie instalującego
Zanim install_plugin cokolwiek zapisze, wywołuje install_consent.build_plugin_consent() i wymaga w
żądaniu pasującej zaakceptowanej zgody (consent) z content_hash, który serwer liczy ponownie i
sprawdza. Ten ekran powstaje bezpośrednio z manifestu wtyczki (na stronie o manifeście
znajdziesz, co dokładnie dodaje do niego każdy obecny plik), a także z identyfikatora pakietu npm i
instalowanej wersji oraz z informacji, czy wtyczka zależy od innej.
Umowa przesyłania wtyczek
dist/xuda_plugin_upload_user_agreement.html to stały dokument prawny: przesłanie wtyczki daje Xuda
ogólnoświatową, bezpłatną licencję na jej używanie, powielanie, dystrybucję i wyświetlanie, a przesyłający
oświadcza, że wtyczka jest jego własnym dziełem, wolnym od złośliwego oprogramowania, i zobowiązuje się
zwolnić Xuda z odpowiedzialności z tego tytułu. Leży obok dwóch powiązanych umów w tym samym folderze
dist/: umowy o przesyłaniu aplikacji i podziale przychodów oraz przykładowej umowy licencji
własnościowej. Wszystkie są serwowane jako pliki statyczne ze ścieżki dist/ platformy, tak jak
xuda-runtime-slim.js i inne zasoby środowiska uruchomieniowego.
Powierzchnia API
Spośród metod wtyczek tylko get_plugins i get_plugins_categories mają uprawnienie public, więc
przeglądanie katalogu nie wymaga konta. upload_plugin, install_plugin, uninstall_plugin i
get_app_plugins mają uprawnienie admin i są ograniczone do projektu. publish_plugin i
archive_plugin to akcje dostępne tylko w panelu i nie należą do publicznego 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.