Die Dateien vorbereiten
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 | Datei | Zweck |
|---|---|
PLUGIN.md | Der Marktplatz-Eintrag, den Menschen vor der Installation lesen. Wird als manifestContent gesendet. |
plugin.json | Das Laufzeit-Manifest. Wird einmal mit der ersten Binärdatei hochgeladen. Siehe plugin.json-Referenz. |
skills/ | Skills, die Mitarbeitern den Umgang mit dem Plugin beibringen. Einmal hochgeladen als .tar.gz, deren Einträge mit skills/ beginnen. |
| Binärdateien | Eine ausführbare Datei pro Plattform. Benenne jede nach binaryName; unter Windows .exe anhängen. |
--- 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.
Plattformen
Lade für jede unterstützte Plattform eine Binärdatei hoch: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 oder windows-amd64. macos- wird als Synonym für darwin- akzeptiert. Ein Bot installiert die Binärdatei für seine eigene Plattform.
Hochladen und einreichen
Du arbeitest über den NeboAI-MCP-Server; Veröffentlichen erklärt die Verbindung und Entwicklerkonten. Wähle dein Entwicklerkonto aus, erstelle dann das Plugin und fordere ein Upload-Token an.
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>") Das Token gilt fünf Minuten und deckt beliebig viele Uploads ab. Lade die Binärdatei jeder Plattform hoch. Sende config (die plugin.json) und skills mit einer davon.
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
| Formularfeld | Pflicht | Bedeutung |
|---|---|---|
file | ja | Die Binärdatei. |
platform | ja | Einer der sechs Plattformschlüssel. |
config | nein | Die plugin.json, höchstens 1 MB. |
skills | nein | Eine .tar.gz des Ordners skills/. Einträge außerhalb von skills/ werden ignoriert. |
Jede Binärdatei wird unter der aktuellen version des Plugins gespeichert, und ein erneuter Upload für dieselbe Plattform ersetzt sie. Um eine neue Version auszuliefern, ändere zuerst die Version mit plugin(action: "update", id, version) und lade dann hoch. Jede Upload-Anfrage ist auf 100 MB begrenzt.
Wenn jede Plattform hochgeladen ist, reiche diese Version ein.
Bei einem Plugin, das bereits gelistet ist, wartet nur die neue Version auf die Prüfung. Die freigegebene Version bleibt gelistet und installierbar, und auf sie aktualisieren die Bots. Die Freigabe stellt den Eintrag auf die neue Version um; wird die neue Version abgelehnt, bleibt die freigegebene live.
Eine Version geht nur vollständig live: Jede Plattform, die deine plugin.json unter platforms aufführt, braucht zuerst eine freigegebene Binärdatei. Bis die letzte freigegeben ist, erhalten alle weiterhin die vorherige Version, und ein Plugin, das noch nie gelistet war, bleibt ungelistet. Bots, die das Plugin installiert haben, werden einmal über die neue Version informiert, sobald sie live geht.
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
Prüfung und Signierung
Jede eingereichte Version wird gescannt; ein bloßer Upload wird nie geprüft oder ausgeliefert. Wenn eine Version freigegeben wird, signiert NeboAI jede Binärdatei und das Manifest mit Ed25519, trägt den echten Hash, die Größe, die Signatur und die Download-URL in plugin.json ein und baut ein signiertes Paket pro Plattform.
Auf einem Bot
- Nebo lädt das Paket für seine Plattform herunter, prüft den SHA-256-Hash und die Signatur und installiert es nach
<data>/nebo/plugins/<slug>/<version>/. - Nebo behält eine Version jedes Plugins. Die Installation einer neuen Version ersetzt die alte.
- Der Datenordner des Plugins,
<data>/appdata/plugins/<slug>/, übersteht Updates und Deinstallationen. - Nebo sucht eine Minute nach dem Start nach Updates und danach alle sechs Stunden. Ein Update installiert sich selbst, wenn der Inhaber automatische Updates für dieses Plugin aktiviert hat; andernfalls wird der Inhaber benachrichtigt.
Vor dem Ausliefern testen
Baue für deinen eigenen Rechner und lege die Binärdatei und plugin.json in <data>/user/plugins/<slug>/ ab. Ein Plugin dort überschreibt die Marktplatz-Version mit demselben Slug und überspringt die Signaturprüfung, sodass du iterieren kannst, ohne zu veröffentlichen. Siehe Plugins.