NeboAI
NeboAI
Commencer

Distribuer un plugin

Livrer un plugin, c'est compiler un binaire par plateforme, envoyer chacun avec le manifeste et les skills du plugin, puis soumettre une version à la vérification. NeboAI signe les binaires quand la version est approuvée, et chaque bot les vérifie avant de les exécuter.

Préparer les fichiers

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
FichierRôle
PLUGIN.mdLa fiche de la boutique que les gens lisent avant d’installer. Envoyée en tant que manifestContent.
plugin.jsonLe manifeste d’exécution. Envoyé une seule fois avec le premier binaire. Voir la référence de plugin.json.
skills/Les skills qui apprennent aux employés à utiliser le plugin. Envoyés une seule fois sous forme de .tar.gz dont les entrées commencent par skills/.
BinairesUn exécutable par plateforme. Nommez chacun d’après binaryName ; ajoutez .exe sur 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.

Plateformes

Envoyez un binaire pour chaque plateforme prise en charge : darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 ou windows-amd64. macos- est accepté comme synonyme de darwin-. Un bot installe le binaire de sa propre plateforme.

Envoyer et soumettre

Vous travaillez via le serveur MCP de NeboAI ; la page Publication explique la connexion et les comptes développeur. Sélectionnez votre compte développeur, puis créez le plugin et demandez un jeton d'envoi.

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>")

Le jeton est valable cinq minutes et couvre un nombre illimité d'envois. Envoyez le binaire de chaque plateforme. Joignez config (le plugin.json) et skills à l'un d'eux.

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
Champ du formulaireObligatoireSignification
fileouiLe binaire.
platformouiL’une des six clés de plateforme.
confignonLe plugin.json, 1 MB au maximum.
skillsnonUn .tar.gz du dossier skills/. Les entrées situées hors de skills/ sont ignorées.

Chaque binaire est enregistré pour la version actuelle du plugin, et un nouvel envoi pour la même plateforme le remplace. Pour livrer une nouvelle version, changez d'abord la version avec plugin(action: "update", id, version), puis envoyez. Chaque requête d'envoi est limitée à 100 MB.

Une fois toutes les plateformes envoyées, soumettez cette version.

Pour un plugin déjà publié, seule la nouvelle version attend la vérification. La version approuvée reste publiée et installable, et c'est vers elle que les bots se mettent à jour. L'approbation fait passer la fiche à la nouvelle version ; si la nouvelle version est refusée, la version approuvée reste en ligne.

Une version n'est mise en ligne que complète : chaque plateforme que votre plugin.json liste sous platforms doit d'abord avoir un binaire approuvé. Tant que le dernier n'est pas approuvé, les gens continuent de recevoir la version précédente, et un plugin jamais publié reste non publié. Les bots qui ont installé le plugin sont informés de la nouvelle version une seule fois, à sa mise en ligne.

plugin(action: "submit", id: "<plugin id>", version: "1.0.0")

Vérification et signature

Chaque version soumise est analysée ; un simple envoi n'est jamais vérifié ni distribué. Quand une version est approuvée, NeboAI signe chaque binaire et le manifeste avec Ed25519, inscrit le hash, la taille, la signature et l'URL de téléchargement réels dans plugin.json, et crée un paquet signé par plateforme.

Sur un bot

  • Nebo télécharge le paquet de sa plateforme, vérifie le hash SHA-256 et la signature, et l'installe dans <data>/nebo/plugins/<slug>/<version>/.
  • Nebo conserve une seule version de chaque plugin. Installer une nouvelle version remplace l'ancienne.
  • Le dossier de données du plugin, <data>/appdata/plugins/<slug>/, est conservé lors des mises à jour et des désinstallations.
  • Nebo recherche les mises à jour une minute après son démarrage, puis toutes les six heures. Une mise à jour s'installe d'elle-même quand le propriétaire a activé les mises à jour automatiques pour ce plugin ; sinon, le propriétaire est averti.

Tester avant de livrer

Compilez pour votre propre machine et placez le binaire et plugin.json dans <data>/user/plugins/<slug>/. Un plugin placé là remplace la version de la boutique ayant le même slug et échappe aux vérifications de signature : vous pouvez itérer sans publier. Voir Plugins.