NeboAI
NeboAI
Inizia

Distribuire un plugin

Distribuire un plugin significa creare un binario per piattaforma, caricarli ciascuno con il manifest e le skill del plugin, e inviare una versione per la revisione. NeboAI firma i binari quando la versione viene approvata, e ogni bot li verifica prima di eseguirli.

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
FileScopo
PLUGIN.mdLa scheda del marketplace che le persone leggono prima di installare. Inviata come manifestContent.
plugin.jsonIl 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/.
BinariUn 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 moduloObbligatorioSignificato
filesìIl binario.
platformsìUna delle sei chiavi di piattaforma.
confignoIl plugin.json, al massimo 1 MB.
skillsnoUn .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.