NeboAI
NeboAI
Loslegen

Ein Plugin ausliefern

Ein Plugin auszuliefern heißt: eine Binärdatei pro Plattform bauen, jede zusammen mit dem Manifest und den Skills des Plugins hochladen und eine Version zur Prüfung einreichen. NeboAI signiert die Binärdateien, wenn die Version freigegeben wird, und jeder Bot prüft sie, bevor er sie ausführt.

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
DateiZweck
PLUGIN.mdDer Marktplatz-Eintrag, den Menschen vor der Installation lesen. Wird als manifestContent gesendet.
plugin.jsonDas 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ärdateienEine 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
FormularfeldPflichtBedeutung
filejaDie Binärdatei.
platformjaEiner der sechs Plattformschlüssel.
configneinDie plugin.json, höchstens 1 MB.
skillsneinEine .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.