Przejdź do treści
Zweryfikowano

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 przez getPackageManifest(plugin_name), więc jest taka, jaką dał npm version, gdy autor ostatnio uruchomił npm publish. Każda własna wtyczka ma w package.json skrypt pub do 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.version to wartość przesłana w żądaniu albo 0.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.

Aktualizacja kodu lub npm nigdy nie wraca do przeglądu

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.