NeboAI
NeboAI
Empezar

Distribuir un plugin

Publicar un plugin consiste en compilar un binario por plataforma, subir cada uno con el manifiesto y las skills del plugin, y enviar una versión a revisión. NeboAI firma los binarios cuando se aprueba la versión, y cada bot los verifica antes de ejecutarlos.

Prepara los archivos

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
ArchivoFinalidad
PLUGIN.mdLa ficha de la tienda que la gente lee antes de instalar. Se envía como manifestContent.
plugin.jsonEl manifiesto de ejecución. Se sube una vez con el primer binario. Consulta la referencia de plugin.json.
skills/Skills que enseñan a los empleados a usar el plugin. Se suben una vez como un .tar.gz cuyas entradas empiezan por skills/.
BinariosUn ejecutable por plataforma. Ponle a cada uno el nombre de binaryName; añade .exe en 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.

Plataformas

Sube un binario para cada plataforma que admitas: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 o windows-amd64. macos- se acepta como sinónimo de darwin-. Cada bot instala el binario de su propia plataforma.

Subir y enviar

Trabajas a través del servidor MCP de NeboAI; Publicación explica cómo conectarte y las cuentas de desarrollador. Selecciona tu cuenta de desarrollador, crea el plugin y pide un token de subida.

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

El token dura cinco minutos y sirve para cualquier número de subidas. Sube el binario de cada plataforma. Envía config (el plugin.json) y skills con uno de ellos.

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 formularioObligatorioSignificado
filesíEl binario.
platformsíUna de las seis claves de plataforma.
confignoEl plugin.json, de 1 MB como máximo.
skillsnoUn .tar.gz de la carpeta skills/. Las entradas fuera de skills/ se ignoran.

Cada binario se guarda asociado a la version actual del plugin, y volver a subir la misma plataforma lo sustituye. Para publicar una versión nueva, cambia primero la versión con plugin(action: "update", id, version) y después sube. Cada solicitud de subida está limitada a 100 MB.

Cuando estén subidas todas las plataformas, envía esa versión.

En un plugin que ya está en la tienda, solo la versión nueva espera revisión. La versión aprobada sigue publicada e instalable, y es a la que se actualizan los bots. La aprobación cambia la ficha a la versión nueva; si la versión nueva se rechaza, la aprobada sigue activa.

Una versión solo se publica completa: cada plataforma que tu plugin.json indique en platforms debe tener antes un binario aprobado. Hasta que se apruebe el último, la gente sigue recibiendo la versión anterior, y un plugin que nunca se ha publicado sigue sin publicarse. Los bots que instalaron el plugin reciben un aviso de la versión nueva una sola vez, cuando se publica.

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

Revisión y firma

Cada versión enviada se analiza; una simple subida nunca se revisa ni se sirve. Cuando se aprueba una versión, NeboAI firma cada binario y el manifiesto con Ed25519, escribe el hash, el tamaño, la firma y la URL de descarga reales en plugin.json y genera un paquete firmado por plataforma.

En un bot

  • Nebo descarga el paquete de su plataforma, comprueba el hash SHA-256 y la firma, y lo instala en <data>/nebo/plugins/<slug>/<version>/.
  • Nebo guarda una sola versión de cada plugin. Instalar una versión nueva sustituye a la anterior.
  • La carpeta de datos del plugin, <data>/appdata/plugins/<slug>/, se conserva tras las actualizaciones y desinstalaciones.
  • Nebo busca actualizaciones un minuto después de iniciarse y luego cada seis horas. Una actualización se instala sola cuando el propietario ha activado las actualizaciones automáticas para ese plugin; si no, se avisa al propietario.

Prueba antes de publicar

Compila para tu propio equipo y pon el binario y plugin.json en <data>/user/plugins/<slug>/. Un plugin ahí sustituye a la versión de la tienda con el mismo slug y se salta las comprobaciones de firma, así que puedes iterar sin publicar. Consulta Plugins.