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 МБ.
skillsнет.tar.gz папки skills/. Записи вне skills/ игнорируются.

Каждый бинарный файл сохраняется для текущей version плагина, а повторная загрузка для той же платформы заменяет его. Чтобы выпустить новую версию, сначала измените версию с помощью plugin(action: "update", id, version), затем загружайте. Каждый запрос на загрузку ограничен 100 МБ.

Когда все платформы загружены, отправьте эту версию.

Для плагина, который уже опубликован, проверки ждёт только новая версия. Одобренная версия остаётся опубликованной и доступной для установки, и именно до неё обновляются боты. Одобрение переключает страницу на новую версию; если новую версию отклонят, одобренная остаётся в силе.

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

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

Проверка и подпись

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

На боте

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

Проверьте перед выпуском

Соберите плагин для своего компьютера и положите бинарный файл и plugin.json в <data>/user/plugins/<slug>/. Плагин в этой папке заменяет версию из маркетплейса с тем же slug и пропускает проверку подписи, так что вы можете дорабатывать его без публикации. См. Плагины.