Підготуйте файли
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 і пропускає перевірку підпису, тож ви можете вносити зміни без публікації. Див. Плагіни.