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ájl | Cél |
|---|---|
PLUGIN.md | A piactéri adatlap, amelyet az emberek telepítés előtt elolvasnak. manifestContent formában kell elküldeni. |
plugin.json | A 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árisok | Platformonké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 |
|---|---|---|
file | igen | A bináris. |
platform | igen | A hat platformkulcs egyike. |
config | nem | A plugin.json, legfeljebb 1 MB. |
skills | nem | A 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.