Saltar para o conteúdo
Verificado

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 com getPackageManifest(plugin_name), por isso é o que npm version produziu na última vez que o autor executou npm publish. O package.json de todos os plugins próprios tem um script pub para 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, ou 0.1.0 se 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.

Uma atualização de código/npm nunca volta a entrar em revisão

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.