Tutoriais · Plugins
Registrar no Marketplace
Crie seu handle de publisher, envie o plugin, entenda as checagens automáticas, a aprovação, as revisões e as avaliações.
Nesta página
O caminho até a publicação
O Marketplace do Jarvis lista plugins de qualquer pessoa, depois que um admin os aprova. O caminho:
Crie o seu handle de publicador
Uma vez, no painel.
Envie o plugin
Em
/painel/plugins/novo: dados, links, descrição em Markdown; depois a capa e as capturas de tela.As checagens automáticas rodam
Repositório, manifesto, pacote npm.
Um admin aprova ou rejeita
O plugin nasce como Pendente e só aparece na busca pública depois de Aprovado.
Pessoas instalam e avaliam
Com o comando
npx -y jarvis-ade plugins add <handle>/<slug>, pela CLI.
1. Crie o handle de publicador
No painel, o cartão Meus plugins abre a área do criador. No primeiro acesso, o Jarvis pede o seu perfil de publicador:
| Campo | Regra |
|---|---|
| Identificador público (handle) | De 3 a 39 letras minúsculas, números ou hífen, sem começar nem terminar com hífen. Aparece na URL e no comando de instalação (handle/nome-do-plugin) e não pode ser alterado depois. |
| Nome de exibição | De 2 a 60 caracteres. |
2. Envie o plugin
Em /painel/plugins/novo (ou Novo plugin na área do criador), preencha o formulário. Antes de começar, tenha o repositório público e, se for o caso, o pacote npm prontos — publicar no GitHub e no npm.
| Campo | Regra |
|---|---|
| Nome do plugin | De 2 a 60 caracteres. |
| Identificador (slug) | De 3 a 39 letras minúsculas, números ou hífen. É sugerido a partir do nome. Junto do handle, forma o endereço: handle/slug. |
| Resumo (uma linha) | Até 120 caracteres; aparece nos cards e na busca. |
| Categoria | Uma da lista: Integrações, Produtividade, Agentes, Ferramentas de dev, Dados, Temas, Outros. |
| Tags | Até 8, separadas por vírgula (até 24 caracteres cada: palavras em letras minúsculas e números, unidas por hífen). |
| URL do repositório | Só repositórios do GitHub, no formato exato https://github.com/<dono>/<repo> — sem barra no final e sem .git. O repositório precisa ser público. |
| Pacote npm (opcional) | Ex.: @voce/meu-plugin. Se informado, é conferido contra o repositório. |
| Site (opcional) | URL https. |
| Descrição em Markdown | Até 20.000 caracteres, com editor e pré-visualização. Vira a página pública do plugin. |
Clique em Enviar para aprovação. O plugin é criado como Pendente e você cai na tela de edição, onde ainda pode (e deve) adicionar:
- Capa — tamanho recomendado 1200×630.
- Capturas de tela — até 8, com legenda opcional e ordem ajustável.
- Formatos PNG, JPEG, WebP, até 5 MiB por imagem.
Capa e capturas fazem parte da revisão do admin: um plugin com boas imagens é aprovado mais fácil.
Dicas para a descrição
- O que o plugin faz, em uma frase, no começo.
- Configurações que o usuário precisa preencher (chaves, IDs) e onde obtê-las — sem colar segredos de verdade.
- Limitações conhecidas e o Node mínimo.
3. Checagens automáticas
Ao enviar (e a cada revisão), o Marketplace roda checagens e mostra cada uma no seu painel como OK, Atenção ou Falhou:
| Checagem | Passa (OK) quando | Se não passar |
|---|---|---|
repo-reachable | O repositório é público (o Marketplace guarda a branch padrão e o commit). | Atenção: O GitHub não respondeu, deu erro 5xx ou limitou as requisições: reexecute depois.Falhou: Repositório inexistente (404), privado, ou URL fora do formato https://github.com/<dono>/<repo>. |
manifest-valid | O ade.plugin.json na raiz do repositório existe e passa no schema do app. | Atenção: Não foi possível baixar o arquivo.Falhou: Arquivo ausente, JSON inválido ou violação do schema (a mensagem mostra o caminho do campo). |
npm-package | O pacote npm informado existe e tem uma versão “latest”. | Atenção: O registro do npm não respondeu.Falhou: Pacote inexistente (404) ou sem versão “latest”. |
npm-manifest | O tarball publicado no npm traz um ade.plugin.json válido. | Atenção: O tarball não pôde ser lido (ou fica fora do registro do npm).Falhou: O ade.plugin.json está ausente ou inválido dentro do pacote. |
npm-repository | O campo repository do package.json publicado aponta para o mesmo repositório GitHub. | Atenção: Os metadados do pacote não estavam disponíveis.Falhou: Campo repository ausente, fora do GitHub ou apontando para outro repositório. |
plugin-id-match | O id do manifesto é o mesmo no GitHub e no npm. | Atenção: Um dos lados não estava disponível para comparar.Falhou: Os ids são diferentes: um no GitHub, outro no npm. |
version-consistency | As versões batem. | Atenção: Divergência: pacote npm × manifesto dentro dele, ou manifesto do GitHub × última versão no npm. |
runtime-dependencies | O package.json não declara dependencies (ou não existe). | Atenção: Há dependencies em runtime: o instalador só copia arquivos e nunca roda npm install. |
install-scripts | Sem scripts de instalação. | Atenção: Há preinstall, install ou postinstall. |
npm-keyword | O pacote npm tem a keyword jarvis-ade-plugin. | Atenção: Falta a keyword jarvis-ade-plugin (o plugin fica menos descobrível no npm). |
plugin-id-unique | Nenhum outro anúncio ativo usa o mesmo id de manifesto. | Falhou: Outro anúncio (não rejeitado) já usa esse id — o app instala plugins por id, então dois anúncios não podem dividi-lo. |
As checagens do npm (npm-package, npm-manifest, npm-repository, plugin-id-match e npm-keyword) só valem quando você informa um pacote npm; se o pacote não puder ser lido, as dependentes dele são puladas e npm-package explica o motivo. Sem npm, as checagens de dependências e scripts leem o package.json do repositório.
As checagens só ajudam o admin: quem decide é uma pessoa. Uma exceção prática: sem um manifesto validado (manifest-valid passando) o admin nem consegue aprovar — o Marketplace precisa do id do plugin.
4. Aprovação, rejeição e status
| Status | Significado |
|---|---|
| Pendente | Enviado; aguardando um admin. Não aparece na busca pública. |
| Aprovado | Publicado: aparece na busca, na listagem e no comando de instalação. |
| Rejeitado | Com o motivo, visível no seu painel. Corrija e salve: o plugin é reenviado para aprovação. |
| Suspenso | Retirado do ar por um admin. |
Depois de Aprovado, o plugin ganha uma página pública em /plugins/<handle>/<slug> com a capa, a galeria, a descrição, o comando de instalação e as avaliações.
5. Editando um plugin aprovado
Editar um plugin Aprovado não tira a página do ar: as alterações viram uma revisão que é revisada de novo por um admin. Enquanto isso, a versão atual continua publicada; ao aprovar a revisão, ela substitui a anterior.
O formulário avisa: “Alterações enviadas para aprovação. A página atual continua no ar até um admin aprovar a revisão.”
6. Avaliações
Clientes do Jarvis avaliam os plugins com uma nota de 1 a 5 e um comentário, na página do plugin. A nota média, o histograma e as avaliações ficam visíveis a todos, e a busca pública pode ordenar por Populares, Mais bem avaliados, Recentes e Em alta. Cada cliente tem uma avaliação por plugin e pode editá-la depois. O autor não pode avaliar o próprio plugin; ele pode, sim, responder às avaliações. Só plugins Aprovados recebem avaliações.
npx -y jarvis-ade plugins add meu-estudio/meu-pluginFalta ver como o usuário roda esse comando: veja instalar via CLI.