Sediakan fail
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 | Fail | Tujuan |
|---|---|
PLUGIN.md | Senarai pasaran yang dibaca orang sebelum memasang. Dihantar sebagai manifestContent. |
plugin.json | Manifes masa jalan. Dimuat naik sekali bersama binari pertama. Lihat Rujukan plugin.json. |
skills/ | Kemahiran yang mengajar pekerja menggunakan plugin. Dimuat naik sekali sebagai .tar.gz yang entrinya bermula dengan skills/. |
| Binari | Satu fail boleh laku bagi setiap platform. Namakan setiap satu mengikut binaryName; tambah .exe pada 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
Muat naik binari bagi setiap platform yang anda sokong: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 atau windows-amd64. macos- diterima sebagai sinonim bagi darwin-. Bot memasang binari untuk platformnya sendiri.
Muat naik dan serahkan
Anda bekerja melalui pelayan MCP NeboAI; Penerbitan merangkumi cara menyambung dan akaun pembangun. Pilih akaun pembangun anda, kemudian cipta plugin dan minta token muat naik.
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 sah selama lima minit dan merangkumi sebarang bilangan muat naik. Muat naik binari setiap platform. Hantar config (plugin.json) dan skills bersama salah satu daripadanya.
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
| Medan borang | Wajib | Maksud |
|---|---|---|
file | ya | Binari. |
platform | ya | Salah satu daripada enam kunci platform. |
config | tidak | plugin.json, paling besar 1 MB. |
skills | tidak | .tar.gz bagi folder skills/. Entri di luar skills/ diabaikan. |
Setiap binari disimpan mengikut version semasa plugin, dan memuat naik platform yang sama sekali lagi akan menggantikannya. Untuk menghantar versi baharu, ubah versi dahulu dengan plugin(action: "update", id, version), kemudian muat naik. Setiap permintaan muat naik terhad kepada 100 MB.
Apabila setiap platform telah dimuat naik, serahkan versi itu.
Bagi plugin yang sudah tersenarai, hanya versi baharu yang menunggu semakan. Versi yang diluluskan kekal tersenarai dan boleh dipasang, dan versi itulah yang dikemas kini oleh bot. Kelulusan menukar senarai kepada versi baharu; jika versi baharu ditolak, versi yang diluluskan kekal aktif.
Versi hanya menjadi aktif apabila lengkap: setiap platform yang disenaraikan oleh plugin.json anda di bawah platforms mesti mempunyai binari yang diluluskan terlebih dahulu. Sehingga yang terakhir diluluskan, orang terus mendapat versi sebelumnya, dan plugin yang tidak pernah disenaraikan kekal tidak tersenarai. Bot yang telah memasang plugin dimaklumkan tentang versi baharu sekali, apabila ia menjadi aktif.
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
Semakan dan penandatanganan
Setiap versi yang diserahkan diimbas; muat naik sahaja tidak pernah disemak atau disajikan. Apabila versi diluluskan, NeboAI menandatangani setiap binari dan manifes dengan Ed25519, menulis cincangan, saiz, tandatangan dan URL muat turun yang sebenar ke dalam plugin.json, dan membina satu pakej bertandatangan bagi setiap platform.
Pada bot
- Nebo memuat turun pakej untuk platformnya, menyemak cincangan SHA-256 dan tandatangan, dan memasangnya ke
<data>/nebo/plugins/<slug>/<version>/. - Nebo menyimpan satu versi bagi setiap plugin. Memasang versi baharu menggantikan versi lama.
- Folder data plugin,
<data>/appdata/plugins/<slug>/, kekal selepas kemas kini dan penyahpasangan. - Nebo menyemak kemas kini seminit selepas ia bermula dan kemudian setiap enam jam. Kemas kini dipasang dengan sendirinya apabila pemilik telah menghidupkan kemas kini automatik untuk plugin itu; jika tidak, pemilik dimaklumkan.
Uji sebelum menghantar
Bina untuk mesin anda sendiri dan letakkan binari dan plugin.json dalam <data>/user/plugins/<slug>/. Plugin di situ mengatasi versi pasaran dengan slug yang sama dan melangkau semakan tandatangan, jadi anda boleh mencuba berulang kali tanpa menerbitkan. Lihat Plugin.