Wersjonowanie
Wersja wtyczki to zwykłe porównanie ciągów znaków między dokumentem katalogowym a tym, co ma zainstalowane projekt. Zakresy semver nie są dopasowywane.
Wersja wtyczki istnieje w dwóch miejscach: jako doc.version w dokumencie katalogowym (najnowsza
przesłana wersja) i jako app_plugins_purchased[plugin_name].version w każdym projekcie, który ją
zainstalował (wersja, którą projekt faktycznie ma). Nic nie synchronizuje ich automatycznie.
Skąd bierze się wersja
upload_plugin ustawia doc.version inaczej, zależnie od tego, gdzie leży pakiet:
- Źródło pakietu
npm: wersja jest odczytywana prosto z rejestru przezgetPackageManifest(plugin_name), więc jest taka, jaką dałnpm version, gdy autor ostatnio uruchomiłnpm publish. Każda własna wtyczka ma wpackage.jsonskryptpubdo tego:npm version patch --force && npm publish --access public. - Źródło pakietu
xuda_hosted(bez publikacji w npm, robocza kopia jest pakowana i hostowana przez samą platformę):doc.versionto wartość przesłana w żądaniu albo0.1.0, jeśli nic nie przesłano.
install_plugin kopiuje doc.version do wpisu app_plugins_purchased projektu w chwili instalacji.
Późniejszy upload_plugin, który podbija wersję dokumentu katalogowego, nie zmienia projektów,
które zainstalowały wcześniejszą wersję. Zachowują one zainstalowaną wersję, dopóki coś nie zainstaluje
nowej na wierzchu.
Jak pokazywana jest nieaktualna instalacja
Nie ma automatycznej aktualizacji. Jest tylko porównanie wizualne: plakietka wersji na karcie wtyczki
porównuje app_plugins_purchased[plugin_name].version (to, co jest zainstalowane) z version dokumentu
katalogowego (najnowszą) i pokazuje zainstalowany numer na zielono, gdy się zgadzają, a na bursztynowo,
gdy nie. Nic nie wymusza ponownej instalacji. Nowszą wersję wciąga właściciel (lub instalujący),
uruchamiając ponownie install_plugin w tym samym projekcie, tym samym wywołaniem co przy pierwszej
instalacji.
Aktualizowanie własnej wtyczki
Przycisk Zaktualizuj za pomocą AI w panelu, widoczny właścicielowi na karcie wtyczki, sam nie podbija
wersji. Otwiera asystenta Zapytaj AI wypełnionego z góry wartością metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } i promptem z nazwą wtyczki (updateWithAi() w
Tab_plugins.vue). To uruchamia kreatora wtyczek AI (ai_module.create_plugin_via_ai, ten sam
generator, który wywołuje bezpośrednio utils/create_plugin_via_ai.mjs), aby edytował kod wtyczki i
przesłał ją ponownie. To właśnie to przesłanie podnosi doc.version.
upload_plugin traktuje każdą aktualizację, w której visibility jest już 'private' albo ustawiono
skip_publish_review, jako prywatną zmianę kodu: przenosi dalej istniejące visibility i publish_stat
wtyczki bez zmian, zamiast ponownie zgłaszać ją do przeglądu marketplace. Przejście z prywatnej na
publiczną to zawsze publish_plugin, osobna, jawna akcja. Zobacz publikowanie.