NeboAI
NeboAI
Почати

Випуск плагіна

Випустити плагін означає зібрати по одному бінарному файлу для кожної платформи, вивантажити кожен разом із маніфестом і навичками плагіна та надіслати версію на перевірку. NeboAI підписує бінарні файли, коли версію схвалено, і кожен бот перевіряє їх перед запуском.

Підготуйте файли

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
ФайлПризначення
PLUGIN.mdСторінка в маркетплейсі, яку люди читають перед установленням. Надсилається як manifestContent.
plugin.jsonМаніфест виконання. Вивантажується один раз разом із першим бінарним файлом. Див. «Довідник plugin.json».
skills/Навички, які вчать співробітників користуватися плагіном. Вивантажуються один раз як .tar.gz, записи якого починаються з skills/.
Бінарні файлиОдин виконуваний файл на платформу. Називайте кожен за binaryName; на Windows додайте .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.

Платформи

Вивантажте бінарний файл для кожної платформи, яку ви підтримуєте: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 або windows-amd64. macos- приймається як синонім darwin-. Бот установлює бінарний файл для своєї платформи.

Вивантажте й надішліть

Ви працюєте через MCP-сервер NeboAI; про підключення й акаунти розробника йдеться в розділі Публікація. Виберіть свій акаунт розробника, потім створіть плагін і запросіть токен для вивантаження.

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>")

Токен діє п'ять хвилин і охоплює будь-яку кількість вивантажень. Вивантажте бінарний файл для кожної платформи. Надішліть config (файл plugin.json) і 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
Поле формиОбов'язковеЗначення
fileтакБінарний файл.
platformтакОдин із шести ключів платформ.
configніФайл plugin.json, щонайбільше 1 MB.
skillsні.tar.gz папки skills/. Записи поза skills/ ігноруються.

Кожен бінарний файл зберігається для поточної version плагіна, а повторне вивантаження для тієї самої платформи замінює його. Щоб випустити нову версію, спершу змініть версію командою plugin(action: "update", id, version), а потім вивантажуйте. Кожен запит на вивантаження обмежено 100 MB.

Коли всі платформи вивантажено, надішліть цю версію.

Для плагіна, який уже є в каталозі, перевірки чекає лише нова версія. Схвалена версія залишається в каталозі й доступна для встановлення, і саме до неї оновлюються боти. Схвалення переводить сторінку на нову версію; якщо нову версію відхилено, схвалена лишається активною.

Версія стає доступною лише повністю: кожна платформа, яку ваш plugin.json перелічує в platforms, спершу повинна мати схвалений бінарний файл. Доки не схвалено останній, люди й далі отримують попередню версію, а плагін, якого ще ніколи не було в каталозі, туди не потрапляє. Боти, які встановили плагін, дізнаються про нову версію один раз, коли вона стає доступною.

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

Перевірка й підписування

Кожну надіслану версію скануємо; саме вивантаження ніколи не перевіряється й не роздається. Коли версію схвалено, NeboAI підписує кожен бінарний файл і маніфест за допомогою Ed25519, записує справжні хеш, розмір, підпис і URL завантаження в plugin.json і збирає один підписаний пакет для кожної платформи.

На боті

  • Nebo завантажує пакет для своєї платформи, перевіряє хеш SHA-256 і підпис та встановлює його в <data>/nebo/plugins/<slug>/<version>/.
  • Nebo зберігає одну версію кожного плагіна. Установлення нової версії замінює стару.
  • Папка даних плагіна, <data>/appdata/plugins/<slug>/, зберігається після оновлень і видалень.
  • Nebo перевіряє оновлення через хвилину після запуску, а потім кожні шість годин. Оновлення встановлюється само, якщо власник увімкнув для цього плагіна автоматичні оновлення; інакше власник отримує сповіщення.

Протестуйте перед випуском

Зберіть для власного комп'ютера й покладіть бінарний файл і plugin.json у <data>/user/plugins/<slug>/. Плагін там замінює версію з маркетплейсу з тим самим slug і пропускає перевірку підпису, тож ви можете вносити зміни без публікації. Див. Плагіни.