Siapkan 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 | Tujuan |
|---|---|
PLUGIN.md | Listing marketplace yang dibaca orang sebelum menginstal. Dikirim sebagai manifestContent. |
plugin.json | Manifes runtime. Diunggah sekali bersama biner pertama. Lihat Referensi plugin.json. |
skills/ | Skill yang mengajari karyawan cara menggunakan plugin. Diunggah sekali sebagai .tar.gz yang entrinya diawali skills/. |
| Biner | Satu executable per platform. Beri nama masing-masing sesuai binaryName; tambahkan .exe di 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.
Platform
Unggah biner untuk setiap platform yang Anda dukung: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64, atau windows-amd64. macos- diterima sebagai sinonim untuk darwin-. Bot menginstal biner untuk platformnya sendiri.
Unggah dan kirim
Anda bekerja melalui server MCP NeboAI; Penerbitan membahas cara menghubungkan dan akun pengembang. Pilih akun pengembang Anda, lalu buat plugin dan minta token unggah.
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>") Token berlaku lima menit dan mencakup berapa pun jumlah unggahan. Unggah biner untuk setiap platform. Kirim config (plugin.json) dan skills bersama salah satunya.
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
| Kolom formulir | Wajib | Arti |
|---|---|---|
file | ya | Biner. |
platform | ya | Salah satu dari enam kunci platform. |
config | tidak | plugin.json, paling besar 1 MB. |
skills | tidak | .tar.gz dari folder skills/. Entri di luar skills/ diabaikan. |
Setiap biner disimpan untuk version plugin saat ini, dan mengunggah platform yang sama lagi akan menggantikannya. Untuk merilis versi baru, ubah dulu versinya dengan plugin(action: "update", id, version), lalu unggah. Setiap permintaan unggah dibatasi 100 MB.
Setelah semua platform diunggah, kirim versi tersebut.
Pada plugin yang sudah terdaftar, hanya versi baru yang menunggu ditinjau. Versi yang disetujui tetap terdaftar dan dapat diinstal, dan versi itulah yang menjadi tujuan pembaruan bot. Persetujuan mengalihkan listing ke versi baru; jika versi baru ditolak, versi yang disetujui tetap aktif.
Sebuah versi baru aktif jika sudah lengkap: setiap platform yang dicantumkan plugin.json Anda di bawah platforms harus memiliki biner yang disetujui terlebih dahulu. Sampai biner terakhir disetujui, orang tetap mendapatkan versi sebelumnya, dan plugin yang belum pernah terdaftar tetap tidak terdaftar. Bot yang telah menginstal plugin diberi tahu tentang versi baru satu kali, saat versi itu aktif.
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
Peninjauan dan penandatanganan
Setiap versi yang dikirim dipindai; unggahan saja tidak pernah ditinjau atau disajikan. Saat sebuah versi disetujui, NeboAI menandatangani setiap biner dan manifes dengan Ed25519, menulis hash, ukuran, tanda tangan, dan URL unduhan yang sebenarnya ke plugin.json, lalu membuat satu paket bertanda tangan per platform.
Di bot
- Nebo mengunduh paket untuk platformnya, memeriksa hash SHA-256 dan tanda tangannya, lalu menginstalnya ke
<data>/nebo/plugins/<slug>/<version>/. - Nebo menyimpan satu versi untuk setiap plugin. Menginstal versi baru akan menggantikan versi lama.
- Folder data plugin,
<data>/appdata/plugins/<slug>/, tetap ada setelah pembaruan dan pencopotan instalasi. - Nebo memeriksa pembaruan satu menit setelah dimulai, lalu setiap enam jam. Pembaruan terinstal sendiri jika pemilik telah mengaktifkan pembaruan otomatis untuk plugin tersebut; jika tidak, pemilik diberi tahu.
Uji sebelum merilis
Buat build untuk mesin Anda sendiri dan letakkan biner serta plugin.json di <data>/user/plugins/<slug>/. Plugin di sana menggantikan versi marketplace dengan slug yang sama dan melewati pemeriksaan tanda tangan, sehingga Anda dapat mencoba berulang kali tanpa menerbitkan. Lihat Plugin.