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.md | Stránka v obchodě, kterou si lidé přečtou před instalací. Posílá se jako manifestContent. |
plugin.json | Bě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í soubory | Jeden 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áře | Povinné | Význam |
|---|---|---|
file | ano | Binární soubor. |
platform | ano | Jeden ze šesti klíčů platforem. |
config | ne | plugin.json, nejvýše 1 MB. |
skills | ne | .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.