NeboAI
NeboAI
Começar

Como distribuir um plugin

Publicar um plugin significa compilar um binário por plataforma, enviar cada um com o manifesto e as skills do plugin e submeter uma versão para revisão. O NeboAI assina os binários quando a versão é aprovada, e todo bot os verifica antes de executá-los.

Prepare os arquivos

notes-sync/
├── PLUGIN.md                 # marketplace listing
├── plugin.json               # runtime manifest
├── skills/
│   └── notes-sync/
│       └── SKILL.md
└── dist/
    ├── darwin-arm64/notes-sync
    ├── linux-amd64/notes-sync
    └── windows-amd64/notes-sync.exe
ArquivoFinalidade
PLUGIN.mdA página da loja que as pessoas leem antes de instalar. Enviada como manifestContent.
plugin.jsonO manifesto de execução. Enviado uma única vez com o primeiro binário. Veja a Referência do plugin.json.
skills/Skills que ensinam os funcionários a usar o plugin. Enviadas uma única vez como um .tar.gz cujas entradas começam com skills/.
BináriosUm executável por plataforma. Dê a cada um o nome definido em binaryName; adicione .exe no Windows.
---
name: Example Notes
description: Search, read and create notes in Example Notes.
version: 1.0.0
category: productivity
---

# Example Notes

Connect each employee to its own Example Notes account. Employees can search
notebooks, read notes and create new ones.

Plataformas

Envie um binário para cada plataforma que você suporta: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 ou windows-amd64. macos- é aceito como sinônimo de darwin-. Cada bot instala o binário da própria plataforma.

Enviar e submeter

Você trabalha pelo servidor MCP do NeboAI; Publicação explica a conexão e as contas de desenvolvedor. Selecione a sua conta de desenvolvedor, depois crie o plugin e peça um token de envio.

plugin(action: "create", name: "Example Notes", description: "Search, read and create notes in Example Notes.",
       category: "productivity", version: "1.0.0", manifestContent: "<PLUGIN.md>")

plugin(action: "binary-token", id: "<plugin id>")

O token dura cinco minutos e vale para quantos envios você quiser. Envie o binário de cada plataforma. Mande config (o plugin.json) e skills junto com um deles.

TOKEN=<token from binary-token>
ID=<plugin id>

tar czf skills.tar.gz -C notes-sync skills

curl -X POST "https://neboai.com/api/v1/developer/apps/$ID/binaries" \
  -H "Authorization: Bearer $TOKEN" \
  -F file=@notes-sync/dist/darwin-arm64/notes-sync \
  -F platform=darwin-arm64 \
  -F config=@notes-sync/plugin.json \
  -F skills=@skills.tar.gz

curl -X POST "https://neboai.com/api/v1/developer/apps/$ID/binaries" \
  -H "Authorization: Bearer $TOKEN" \
  -F file=@notes-sync/dist/linux-amd64/notes-sync \
  -F platform=linux-amd64

curl -X POST "https://neboai.com/api/v1/developer/apps/$ID/binaries" \
  -H "Authorization: Bearer $TOKEN" \
  -F file=@notes-sync/dist/windows-amd64/notes-sync.exe \
  -F platform=windows-amd64
Campo do formulárioObrigatórioSignificado
filesimO binário.
platformsimUma das seis chaves de plataforma.
confignãoO plugin.json, com no máximo 1 MB.
skillsnãoUm .tar.gz da pasta skills/. Entradas fora de skills/ são ignoradas.

Cada binário é armazenado na version atual do plugin, e enviar a mesma plataforma de novo o substitui. Para publicar uma nova versão, primeiro altere a versão com plugin(action: "update", id, version) e depois faça o envio. Cada requisição de envio tem limite de 100 MB.

Quando todas as plataformas estiverem enviadas, submeta essa versão.

Em um plugin que já está listado, só a nova versão aguarda revisão. A versão aprovada continua listada e instalável, e é para ela que os bots se atualizam. A aprovação troca a página da loja para a nova versão; se a nova versão for rejeitada, a aprovada continua no ar.

Uma versão só entra no ar completa: toda plataforma que o seu plugin.json lista em platforms precisa ter antes um binário aprovado. Até que o último seja aprovado, as pessoas continuam recebendo a versão anterior, e um plugin que nunca foi listado continua fora da lista. Os bots que instalaram o plugin são avisados da nova versão uma única vez, quando ela entra no ar.

plugin(action: "submit", id: "<plugin id>", version: "1.0.0")

Revisão e assinatura

Toda versão submetida é analisada; um envio sozinho nunca é revisado nem distribuído. Quando uma versão é aprovada, o NeboAI assina cada binário e o manifesto com Ed25519, grava o hash, o tamanho, a assinatura e a URL de download reais no plugin.json e monta um pacote assinado por plataforma.

Em um bot

  • O Nebo baixa o pacote da própria plataforma, verifica o hash SHA-256 e a assinatura e o instala em <data>/nebo/plugins/<slug>/<version>/.
  • O Nebo mantém uma versão de cada plugin. Instalar uma nova versão substitui a antiga.
  • A pasta de dados do plugin, <data>/appdata/plugins/<slug>/, é mantida em atualizações e desinstalações.
  • O Nebo procura atualizações um minuto depois de iniciar e, a partir daí, a cada seis horas. Uma atualização se instala sozinha quando o proprietário ativou as atualizações automáticas para aquele plugin; caso contrário, o proprietário é notificado.

Teste antes de publicar

Compile para a sua própria máquina e coloque o binário e o plugin.json em <data>/user/plugins/<slug>/. Um plugin ali substitui a versão da loja com o mesmo slug e pula as verificações de assinatura, para você iterar sem publicar. Veja Plugins.