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 | Archivo | Propósito |
|---|---|
PLUGIN.md | La ficha de la tienda que las personas leen antes de instalar. Se envía como manifestContent. |
plugin.json | El 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/. |
| Binarios | Un 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 formulario | Obligatorio | Significado |
|---|---|---|
file | sí | El binario. |
platform | sí | Una de las seis claves de plataforma. |
config | no | El plugin.json, de 1 MB como máximo. |
skills | no | Un .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.