Verzování
Verze pluginu se porovnává jako prostý řetězec mezi katalogovým dokumentem a tím, co má projekt nainstalováno. Neexistuje žádné porovnávání rozsahů semver.
Verze pluginu žije na dvou místech: v doc.version na katalogovém dokumentu (poslední nahraná
verze) a v app_plugins_purchased[plugin_name].version v každém projektu, který ho nainstaloval
(verze, kterou projekt skutečně má). Nic je automaticky nesynchronizuje.
Odkud verze pochází
upload_plugin nastavuje doc.version různě podle toho, kde balíček leží:
- Zdroj balíčku
npm: čte se přímo z registru pomocígetPackageManifest(plugin_name), takže je to to, co vytvořilnpm version, když autor naposledy spustilnpm publish. Každý vlastní plugin má vpackage.jsonskriptpub:npm version patch --force && npm publish --access public. - Zdroj balíčku
xuda_hosted(bez publikování do npm, pracovní kopii zabalí a hostuje sama platforma):doc.versionje to, co přišlo v požadavku, nebo0.1.0, pokud nepřišlo nic.
install_plugin zkopíruje doc.version do záznamu app_plugins_purchased projektu v okamžiku
instalace. Pozdější upload_plugin, který zvýší verzi katalogového dokumentu, se nedotkne
projektů, které už nainstalovaly starší verzi. Ty si ponechají nainstalovanou verzi, dokud ji
něco nepřepíše novou instalací.
Jak se zobrazí zastaralá instalace
Žádná automatická aktualizace neexistuje. Existuje vizuální porovnání: štítek verze na kartě
pluginu porovná app_plugins_purchased[plugin_name].version (co je nainstalováno) s version
katalogového dokumentu (nejnovější) a nainstalované číslo zobrazí zeleně, když se shodují, a
jantarově, když ne. Nic přeinstalování nevynutí. Novější verzi stáhne až to, že vlastník (nebo
instalující) znovu spustí install_plugin ve stejném projektu, tedy stejné volání jako při první
instalaci.
Aktualizace pluginu, který vlastníte
Tlačítko Aktualizovat pomocí AI v přehledu, které se na kartě pluginu zobrazuje jeho
vlastníkovi, samo verzi nezvyšuje. Otevře asistenta Zeptat se AI přednastaveného s
metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } a výzvou jmenující plugin
(updateWithAi() v Tab_plugins.vue). Ta řídí AI tvůrce pluginů
(ai_module.create_plugin_via_ai, stejný generátor, který volá přímo
utils/create_plugin_via_ai.mjs), aby upravil kód pluginu a znovu ho nahrál. Právě toto nahrání
posune doc.version.
upload_plugin bere každou aktualizaci, kde je visibility už 'private' nebo je nastaveno
skip_publish_review, jako soukromou změnu kódu: stávající visibility a publish_stat pluginu
přenese beze změny a znovu ho neodešle ke kontrole marketplace. Přechod ze soukromého na veřejný
je vždy jen publish_plugin, samostatná, výslovná akce. Viz publikování.