Ihanda ang mga file
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 | File | Layunin |
|---|---|
PLUGIN.md | Ang listing sa marketplace na binabasa ng mga tao bago mag-install. Ipinapadala bilang manifestContent. |
plugin.json | Ang runtime manifest. Ina-upload nang isang beses kasama ng unang binary. Tingnan ang plugin.json Reference. |
skills/ | Mga skill na nagtuturo sa mga empleyado kung paano gamitin ang plugin. Ina-upload nang isang beses bilang .tar.gz na nagsisimula sa skills/ ang mga entry. |
| Mga binary | Isang executable bawat platform. Pangalanan ang bawat isa ayon sa binaryName; dagdagan ng .exe sa Windows. |
--- 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.
Mga platform
Mag-upload ng binary para sa bawat platform na sinusuportahan mo: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 o windows-amd64. Tinatanggap ang macos- bilang kasingkahulugan ng darwin-. Ini-install ng isang bot ang binary para sa sarili nitong platform.
Mag-upload at magsumite
Gumagana ka sa pamamagitan ng NeboAI MCP server; tinatalakay ng Publishing ang pagkonekta at ang mga developer account. Piliin ang developer account mo, saka gawin ang plugin at humingi ng upload token.
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>") Tumatagal nang limang minuto ang token at sakop nito ang kahit ilang upload. I-upload ang binary ng bawat platform. Ipadala ang config (ang plugin.json) at ang skills kasama ng isa sa mga ito.
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
| Form field | Kailangan | Kahulugan |
|---|---|---|
file | oo | Ang binary. |
platform | oo | Isa sa anim na platform key. |
config | hindi | Ang plugin.json, hanggang 1 MB. |
skills | hindi | Isang .tar.gz ng folder na skills/. Binabalewala ang mga entry na nasa labas ng skills/. |
Bawat binary ay nakatala sa kasalukuyang version ng plugin, at kapag in-upload mo ulit ang parehong platform, napapalitan ito. Para mag-ship ng bagong version, palitan muna ang version gamit ang plugin(action: "update", id, version), saka mag-upload. Limitado sa 100 MB ang bawat upload request.
Kapag na-upload na ang bawat platform, isumite ang version na iyon.
Sa isang plugin na nakalista na, ang bagong version lang ang naghihintay ng review. Nananatiling nakalista at nai-install ang naaprubahang version, at iyon ang ina-update-an ng mga bot. Inililipat ng approval ang listing sa bagong version; kapag na-reject ang bagong version, mananatiling live ang naaprubahan.
Nagiging live lang ang isang version kapag kumpleto: bawat platform na nakalista sa platforms ng plugin.json mo ay kailangang may naaprubahang binary muna. Hangga't hindi naaaprubahan ang huli, ang naunang version pa rin ang nakukuha ng mga tao, at nananatiling hindi nakalista ang plugin na hindi pa kailanman nailista. Sinasabihan nang isang beses ang mga bot na nag-install ng plugin tungkol sa bagong version, kapag naging live na ito.
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
Review at signing
Ini-scan ang bawat isinumiteng version; hindi kailanman nire-review o isinisilbi ang upload lang. Kapag naaprubahan ang isang version, sina-sign ng NeboAI ang bawat binary at ang manifest gamit ang Ed25519, isinusulat ang totoong hash, size, signature at download URL sa plugin.json, at bumubuo ng isang signed na package bawat platform.
Sa isang bot
- Dina-download ng Nebo ang package para sa platform nito, sinusuri ang SHA-256 hash at ang signature, at ini-install ito sa
<data>/nebo/plugins/<slug>/<version>/. - Isang version lang ng bawat plugin ang itinatago ng Nebo. Pinapalitan ng pag-install ng bagong version ang luma.
- Nananatili ang data folder ng plugin,
<data>/appdata/plugins/<slug>/, kahit may update o uninstall. - Tumitingin ang Nebo ng mga update isang minuto pagkatapos nitong magsimula at pagkatapos ay tuwing anim na oras. Kusang nai-install ang update kapag in-on ng may-ari ang automatic updates para sa plugin na iyon; kung hindi, aabisuhan ang may-ari.
Subukan bago mag-ship
Mag-build para sa sarili mong machine at ilagay ang binary at plugin.json sa <data>/user/plugins/<slug>/. Ang plugin doon ay nangingibabaw sa version sa marketplace na may parehong slug at hindi dumadaan sa signature check, kaya makakapag-iterate ka nang hindi nagpa-publish. Tingnan ang Plugins.