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/Қызметкерлерді плагинді пайдалануға үйрететін дағдылар. Жазбалары skills/ деп басталатын бір .tar.gz ретінде бір рет жүктеледі.
Бинарлық файлдарӘр платформаға бір орындалатын файл. Әрқайсысын 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- синонимі ретінде қабылданады. Бот өз платформасына арналған бинарлық файлды орнатады.

Жүктеу және жіберу

Сіз NeboAI MCP сервері арқылы жұмыс істейсіз; қосылу мен әзірлеуші аккаунттары Жариялау бетінде түсіндірілген. Әзірлеуші аккаунтыңызды таңдаңыз, содан кейін плагин жасап, жүктеу токенін сұраңыз.

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жоқskills/ қалтасының .tar.gz архиві. 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-тағы нұсқаның орнын басады және қолтаңба тексерулерін өткізіп жібереді, сондықтан жарияламай-ақ қайталап жұмыс істей аласыз. Плагиндер бөлімін қараңыз.