NeboAI
NeboAI
Começar

Distribuir um plugin

Lançar um plugin significa compilar um binário por plataforma, carregar 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 cada bot verifica-os antes de os executar.

Preparar os ficheiros

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
FicheiroFinalidade
PLUGIN.mdA página da loja que as pessoas leem antes de instalar. Enviada como manifestContent.
plugin.jsonO manifesto de execução. Carregado uma vez com o primeiro binário. Consulte a Referência do plugin.json.
skills/Skills que ensinam os funcionários a usar o plugin. Carregadas uma vez como um .tar.gz cujas entradas começam por skills/.
BináriosUm executável por plataforma. Dê a cada um o nome indicado em binaryName; acrescente .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

Carregue um binário para cada plataforma que suporta: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 ou windows-amd64. macos- é aceite como sinónimo de darwin-. Um bot instala o binário da sua própria plataforma.

Carregar e submeter

Trabalha através do servidor MCP do NeboAI; Publicação explica a ligação e as contas de programador. Selecione a sua conta de programador, crie o plugin e peça um token de carregamento.

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 cobre qualquer número de carregamentos. Carregue o binário de cada plataforma. Envie config (o plugin.json) e skills 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/. As entradas fora de skills/ são ignoradas.

Cada binário é guardado na version atual do plugin, e carregar de novo a mesma plataforma substitui-o. Para lançar uma nova versão, altere primeiro a versão com plugin(action: "update", id, version) e depois carregue. Cada pedido de carregamento está limitado a 100 MB.

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

Num plugin que já está publicado, só a nova versão aguarda revisão. A versão aprovada continua publicada e instalável, e é para ela que os bots atualizam. A aprovação muda a página para a nova versão; se a nova versão for rejeitada, a aprovada continua ativa.

Uma versão só fica disponível completa: todas as plataformas que o seu plugin.json indica em platforms têm de ter primeiro um binário aprovado. Até o último ser aprovado, as pessoas continuam a receber a versão anterior, e um plugin que nunca foi publicado continua por publicar. Os bots que instalaram o plugin são avisados da nova versão uma vez, quando fica disponível.

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

Revisão e assinatura

Cada versão submetida é analisada; um carregamento por si só nunca é revisto nem disponibilizado. Quando uma versão é aprovada, o NeboAI assina cada binário e o manifesto com Ed25519, escreve o hash, o tamanho, a assinatura e o URL de transferência reais no plugin.json e cria um pacote assinado por plataforma.

Num bot

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

Teste antes de lançar

Compile para o seu próprio computador e coloque o binário e o plugin.json em <data>/user/plugins/<slug>/. Um plugin aí substitui a versão da loja com o mesmo slug e salta as verificações de assinatura, por isso pode iterar sem publicar. Consulte Plugins.