Valmistele tiedostot
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 | Tiedosto | Tarkoitus |
|---|---|
PLUGIN.md | Kaupan esittelysivu, jonka ihmiset lukevat ennen asennusta. Lähetetään kentässä manifestContent. |
plugin.json | Ajonaikainen manifesti. Ladataan kerran ensimmäisen binäärin kanssa. Katso plugin.json-viite. |
skills/ | Taidot, jotka opettavat työntekijöitä käyttämään laajennusta. Ladataan kerran .tar.gz-tiedostona, jonka merkinnät alkavat skills/. |
| Binäärit | Yksi suoritettava tiedosto alustaa kohden. Nimeä kukin binaryName-arvon mukaan; lisää Windowsissa .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.
Alustat
Lataa binääri jokaiselle tukemallesi alustalle: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 tai windows-amd64. macos- hyväksytään synonyyminä etuliitteelle darwin-. Botti asentaa binäärin omalle alustalleen.
Lataa ja lähetä
Työskentelet NeboAI MCP -palvelimen kautta; Julkaiseminen kertoo yhdistämisestä ja kehittäjätileistä. Valitse kehittäjätilisi, luo sitten laajennus ja pyydä lataustunnus.
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>") Tunnus on voimassa viisi minuuttia ja kattaa rajattoman määrän latauksia. Lataa kunkin alustan binääri. Lähetä config (plugin.json) ja skills jonkin niistä mukana.
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
| Lomakkeen kenttä | Pakollinen | Merkitys |
|---|---|---|
file | kyllä | Binääri. |
platform | kyllä | Yksi kuudesta alusta-avaimesta. |
config | ei | plugin.json, enintään 1 MB. |
skills | ei | skills/-kansion .tar.gz-tiedosto. skills/-kansion ulkopuoliset merkinnät ohitetaan. |
Jokainen binääri tallennetaan laajennuksen nykyiselle version-versiolle, ja saman alustan lataaminen uudelleen korvaa sen. Uuden version julkaisemiseksi vaihda ensin versio komennolla plugin(action: "update", id, version) ja lataa sitten. Kunkin latauspyynnön enimmäiskoko on 100 MB.
Kun jokainen alusta on ladattu, lähetä kyseinen versio.
Jo listatussa laajennuksessa vain uusi versio odottaa tarkistusta. Hyväksytty versio pysyy listattuna ja asennettavana, ja botit päivittyvät siihen. Hyväksyntä vaihtaa esittelysivun uuteen versioon; jos uusi versio hylätään, hyväksytty pysyy käytössä.
Versio tulee käyttöön vain valmiina: jokaisella alustalla, jonka plugin.json luettelee kohdassa platforms, on ensin oltava hyväksytty binääri. Ennen kuin viimeinenkin on hyväksytty, ihmiset saavat edelleen edellisen version, ja laajennus, jota ei ole koskaan listattu, pysyy listaamattomana. Laajennuksen asentaneille boteille kerrotaan uudesta versiosta kerran, kun se tulee käyttöön.
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
Tarkistus ja allekirjoitus
Jokainen lähetetty versio skannataan; pelkkää latausta ei koskaan tarkisteta eikä jaeta. Kun versio hyväksytään, NeboAI allekirjoittaa jokaisen binäärin ja manifestin Ed25519:llä, kirjoittaa oikean tiivisteen, koon, allekirjoituksen ja latausosoitteen tiedostoon plugin.json ja rakentaa yhden allekirjoitetun paketin alustaa kohden.
Botissa
- Nebo lataa oman alustansa paketin, tarkistaa SHA-256-tiivisteen ja allekirjoituksen ja asentaa sen kansioon
<data>/nebo/plugins/<slug>/<version>/. - Nebo säilyttää jokaisesta laajennuksesta yhden version. Uuden version asentaminen korvaa vanhan.
- Laajennuksen datakansio,
<data>/appdata/plugins/<slug>/, säilyy päivitysten ja asennuksen poistojen yli. - Nebo tarkistaa päivitykset minuutti käynnistymisensä jälkeen ja sen jälkeen kuuden tunnin välein. Päivitys asentuu itsestään, kun omistaja on ottanut automaattiset päivitykset käyttöön kyseiselle laajennukselle; muuten omistajalle ilmoitetaan.
Testaa ennen julkaisua
Rakenna omalle koneellesi ja laita binääri ja plugin.json kansioon <data>/user/plugins/<slug>/. Siellä oleva laajennus ohittaa kaupan samannimisen version ja allekirjoitustarkistukset, joten voit kehittää julkaisematta. Katso Laajennukset.