Príprava súborov
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 | Súbor | Účel |
|---|---|
PLUGIN.md | Záznam v obchode, ktorý ľudia čítajú pred inštaláciou. Posiela sa ako manifestContent. |
plugin.json | Manifest pre beh. Nahráva sa raz s prvým binárnym súborom. Pozrite Referenciu k plugin.json. |
skills/ | Zručnosti, ktoré učia zamestnancov doplnok používať. Nahrávajú sa raz ako .tar.gz, ktorého položky začínajú skills/. |
| Binárne súbory | Jeden spustiteľný súbor pre každú platformu. Každý pomenujte podľa binaryName; vo Windows pridajte .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árny súbor pre každú podporovanú platformu: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 alebo windows-amd64. macos- sa prijíma ako synonymum pre darwin-. Bot nainštaluje binárny súbor pre svoju platformu.
Nahratie a odoslanie
Pracujete cez server NeboAI MCP; pripojenie a vývojárske účty opisuje stránka Zverejňovanie. Vyberte svoj vývojársky účet, potom vytvorte doplnok a požiadajte o token na nahrávanie.
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äť minút a pokrýva ľubovoľný počet nahratí. Nahrajte binárny súbor každej platformy. S jedným z nich pošlite config (súbor 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ára | Povinné | Význam |
|---|---|---|
file | áno | Binárny súbor. |
platform | áno | Jeden zo šiestich kľúčov platforiem. |
config | nie | Súbor plugin.json, najviac 1 MB. |
skills | nie | .tar.gz priečinka skills/. Položky mimo skills/ sa ignorujú. |
Každý binárny súbor sa uloží k aktuálnej version doplnku a opätovné nahratie tej istej platformy ho nahradí. Ak chcete vydať novú verziu, najprv zmeňte verziu pomocou plugin(action: "update", id, version) a potom nahrávajte. Každá požiadavka na nahratie je obmedzená na 100 MB.
Keď sú nahraté všetky platformy, odošlite túto verziu.
Pri doplnku, ktorý je už v obchode, čaká na kontrolu iba nová verzia. Schválená verzia zostáva v ponuke, dá sa inštalovať a práve na ňu sa boty aktualizujú. Schválenie prepne záznam na novú verziu; ak je nová verzia zamietnutá, schválená zostáva aktívna.
Verzia sa sprístupní iba kompletná: každá platforma, ktorú váš plugin.json uvádza v platforms, musí mať najprv schválený binárny súbor. Kým sa neschváli posledný, ľudia dostávajú predchádzajúcu verziu a doplnok, ktorý v ponuke ešte nikdy nebol, zostáva mimo nej. Boty, ktoré doplnok nainštalovali, sa o novej verzii dozvedia raz, keď sa sprístupní.
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
Kontrola a podpisovanie
Každá odoslaná verzia sa skontroluje; samotné nahratie sa nikdy nekontroluje ani neposkytuje. Keď je verzia schválená, NeboAI podpíše každý binárny súbor aj manifest pomocou Ed25519, zapíše skutočný hash, veľkosť, podpis a URL na stiahnutie do plugin.json a zostaví jeden podpísaný balík pre každú platformu.
Na botovi
- Nebo stiahne balík pre svoju platformu, overí hash SHA-256 a podpis a nainštaluje ho do
<data>/nebo/plugins/<slug>/<version>/. - Nebo uchováva jednu verziu každého doplnku. Inštalácia novej verzie nahradí starú.
- Dátový priečinok doplnku,
<data>/appdata/plugins/<slug>/, prežije aktualizácie aj odinštalovanie. - Nebo hľadá aktualizácie minútu po spustení a potom každých šesť hodín. Aktualizácia sa nainštaluje sama, ak vlastník pre daný doplnok zapol automatické aktualizácie; inak dostane vlastník upozornenie.
Testovanie pred vydaním
Zostavte doplnok pre vlastný počítač a binárny súbor spolu s plugin.json vložte do <data>/user/plugins/<slug>/. Doplnok v tomto priečinku má prednosť pred verziou z obchodu s rovnakým slugom a preskakuje overenie podpisu, takže môžete skúšať bez zverejňovania. Pozrite Doplnky.