NeboAI
NeboAI
Magsimula

Pag-ship ng Plugin

Ang pag-ship ng plugin ay pagbuo ng isang binary bawat platform, pag-upload ng bawat isa kasama ang manifest at mga skill ng plugin, at pagsusumite ng isang version para sa review. Sina-sign ng NeboAI ang mga binary kapag naaprubahan ang version, at bine-verify ito ng bawat bot bago patakbuhin.

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
FileLayunin
PLUGIN.mdAng listing sa marketplace na binabasa ng mga tao bago mag-install. Ipinapadala bilang manifestContent.
plugin.jsonAng 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 binaryIsang 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 fieldKailanganKahulugan
fileooAng binary.
platformooIsa sa anim na platform key.
confighindiAng plugin.json, hanggang 1 MB.
skillshindiIsang .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.