NeboAI
NeboAI
Kezdés

Bővítmény kiadása

Egy bővítmény kiadása azt jelenti, hogy platformonként egy binárist készít, mindegyiket feltölti a bővítmény jegyzékével és készségeivel, majd egy verziót beküld ellenőrzésre. A NeboAI a verzió jóváhagyásakor aláírja a binárisokat, és minden bot ellenőrzi őket, mielőtt futtatná.

A fájlok előkészítése

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
FájlCél
PLUGIN.mdA piactéri adatlap, amelyet az emberek telepítés előtt elolvasnak. manifestContent formában kell elküldeni.
plugin.jsonA futásidejű jegyzék. Egyszer kell feltölteni, az első binárissal együtt. Lásd: plugin.json referencia.
skills/Készségek, amelyek megtanítják a munkatársaknak a bővítmény használatát. Egyszer kell feltölteni .tar.gz fájlként, amelynek bejegyzései skills/ előtaggal kezdődnek.
BinárisokPlatformonként egy futtatható fájl. Mindegyiket a binaryName szerint nevezze el; Windowson tegye hozzá a .exe kiterjesztést.
---
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.

Platformok

Töltsön fel egy binárist minden támogatott platformhoz: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 vagy windows-amd64. A macos- a darwin- szinonimájaként is elfogadott. Egy bot a saját platformjához tartozó binárist telepíti.

Feltöltés és beküldés

A NeboAI MCP-szerveren keresztül dolgozik; a csatlakozást és a fejlesztői fiókokat a Közzététel oldal ismerteti. Válassza ki a fejlesztői fiókját, majd hozza létre a bővítményt, és kérjen feltöltési tokent.

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

A token öt percig érvényes, és tetszőleges számú feltöltésre használható. Töltse fel minden platform binárisát. Az egyikkel együtt küldje el a config (a plugin.json) és a skills mezőt.

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
ŰrlapmezőKötelezőJelentés
fileigenA bináris.
platformigenA hat platformkulcs egyike.
confignemA plugin.json, legfeljebb 1 MB.
skillsnemA skills/ mappa .tar.gz formában. A skills/ mappán kívüli bejegyzéseket figyelmen kívül hagyja.

Minden bináris a bővítmény aktuális version értékéhez tárolódik, és ugyanannak a platformnak az ismételt feltöltése lecseréli. Új verzió kiadásához előbb módosítsa a verziót a plugin(action: "update", id, version) hívással, majd töltse fel. Feltöltési kérésenként legfeljebb 100 MB küldhető.

Ha minden platform fel van töltve, küldje be az adott verziót.

Egy már listázott bővítménynél csak az új verzió vár ellenőrzésre. A jóváhagyott verzió listázva és telepíthető marad, és a botok erre frissülnek. A jóváhagyás az adatlapot az új verzióra váltja; ha az új verziót elutasítják, a jóváhagyott marad élő.

Egy verzió csak teljes formában élesedik: a plugin.json platforms részében felsorolt minden platformnak előbb jóváhagyott binárissal kell rendelkeznie. Amíg az utolsót jóvá nem hagyják, az emberek továbbra is az előző verziót kapják, a még soha nem listázott bővítmény pedig listázatlan marad. A bővítményt telepítő botok egyszer kapnak értesítést az új verzióról, amikor az élesedik.

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

Ellenőrzés és aláírás

Minden beküldött verzió átvizsgálásra kerül; egy feltöltést önmagában soha nem ellenőriznek és nem szolgálnak ki. Egy verzió jóváhagyásakor a NeboAI Ed25519-cel aláírja az összes binárist és a jegyzéket, beírja a valódi hasht, méretet, aláírást és letöltési URL-t a plugin.json fájlba, és platformonként egy aláírt csomagot készít.

A boton

  • A Nebo letölti a platformjához tartozó csomagot, ellenőrzi a SHA-256 hasht és az aláírást, majd a <data>/nebo/plugins/<slug>/<version>/ mappába telepíti.
  • A Nebo minden bővítményből egy verziót tart meg. Egy új verzió telepítése lecseréli a régit.
  • A bővítmény adatmappája, a <data>/appdata/plugins/<slug>/, megmarad frissítéskor és eltávolításkor is.
  • A Nebo az indulása után egy perccel, majd hatóránként keres frissítéseket. A frissítés magától települ, ha a tulajdonos bekapcsolta az adott bővítmény automatikus frissítését; egyébként a tulajdonos értesítést kap.

Tesztelés kiadás előtt

Fordítsa le a saját gépére, és tegye a binárist és a plugin.json fájlt a <data>/user/plugins/<slug>/ mappába. Az itt lévő bővítmény felülírja az azonos slugú piactéri verziót, és kihagyja az aláírás-ellenőrzést, így közzététel nélkül iterálhat. Lásd: Bővítmények.