Przejdź do treści
Zweryfikowano

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

Wymagane konto sprzedawcy

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.

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.

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.