Saltar para o conteúdo
Verificado

Publicar no marketplace

Carregar um plugin, instalá-lo num projeto e depois publicá-lo, três passos separados por trás de três métodos diferentes e uma barreira de revisão.

Pôr o código de um plugin em disco, instalá-lo num projeto e apresentá-lo a outras pessoas são três ações separadas, cada uma por trás do seu próprio método. Nenhuma delas é executada automaticamente pelas outras.

Carregar

upload_plugin guarda o documento de catálogo do plugin: o seu manifesto (calculado ao analisar o pacote como descreve a página do manifesto), o seu plugin_type, etiqueta, descrição, tags e version. É aqui que cria o registo de um plugin ou envia uma nova versão de um existente. No painel, é a Sheet do editor do separador Plugins (Tab_plugins.vue), acessível a partir da secção Plugins de um projeto.

Instalar

install_plugin coloca o pacote do plugin num projeto: instala-o por npm no próprio node_modules desse projeto e regista-o no mapa app_plugins_purchased do projeto. Um plugin pode ser instalado num projeto sem nunca ser público, é assim que desenvolve com o seu próprio carregamento antes de mais alguém o poder ver.

Publicar

publish_plugin é o interruptor explícito e separado que torna um plugin já carregado visível no catálogo do marketplace (visibility: 'public') ou o devolve apenas ao proprietário (visibility: 'private'). No painel, é o interruptor Visibilidade no marketplace num plugin que possui. Carregar ou atualizar o código de um plugin nunca o publica por si só.

A barreira de revisão

Tornar público faz passar publish_plugin por uma verificação de aprovação (marketplace_module.review_and_notify_external), a menos que a conta que carrega seja um publicador de confiança (a conta de sistema Xuda legada, ou um supervisor de plataforma configurado). O resultado coloca o documento do plugin num de três estados, refletidos tanto em publish_stat como no campo stat legado: 3 aprovado e ativo, 6 rejeitado (com publish_reason definido e uma ligação de recurso construída a partir de approval.appeal_token), ou 1 ainda em revisão. Um plugin rejeitado ou em revisão é forçado a voltar a visibility: 'private'.

É necessária uma conta de vendedor

publish_plugin recusa-se a tornar público (code: -403) a menos que a conta tenha uma conta de vendedor Stripe Connect ativa, a mesma barreira que as listagens de projetos do marketplace usam. Um publicador de confiança (os próprios plugins da plataforma) também a dispensa.

Antes de install_plugin escrever o que quer que seja, chama install_consent.build_plugin_consent() e exige no pedido um consent aceite correspondente (com um content_hash que o servidor volta a calcular e verifica). Esse ecrã é construído diretamente a partir do manifesto do plugin, veja a página do manifesto para saber exatamente o que cada ficheiro presente lhe acrescenta, além do id do pacote npm e da versão a instalar, e se o plugin depende de outro.

O acordo de carregamento de plugins

dist/xuda_plugin_upload_user_agreement.html é um documento jurídico permanente: carregar um plugin concede à Xuda uma licença mundial e isenta de royalties para o usar, reproduzir, distribuir e apresentar, e quem o carrega declara que o plugin é obra sua, livre de malware, e garante que indemnizará a Xuda a esse respeito. Está ao lado de dois acordos relacionados na mesma pasta dist/, um acordo de carregamento de aplicações e partilha de receitas e um modelo de acordo de licença proprietária, todos servidos como ficheiros estáticos a partir do caminho dist/ da plataforma, tal como xuda-runtime-slim.js e outros recursos de runtime.

A superfície da API

Dos métodos de plugins, apenas get_plugins e get_plugins_categories têm clearance public, navegar no catálogo não precisa de conta. upload_plugin, install_plugin, uninstall_plugin e get_app_plugins têm clearance admin, com âmbito de projeto. publish_plugin e archive_plugin são ações exclusivas do painel e não fazem parte da API pública.

POST/cpi/get_install_consent
user

Get Install Consent

Returns the install consent screen for one marketplace AI agent or plugin: what it does, who wrote it, the liability text, and the content hash the install has to echo back.