Prepara i 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 | Scopo |
|---|---|
PLUGIN.md | La scheda del marketplace che le persone leggono prima di installare. Inviata come manifestContent. |
plugin.json | Il manifest di runtime. Caricato una sola volta con il primo binario. Vedi Riferimento di plugin.json. |
skills/ | Skill che insegnano ai dipendenti a usare il plugin. Caricate una sola volta come .tar.gz le cui voci iniziano con skills/. |
| Binari | Un eseguibile per piattaforma. Dai a ciascuno il nome indicato in binaryName; aggiungi .exe su 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.
Piattaforme
Carica un binario per ogni piattaforma che supporti: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 o windows-amd64. macos- è accettato come sinonimo di darwin-. Un bot installa il binario per la propria piattaforma.
Carica e invia
Lavori tramite il server MCP di NeboAI; Pubblicazione spiega la connessione e gli account sviluppatore. Seleziona il tuo account sviluppatore, poi crea il plugin e richiedi un token di caricamento.
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>") Il token dura cinque minuti e vale per un numero qualsiasi di caricamenti. Carica il binario di ogni piattaforma. Invia config (il plugin.json) e skills insieme a uno di essi.
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
| Campo del modulo | Obbligatorio | Significato |
|---|---|---|
file | sì | Il binario. |
platform | sì | Una delle sei chiavi di piattaforma. |
config | no | Il plugin.json, al massimo 1 MB. |
skills | no | Un .tar.gz della cartella skills/. Le voci fuori da skills/ vengono ignorate. |
Ogni binario viene archiviato con la version corrente del plugin, e caricare di nuovo la stessa piattaforma lo sostituisce. Per distribuire una nuova versione, prima cambia la versione con plugin(action: "update", id, version), poi carica. Ogni richiesta di caricamento è limitata a 100 MB.
Quando hai caricato tutte le piattaforme, invia quella versione.
Per un plugin già pubblicato, solo la nuova versione attende la revisione. La versione approvata resta pubblicata e installabile, ed è quella a cui si aggiornano i bot. L'approvazione passa la scheda alla nuova versione; se la nuova versione viene respinta, quella approvata resta attiva.
Una versione va online solo se è completa: ogni piattaforma che il tuo plugin.json elenca in platforms deve prima avere un binario approvato. Finché l'ultimo non è approvato, le persone continuano a ricevere la versione precedente, e un plugin mai pubblicato resta non pubblicato. I bot che hanno installato il plugin vengono avvisati della nuova versione una sola volta, quando va online.
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
Revisione e firma
Ogni versione inviata viene analizzata; un semplice caricamento non viene mai revisionato né distribuito. Quando una versione viene approvata, NeboAI firma ogni binario e il manifest con Ed25519, scrive l'hash, la dimensione, la firma e l'URL di download reali in plugin.json, e crea un pacchetto firmato per piattaforma.
Su un bot
- Nebo scarica il pacchetto per la sua piattaforma, verifica l'hash SHA-256 e la firma, e lo installa in
<data>/nebo/plugins/<slug>/<version>/. - Nebo conserva una sola versione di ogni plugin. Installare una nuova versione sostituisce quella vecchia.
- La cartella dei dati del plugin,
<data>/appdata/plugins/<slug>/, sopravvive ad aggiornamenti e disinstallazioni. - Nebo cerca aggiornamenti un minuto dopo l'avvio e poi ogni sei ore. Un aggiornamento si installa da solo quando il proprietario ha attivato gli aggiornamenti automatici per quel plugin; altrimenti il proprietario riceve una notifica.
Prova prima di distribuire
Compila per il tuo computer e metti il binario e plugin.json in <data>/user/plugins/<slug>/. Un plugin lì sostituisce la versione del marketplace con lo stesso slug e salta le verifiche della firma, così puoi fare prove senza pubblicare. Vedi Plugin.