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 | Arquivo | Finalidade |
|---|---|
PLUGIN.md | A página da loja que as pessoas leem antes de instalar. Enviada como manifestContent. |
plugin.json | O 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ários | Um 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ário | Obrigatório | Significado |
|---|---|---|
file | sim | O binário. |
platform | sim | Uma das seis chaves de plataforma. |
config | não | O plugin.json, com no máximo 1 MB. |
skills | não | Um .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.