NeboAI
NeboAI
Kom igång

Leverera ett plugin

Att leverera ett plugin innebär att bygga en binärfil per plattform, ladda upp var och en med pluginets manifest och färdigheter, och skicka in en version för granskning. NeboAI signerar binärfilerna när versionen godkänns, och varje bot verifierar dem innan den kör dem.

Förbered filerna

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
FilSyfte
PLUGIN.mdMarknadsplatsens sida som folk läser innan de installerar. Skickas som manifestContent.
plugin.jsonKörtidsmanifestet. Laddas upp en gång med den första binärfilen. Se plugin.json-referensen.
skills/Färdigheter som lär medarbetare att använda pluginet. Laddas upp en gång som en .tar.gz vars poster börjar med skills/.
BinärfilerEn körbar fil per plattform. Namnge var och en efter binaryName; lägg till .exe på 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.

Plattformar

Ladda upp en binärfil för varje plattform du stöder: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 eller windows-amd64. macos- godtas som synonym för darwin-. En bot installerar binärfilen för sin egen plattform.

Ladda upp och skicka in

Du arbetar via NeboAI MCP-servern; Publicering beskriver anslutning och utvecklarkonton. Välj ditt utvecklarkonto, skapa sedan pluginet och be om en uppladdningstoken.

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>")

Token gäller i fem minuter och räcker till hur många uppladdningar som helst. Ladda upp varje plattforms binärfil. Skicka config (plugin.json) och skills med en av dem.

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
FormulärfältObligatorisktBetydelse
filejaBinärfilen.
platformjaEn av de sex plattformsnycklarna.
confignejplugin.json, högst 1 MB.
skillsnejEn .tar.gz av mappen skills/. Poster utanför skills/ ignoreras.

Varje binärfil lagras mot pluginets aktuella version, och om du laddar upp samma plattform igen ersätts den. För att leverera en ny version ändrar du först versionen med plugin(action: "update", id, version) och laddar sedan upp. Varje uppladdningsförfrågan är begränsad till 100 MB.

När alla plattformar är uppladdade skickar du in den versionen.

För ett plugin som redan är listat är det bara den nya versionen som väntar på granskning. Den godkända versionen förblir listad och installerbar, och det är den som botar uppdaterar till. Ett godkännande byter listningen till den nya versionen; om den nya versionen avvisas förblir den godkända live.

En version går bara live när den är komplett: varje plattform som din plugin.json listar under platforms måste först ha en godkänd binärfil. Tills den sista är godkänd får folk fortsatt den tidigare versionen, och ett plugin som aldrig har listats förblir olistat. Botar som har installerat pluginet får veta om den nya versionen en gång, när den går live.

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

Granskning och signering

Varje inskickad version skannas; en uppladdning i sig granskas eller levereras aldrig. När en version godkänns signerar NeboAI varje binärfil och manifestet med Ed25519, skriver in den riktiga hashen, storleken, signaturen och nedladdningsadressen i plugin.json, och bygger ett signerat paket per plattform.

På en bot

  • Nebo laddar ner paketet för sin plattform, kontrollerar SHA-256-hashen och signaturen, och installerar det i <data>/nebo/plugins/<slug>/<version>/.
  • Nebo behåller en version av varje plugin. Att installera en ny version ersätter den gamla.
  • Pluginets datamapp, <data>/appdata/plugins/<slug>/, finns kvar efter uppdateringar och avinstallationer.
  • Nebo söker efter uppdateringar en minut efter start och sedan var sjätte timme. En uppdatering installeras av sig själv när ägaren har slagit på automatiska uppdateringar för det pluginet; annars meddelas ägaren.

Testa innan du levererar

Bygg för din egen dator och lägg binärfilen och plugin.json i <data>/user/plugins/<slug>/. Ett plugin där åsidosätter marknadsplatsversionen med samma slug och hoppar över signaturkontroller, så du kan iterera utan att publicera. Se Plugins.