Pregătește fișierele
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 | Fișier | Scop |
|---|---|
PLUGIN.md | Pagina din magazin pe care oamenii o citesc înainte de instalare. Se trimite ca manifestContent. |
plugin.json | Manifestul de rulare. Se încarcă o singură dată, odată cu primul binar. Vezi Referința plugin.json. |
skills/ | Abilități care îi învață pe angajați să folosească pluginul. Se încarcă o singură dată ca .tar.gz ale cărui intrări încep cu skills/. |
| Binare | Un executabil per platformă. Denumește-l pe fiecare după binaryName; adaugă .exe pe Windows. |
--- 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.
Platforme
Încarcă un binar pentru fiecare platformă pe care o suporți: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 sau windows-amd64. macos- este acceptat ca sinonim pentru darwin-. Un bot instalează binarul pentru propria platformă.
Încarcă și trimite
Lucrezi prin serverul MCP NeboAI; Publicare explică conectarea și conturile de dezvoltator. Selectează-ți contul de dezvoltator, apoi creează pluginul și cere un token de încărcare.
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>") Tokenul durează cinci minute și acoperă oricâte încărcări. Încarcă binarul fiecărei platforme. Trimite config (fișierul plugin.json) și skills împreună cu unul dintre ele.
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
| Câmp de formular | Obligatoriu | Semnificație |
|---|---|---|
file | da | Binarul. |
platform | da | Una dintre cele șase chei de platformă. |
config | nu | Fișierul plugin.json, de cel mult 1 MB. |
skills | nu | Un .tar.gz al folderului skills/. Intrările din afara skills/ sunt ignorate. |
Fiecare binar este stocat pentru version curentă a pluginului, iar încărcarea din nou pentru aceeași platformă îl înlocuiește. Ca să lansezi o versiune nouă, schimbă mai întâi versiunea cu plugin(action: "update", id, version), apoi încarcă. Fiecare cerere de încărcare este limitată la 100 MB.
Când fiecare platformă este încărcată, trimite versiunea respectivă.
La un plugin care este deja listat, doar versiunea nouă așteaptă verificarea. Versiunea aprobată rămâne listată și poate fi instalată, iar boții se actualizează la ea. Aprobarea trece pagina din magazin la versiunea nouă; dacă versiunea nouă este respinsă, cea aprobată rămâne activă.
O versiune devine activă doar completă: fiecare platformă pe care plugin.json o listează sub platforms trebuie să aibă mai întâi un binar aprobat. Până la aprobarea ultimului, oamenii primesc în continuare versiunea anterioară, iar un plugin care nu a fost niciodată listat rămâne nelistat. Boții care au instalat pluginul sunt anunțați o singură dată despre versiunea nouă, când aceasta devine activă.
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
Verificare și semnare
Fiecare versiune trimisă este scanată; o simplă încărcare nu este niciodată verificată sau servită. Când o versiune este aprobată, NeboAI semnează fiecare binar și manifestul cu Ed25519, scrie hashul, dimensiunea, semnătura și URL-ul de descărcare reale în plugin.json și construiește câte un pachet semnat pentru fiecare platformă.
Pe un bot
- Nebo descarcă pachetul pentru platforma sa, verifică hashul SHA-256 și semnătura și îl instalează în
<data>/nebo/plugins/<slug>/<version>/. - Nebo păstrează o singură versiune a fiecărui plugin. Instalarea unei versiuni noi o înlocuiește pe cea veche.
- Folderul de date al pluginului,
<data>/appdata/plugins/<slug>/, rămâne după actualizări și dezinstalări. - Nebo caută actualizări la un minut după pornire și apoi la fiecare șase ore. O actualizare se instalează singură când proprietarul a activat actualizările automate pentru acel plugin; altfel, proprietarul este anunțat.
Testează înainte de lansare
Construiește pentru propriul calculator și pune binarul și plugin.json în <data>/user/plugins/<slug>/. Un plugin aflat acolo înlocuiește versiunea din magazin cu același slug și sare peste verificarea semnăturii, așa că poți itera fără să publici. Vezi Pluginuri.