NeboAI
NeboAI
Začít

Vydání pluginu

Vydat plugin znamená sestavit jeden binární soubor pro každou platformu, každý nahrát spolu s manifestem a dovednostmi pluginu a odeslat verzi ke kontrole. NeboAI binární soubory podepíše, když je verze schválena, a každý bot je před spuštěním ověří.

Příprava souborů

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
SouborÚčel
PLUGIN.mdStránka v obchodě, kterou si lidé přečtou před instalací. Posílá se jako manifestContent.
plugin.jsonBěhový manifest. Nahrává se jednou s prvním binárním souborem. Viz Referenční příručka k plugin.json.
skills/Dovednosti, které zaměstnance učí plugin používat. Nahrávají se jednou jako .tar.gz, jehož položky začínají skills/.
Binární souboryJeden spustitelný soubor pro každou platformu. Každý pojmenujte podle binaryName; ve Windows přidejte .exe.
---
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.

Platformy

Nahrajte binární soubor pro každou platformu, kterou podporujete: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 nebo windows-amd64. macos- se přijímá jako synonymum pro darwin-. Bot nainstaluje binární soubor pro svou platformu.

Nahrání a odeslání

Pracujete přes server NeboAI MCP; připojení a vývojářské účty popisuje stránka Publikování. Vyberte svůj vývojářský účet, pak vytvořte plugin a požádejte o token pro nahrávání.

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

Token platí pět minut a pokrývá libovolný počet nahrání. Nahrajte binární soubor pro každou platformu. S jedním z nich pošlete config (soubor plugin.json) a skills.

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
Pole formulářePovinnéVýznam
fileanoBinární soubor.
platformanoJeden ze šesti klíčů platforem.
configneplugin.json, nejvýše 1 MB.
skillsne.tar.gz se složkou skills/. Položky mimo skills/ se ignorují.

Každý binární soubor se ukládá k aktuální hodnotě version pluginu a opětovné nahrání pro stejnou platformu ho nahradí. Chcete-li vydat novou verzi, nejprve změňte verzi pomocí plugin(action: "update", id, version) a teprve pak nahrávejte. Každý požadavek na nahrání je omezen na 100 MB.

Až budou nahrány všechny platformy, odešlete tuto verzi.

U pluginu, který už v obchodě je, čeká na kontrolu jen nová verze. Schválená verze zůstává zveřejněná a lze ji instalovat; právě na ni se boti aktualizují. Schválení přepne stránku na novou verzi; pokud je nová verze zamítnuta, zůstává v provozu ta schválená.

Verze se zveřejní jen kompletní: každá platforma, kterou váš plugin.json uvádí v platforms, musí mít nejprve schválený binární soubor. Dokud není schválen ten poslední, lidé dostávají předchozí verzi a plugin, který v obchodě ještě nikdy nebyl, zůstává nezveřejněný. Boti, kteří plugin nainstalovali, se o nové verzi dozvědí jednou, ve chvíli jejího zveřejnění.

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

Kontrola a podepisování

Každá odeslaná verze se prověří; samotné nahrání se nikdy nekontroluje ani neposkytuje. Když je verze schválena, NeboAI podepíše každý binární soubor i manifest pomocí Ed25519, zapíše do plugin.json skutečný hash, velikost, podpis a adresu URL ke stažení a sestaví jeden podepsaný balíček pro každou platformu.

Na botovi

  • Nebo stáhne balíček pro svou platformu, ověří hash SHA-256 a podpis a nainstaluje ho do <data>/nebo/plugins/<slug>/<version>/.
  • Nebo uchovává jednu verzi každého pluginu. Instalace nové verze nahradí tu starou.
  • Datová složka pluginu, <data>/appdata/plugins/<slug>/, přetrvá aktualizace i odinstalace.
  • Nebo hledá aktualizace minutu po spuštění a pak každých šest hodin. Aktualizace se nainstaluje sama, pokud vlastník pro daný plugin zapnul automatické aktualizace; jinak dostane vlastník upozornění.

Před vydáním testujte

Sestavte plugin pro svůj vlastní počítač a binární soubor spolu s plugin.json vložte do <data>/user/plugins/<slug>/. Plugin v tomto umístění přepíše verzi z obchodu se stejným slugem a přeskočí ověření podpisu, takže můžete iterovat bez publikování. Viz Pluginy.