De bestanden voorbereiden
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 | Bestand | Doel |
|---|---|
PLUGIN.md | De marktplaatsvermelding die mensen lezen voordat ze installeren. Verstuurd als manifestContent. |
plugin.json | Het runtime-manifest. Eén keer geüpload met de eerste binary. Zie de naslag voor plugin.json. |
skills/ | Skills die medewerkers leren de plugin te gebruiken. Eén keer geüpload als .tar.gz waarvan de vermeldingen beginnen met skills/. |
| Binaries | Eén uitvoerbaar bestand per platform. Geef elk de naam uit binaryName; voeg .exe toe op 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.
Platforms
Upload een binary voor elk platform dat je ondersteunt: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 of windows-amd64. macos- wordt geaccepteerd als synoniem voor darwin-. Een bot installeert de binary voor zijn eigen platform.
Uploaden en indienen
Je werkt via de NeboAI MCP-server; Publiceren behandelt het verbinden en ontwikkelaarsaccounts. Selecteer je ontwikkelaarsaccount, maak daarna de plugin aan en vraag een uploadtoken aan.
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>") De token is vijf minuten geldig en dekt een onbeperkt aantal uploads. Upload de binary van elk platform. Stuur config (de plugin.json) en skills met een ervan mee.
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
| Formulierveld | Verplicht | Betekenis |
|---|---|---|
file | ja | De binary. |
platform | ja | Een van de zes platformsleutels. |
config | nee | De plugin.json, maximaal 1 MB. |
skills | nee | Een .tar.gz van de map skills/. Vermeldingen buiten skills/ worden genegeerd. |
Elke binary wordt opgeslagen bij de huidige version van de plugin, en hetzelfde platform opnieuw uploaden vervangt hem. Om een nieuwe versie uit te brengen, wijzig je eerst de versie met plugin(action: "update", id, version) en upload je daarna. Elk uploadverzoek is beperkt tot 100 MB.
Als elk platform is geüpload, dien je die versie in.
Bij een plugin die al vermeld staat, wacht alleen de nieuwe versie op beoordeling. De goedgekeurde versie blijft vermeld en installeerbaar, en bots werken daarnaar bij. Goedkeuring zet de vermelding over op de nieuwe versie; wordt de nieuwe versie afgewezen, dan blijft de goedgekeurde live.
Een versie gaat alleen compleet live: elk platform dat je plugin.json onder platforms noemt, moet eerst een goedgekeurde binary hebben. Tot de laatste is goedgekeurd, krijgen mensen de vorige versie, en een plugin die nog nooit vermeld is, blijft onvermeld. Bots die de plugin hebben geïnstalleerd, horen één keer over de nieuwe versie, zodra die live gaat.
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
Beoordeling en ondertekening
Elke ingediende versie wordt gescand; een upload alleen wordt nooit beoordeeld of aangeboden. Wanneer een versie is goedgekeurd, ondertekent NeboAI elke binary en het manifest met Ed25519, schrijft de echte hash, grootte, handtekening en download-URL in plugin.json, en bouwt één ondertekend pakket per platform.
Op een bot
- Nebo downloadt het pakket voor zijn platform, controleert de SHA-256-hash en de handtekening, en installeert het in
<data>/nebo/plugins/<slug>/<version>/. - Nebo bewaart één versie van elke plugin. Een nieuwe versie installeren vervangt de oude.
- De gegevensmap van de plugin,
<data>/appdata/plugins/<slug>/, blijft bewaard bij updates en verwijderingen. - Nebo zoekt een minuut na het opstarten naar updates en daarna elke zes uur. Een update installeert zichzelf als de eigenaar automatische updates voor die plugin heeft ingeschakeld; anders krijgt de eigenaar een melding.
Test voordat je uitbrengt
Bouw voor je eigen machine en zet de binary en plugin.json in <data>/user/plugins/<slug>/. Een plugin daar gaat voor op de marktplaatsversie met dezelfde slug en slaat de handtekeningcontroles over, zodat je kunt itereren zonder te publiceren. Zie Plugins.