NeboAI
NeboAI
Zacznij

Wydawanie wtyczki

Wydanie wtyczki oznacza zbudowanie jednego pliku binarnego na platformę, przesłanie każdego z nich razem z manifestem i umiejętnościami wtyczki oraz zgłoszenie wersji do weryfikacji. NeboAI podpisuje pliki binarne po zatwierdzeniu wersji, a każdy bot sprawdza je przed uruchomieniem.

Przygotuj pliki

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
PlikPrzeznaczenie
PLUGIN.mdStrona w sklepie, którą ludzie czytają przed instalacją. Wysyłana jako manifestContent.
plugin.jsonManifest środowiska wykonawczego. Przesyłany raz z pierwszym plikiem binarnym. Zobacz dokumentację plugin.json.
skills/Umiejętności, które uczą pracowników korzystania z wtyczki. Przesyłane raz jako .tar.gz, którego wpisy zaczynają się od skills/.
Pliki binarneJeden plik wykonywalny na platformę. Nazwij każdy zgodnie z binaryName; w Windows dodaj .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

Prześlij plik binarny dla każdej obsługiwanej platformy: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 lub windows-amd64. macos- jest akceptowane jako synonim darwin-. Bot instaluje plik binarny dla swojej platformy.

Prześlij i zgłoś

Pracujesz przez serwer MCP NeboAI; Publikowanie opisuje łączenie i konta deweloperów. Wybierz swoje konto dewelopera, a następnie utwórz wtyczkę i poproś o token przesyłania.

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 jest ważny pięć minut i obejmuje dowolną liczbę przesłań. Prześlij plik binarny każdej platformy. Z jednym z nich wyślij config (plugin.json) i 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 formularzaWymaganeZnaczenie
filetakPlik binarny.
platformtakJeden z sześciu kluczy platform.
configniePlik plugin.json, maksymalnie 1 MB.
skillsniePlik .tar.gz folderu skills/. Wpisy spoza skills/ są ignorowane.

Każdy plik binarny jest zapisywany dla bieżącej wersji wtyczki (version), a ponowne przesłanie dla tej samej platformy go zastępuje. Aby wydać nową wersję, najpierw zmień wersję za pomocą plugin(action: "update", id, version), a potem prześlij pliki. Każde żądanie przesłania jest ograniczone do 100 MB.

Gdy prześlesz pliki dla wszystkich platform, zgłoś tę wersję.

W przypadku wtyczki, która jest już w sklepie, na weryfikację czeka tylko nowa wersja. Zatwierdzona wersja pozostaje w sklepie i można ją instalować; to do niej aktualizują się boty. Zatwierdzenie przełącza stronę w sklepie na nową wersję; jeśli nowa wersja zostanie odrzucona, zatwierdzona pozostaje aktywna.

Wersja staje się aktywna tylko w komplecie: każda platforma, którą Twój plugin.json wymienia w platforms, musi najpierw mieć zatwierdzony plik binarny. Dopóki ostatni nie zostanie zatwierdzony, ludzie nadal dostają poprzednią wersję, a wtyczka, która nigdy nie była w sklepie, pozostaje niewidoczna. Boty, które zainstalowały wtyczkę, dostają informację o nowej wersji raz, gdy staje się aktywna.

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

Weryfikacja i podpisywanie

Każda zgłoszona wersja jest skanowana; samo przesłanie nigdy nie jest weryfikowane ani udostępniane. Po zatwierdzeniu wersji NeboAI podpisuje każdy plik binarny i manifest kluczem Ed25519, zapisuje w plugin.json prawdziwy skrót, rozmiar, podpis i adres URL pobierania oraz buduje jeden podpisany pakiet na platformę.

Na bocie

  • Nebo pobiera pakiet dla swojej platformy, sprawdza skrót SHA-256 i podpis, a następnie instaluje go w <data>/nebo/plugins/<slug>/<version>/.
  • Nebo przechowuje jedną wersję każdej wtyczki. Instalacja nowej wersji zastępuje starą.
  • Folder danych wtyczki, <data>/appdata/plugins/<slug>/, przetrwa aktualizacje i odinstalowanie.
  • Nebo sprawdza aktualizacje minutę po uruchomieniu, a potem co sześć godzin. Aktualizacja instaluje się sama, gdy właściciel włączył automatyczne aktualizacje tej wtyczki; w przeciwnym razie właściciel dostaje powiadomienie.

Przetestuj przed wydaniem

Zbuduj wersję na własny komputer i umieść plik binarny oraz plugin.json w <data>/user/plugins/<slug>/. Wtyczka w tym miejscu zastępuje wersję ze sklepu o tym samym slugu i pomija sprawdzanie podpisu, więc możesz wprowadzać zmiany bez publikowania. Zobacz Wtyczki.