Versões
A versão de um plugin é uma simples comparação de cadeias entre o documento de catálogo e o que um projeto tem instalado, não há correspondência de intervalos semver.
A versão de um plugin vive em dois sítios: doc.version no documento de catálogo (a última versão
carregada) e app_plugins_purchased[plugin_name].version em cada projeto que o instalou (a versão que
esse projeto realmente tem). Nada as mantém sincronizadas automaticamente.
De onde vem a versão
upload_plugin define doc.version de forma diferente consoante o local do pacote:
- Origem de pacote
npm: lida diretamente do registo comgetPackageManifest(plugin_name), por isso é o quenpm versionproduziu na última vez que o autor executounpm publish. Opackage.jsonde todos os plugins próprios tem um scriptpubpara isto:npm version patch --force && npm publish --access public. - Origem de pacote
xuda_hosted(sem publicação npm, a cópia de trabalho é empacotada e alojada pela própria plataforma):doc.versioné o que foi enviado no pedido, ou0.1.0se nada foi enviado.
install_plugin copia doc.version para a entrada app_plugins_purchased do projeto no momento da
instalação. Um upload_plugin posterior que aumente a versão do documento de catálogo não toca nos
projetos que já instalaram uma versão anterior, que mantêm a versão que instalaram até que algo
instale a nova por cima.
Como uma instalação desatualizada é assinalada
Não há atualização automática. O que existe é uma comparação visual: o selo de versão do cartão do
plugin compara app_plugins_purchased[plugin_name].version (o que está instalado) com a version do
documento de catálogo (a mais recente), mostrando o número instalado a verde quando coincidem e a âmbar
quando não. Nada força a reinstalação, é um proprietário (ou um instalador) a voltar a executar
install_plugin no mesmo projeto que traz a versão mais recente, a mesma chamada usada numa primeira
instalação.
Atualizar um plugin que possui
O botão Atualizar com IA do painel, mostrado no cartão de um plugin ao seu proprietário, não aumenta
a versão por si. Abre o assistente Perguntar à IA pré-preenchido com
metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } e um pedido que
indica o plugin (updateWithAi() em Tab_plugins.vue), que aciona o construtor de plugins de IA
(ai_module.create_plugin_via_ai, o mesmo gerador que utils/create_plugin_via_ai.mjs chama
diretamente) para editar o código do plugin e voltar a carregá-lo, e é esse carregamento que faz
avançar doc.version.
upload_plugin trata qualquer atualização em que visibility já seja 'private', ou
skip_publish_review esteja definido, como uma alteração de código privada: mantém a visibility e
o publish_stat existentes do plugin sem os tocar, em vez de o voltar a submeter à revisão do
marketplace. Passar de privado a público é sempre apenas publish_plugin, uma ação separada e
explícita; veja publicar.