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