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 | Plik | Przeznaczenie |
|---|---|
PLUGIN.md | Strona w sklepie, którą ludzie czytają przed instalacją. Wysyłana jako manifestContent. |
plugin.json | Manifest ś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 binarne | Jeden 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 formularza | Wymagane | Znaczenie |
|---|---|---|
file | tak | Plik binarny. |
platform | tak | Jeden z sześciu kluczy platform. |
config | nie | Plik plugin.json, maksymalnie 1 MB. |
skills | nie | Plik .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.