NeboAI
NeboAI
Comenzar

Cómo lanzar un plugin

Publicar un plugin significa 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
ArchivoPropósito
PLUGIN.mdLa ficha de la tienda que las personas leen antes de instalar. Se envía como manifestContent.
plugin.jsonEl manifiesto de ejecución. Se sube una sola 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 sola vez como un .tar.gz cuyas entradas empiezan con skills/.
BinariosUn ejecutable por plataforma. Nombra cada uno según binaryName; agrega .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-. Un bot instala el binario de su propia plataforma.

Sube y envía

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, luego 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 cubre cualquier cantidad 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 con la version actual del plugin, y subir otra vez la misma plataforma lo reemplaza. Para publicar una versión nueva, primero cambia la versión con plugin(action: "update", id, version) y luego sube. Cada solicitud de subida tiene un límite de 100 MB.

Cuando hayas subido todas las plataformas, envía esa versión.

En un plugin que ya está publicado, 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 sale completa: cada plataforma que tu plugin.json enumera en platforms debe tener primero un binario aprobado. Hasta que se apruebe el último, las personas siguen recibiendo la versión anterior, y un plugin que nunca se ha publicado sigue sin publicarse. A los bots que instalaron el plugin se les avisa de la versión nueva una sola vez, cuando sale.

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

Revisión y firma

Cada versión enviada se analiza; una subida por sí sola nunca se revisa ni se distribuye. 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 arma un paquete firmado por plataforma.

En un bot

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

Prueba antes de publicar

Compila para tu propia máquina y pon el binario y plugin.json en <data>/user/plugins/<slug>/. Un plugin ahí reemplaza la versión de la tienda con el mismo slug y se salta las verificaciones de firma, así que puedes iterar sin publicar. Consulta Plugins.