NeboAI
NeboAI
Začať

Vydanie doplnku

Vydať doplnok znamená zostaviť jeden binárny súbor pre každú platformu, nahrať každý z nich spolu s manifestom a zručnosťami doplnku a odoslať verziu na kontrolu. NeboAI binárne súbory podpíše, keď je verzia schválená, a každý bot ich pred spustením overí.

Príprava súborov

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
SúborÚčel
PLUGIN.mdZáznam v obchode, ktorý ľudia čítajú pred inštaláciou. Posiela sa ako manifestContent.
plugin.jsonManifest pre beh. Nahráva sa raz s prvým binárnym súborom. Pozrite Referenciu k plugin.json.
skills/Zručnosti, ktoré učia zamestnancov doplnok používať. Nahrávajú sa raz ako .tar.gz, ktorého položky začínajú skills/.
Binárne súboryJeden spustiteľný súbor pre každú platformu. Každý pomenujte podľa binaryName; vo Windows pridajte .exe.
---
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.

Platformy

Nahrajte binárny súbor pre každú podporovanú platformu: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 alebo windows-amd64. macos- sa prijíma ako synonymum pre darwin-. Bot nainštaluje binárny súbor pre svoju platformu.

Nahratie a odoslanie

Pracujete cez server NeboAI MCP; pripojenie a vývojárske účty opisuje stránka Zverejňovanie. Vyberte svoj vývojársky účet, potom vytvorte doplnok a požiadajte o token na nahrávanie.

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

Token platí päť minút a pokrýva ľubovoľný počet nahratí. Nahrajte binárny súbor každej platformy. S jedným z nich pošlite config (súbor plugin.json) a skills.

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
Pole formuláraPovinnéVýznam
fileánoBinárny súbor.
platformánoJeden zo šiestich kľúčov platforiem.
confignieSúbor plugin.json, najviac 1 MB.
skillsnie.tar.gz priečinka skills/. Položky mimo skills/ sa ignorujú.

Každý binárny súbor sa uloží k aktuálnej version doplnku a opätovné nahratie tej istej platformy ho nahradí. Ak chcete vydať novú verziu, najprv zmeňte verziu pomocou plugin(action: "update", id, version) a potom nahrávajte. Každá požiadavka na nahratie je obmedzená na 100 MB.

Keď sú nahraté všetky platformy, odošlite túto verziu.

Pri doplnku, ktorý je už v obchode, čaká na kontrolu iba nová verzia. Schválená verzia zostáva v ponuke, dá sa inštalovať a práve na ňu sa boty aktualizujú. Schválenie prepne záznam na novú verziu; ak je nová verzia zamietnutá, schválená zostáva aktívna.

Verzia sa sprístupní iba kompletná: každá platforma, ktorú váš plugin.json uvádza v platforms, musí mať najprv schválený binárny súbor. Kým sa neschváli posledný, ľudia dostávajú predchádzajúcu verziu a doplnok, ktorý v ponuke ešte nikdy nebol, zostáva mimo nej. Boty, ktoré doplnok nainštalovali, sa o novej verzii dozvedia raz, keď sa sprístupní.

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

Kontrola a podpisovanie

Každá odoslaná verzia sa skontroluje; samotné nahratie sa nikdy nekontroluje ani neposkytuje. Keď je verzia schválená, NeboAI podpíše každý binárny súbor aj manifest pomocou Ed25519, zapíše skutočný hash, veľkosť, podpis a URL na stiahnutie do plugin.json a zostaví jeden podpísaný balík pre každú platformu.

Na botovi

  • Nebo stiahne balík pre svoju platformu, overí hash SHA-256 a podpis a nainštaluje ho do <data>/nebo/plugins/<slug>/<version>/.
  • Nebo uchováva jednu verziu každého doplnku. Inštalácia novej verzie nahradí starú.
  • Dátový priečinok doplnku, <data>/appdata/plugins/<slug>/, prežije aktualizácie aj odinštalovanie.
  • Nebo hľadá aktualizácie minútu po spustení a potom každých šesť hodín. Aktualizácia sa nainštaluje sama, ak vlastník pre daný doplnok zapol automatické aktualizácie; inak dostane vlastník upozornenie.

Testovanie pred vydaním

Zostavte doplnok pre vlastný počítač a binárny súbor spolu s plugin.json vložte do <data>/user/plugins/<slug>/. Doplnok v tomto priečinku má prednosť pred verziou z obchodu s rovnakým slugom a preskakuje overenie podpisu, takže môžete skúšať bez zverejňovania. Pozrite Doplnky.