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 | Ficheiro | 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. 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ários | Um 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á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/. 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.