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 | Fil | Formål |
|---|---|
PLUGIN.md | Oppføringen på markedsplassen som folk leser før de installerer. Sendes som manifestContent. |
plugin.json | Kjø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
| Skjemafelt | Obligatorisk | Betydning |
|---|---|---|
file | ja | Binærfilen. |
platform | ja | En av de seks plattformnøklene. |
config | nei | plugin.json, maks 1 MB. |
skills | nei | En .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.