NeboAI
NeboAI
Kom i gang

Lansere et tillegg

Å levere et tillegg betyr å bygge én binærfil per plattform, laste opp hver av dem sammen med tilleggets manifest og ferdigheter, og sende inn en versjon til gjennomgang. NeboAI signerer binærfilene når versjonen er godkjent, og hver bot verifiserer dem før den kjører dem.

Klargjør filene

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
FilFormål
PLUGIN.mdOppføringen på markedsplassen som folk leser før de installerer. Sendes som manifestContent.
plugin.jsonKjøretidsmanifestet. Lastes opp én gang sammen med den første binærfilen. Se plugin.json-referansen.
skills/Ferdigheter som lærer ansatte å bruke tillegget. Lastes opp én gang som en .tar.gz der oppføringene begynner med skills/.
BinærfilerÉn kjørbar fil per plattform. Gi hver av dem navn etter binaryName; legg til .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.

Plattformer

Last opp en binærfil for hver plattform du støtter: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 eller windows-amd64. macos- godtas som synonym for darwin-. En bot installerer binærfilen for sin egen plattform.

Last opp og send inn

Du jobber gjennom NeboAI MCP-serveren; Publisering dekker tilkobling og utviklerkontoer. Velg utviklerkontoen din, opprett deretter tillegget og be om et opplastingstoken.

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

Tokenet varer i fem minutter og dekker et hvilket som helst antall opplastinger. Last opp binærfilen for hver plattform. Send config (plugin.json) og skills sammen med én 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
SkjemafeltObligatoriskBetydning
filejaBinærfilen.
platformjaEn av de seks plattformnøklene.
configneiplugin.json, maks 1 MB.
skillsneiEn .tar.gz av mappen skills/. Oppføringer utenfor skills/ ignoreres.

Hver binærfil lagres mot tilleggets gjeldende version, og en ny opplasting for samme plattform erstatter den. For å levere en ny versjon endrer du først versjonen med plugin(action: "update", id, version), og laster deretter opp. Hver opplastingsforespørsel er begrenset til 100 MB.

Når alle plattformene er lastet opp, sender du inn den versjonen.

For et tillegg som allerede er oppført, er det bare den nye versjonen som venter på gjennomgang. Den godkjente versjonen forblir oppført og installerbar, og det er den botene oppdaterer til. Godkjenning bytter oppføringen til den nye versjonen; hvis den nye versjonen avvises, forblir den godkjente aktiv.

En versjon blir bare aktiv når den er komplett: hver plattform plugin.json lister under platforms, må først ha en godkjent binærfil. Til den siste er godkjent, får folk fortsatt den forrige versjonen, og et tillegg som aldri har vært oppført, forblir uoppført. Boter som har installert tillegget, får beskjed om den nye versjonen én gang, når den blir aktiv.

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

Gjennomgang og signering

Hver innsendte versjon skannes; en opplasting alene blir aldri gjennomgått eller levert. Når en versjon er godkjent, signerer NeboAI hver binærfil og manifestet med Ed25519, skriver den ekte hashen, størrelsen, signaturen og nedlastings-URL-en inn i plugin.json, og bygger én signert pakke per plattform.

På en bot

  • Nebo laster ned pakken for sin plattform, kontrollerer SHA-256-hashen og signaturen, og installerer den i <data>/nebo/plugins/<slug>/<version>/.
  • Nebo beholder én versjon av hvert tillegg. Installering av en ny versjon erstatter den gamle.
  • Tilleggets datamappe, <data>/appdata/plugins/<slug>/, overlever oppdateringer og avinstallering.
  • Nebo ser etter oppdateringer ett minutt etter oppstart og deretter hver sjette time. En oppdatering installeres av seg selv når eieren har slått på automatiske oppdateringer for det tillegget; ellers får eieren et varsel.

Test før du leverer

Bygg for din egen maskin og legg binærfilen og plugin.json i <data>/user/plugins/<slug>/. Et tillegg der overstyrer versjonen på markedsplassen med samme slug og hopper over signaturkontroller, så du kan prøve deg frem uten å publisere. Se Tillegg.