Forbered filerne
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 | Fil | Formål |
|---|---|
PLUGIN.md | Markedspladsens opslag, som folk læser, før de installerer. Sendes som manifestContent. |
plugin.json | Kørselsmanifestet. Uploades én gang med den første binærfil. Se Reference for plugin.json. |
skills/ | Færdigheder, der lærer medarbejdere at bruge pluginet. Uploades én gang som en .tar.gz, hvis poster starter med skills/. |
| Binærfiler | Én eksekverbar fil pr. platform. Navngiv hver efter binaryName; tilføj .exe på 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.
Platforme
Upload en binærfil for hver platform, du understøtter: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 eller windows-amd64. macos- accepteres som synonym for darwin-. En bot installerer binærfilen til sin egen platform.
Upload og indsend
Du arbejder gennem NeboAI MCP-serveren; Udgivelse dækker tilslutning og udviklerkonti. Vælg din udviklerkonto, opret derefter pluginet, og bed om et uploadtoken.
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>") Tokenet varer fem minutter og dækker et vilkårligt antal uploads. Upload hver platforms binærfil. Send config (plugin.json) og skills med en af dem.
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
| Formularfelt | Påkrævet | Betydning |
|---|---|---|
file | ja | Binærfilen. |
platform | ja | En af de seks platformsnøgler. |
config | nej | plugin.json, højst 1 MB. |
skills | nej | En .tar.gz af mappen skills/. Poster uden for skills/ ignoreres. |
Hver binærfil gemmes under pluginets aktuelle version, og en ny upload til samme platform erstatter den. For at udgive en ny version skal du først ændre versionen med plugin(action: "update", id, version) og derefter uploade. Hver uploadforespørgsel er begrænset til 100 MB.
Når alle platforme er uploadet, skal du indsende den version.
For et plugin, der allerede er opført, er det kun den nye version, der venter på gennemgang. Den godkendte version forbliver opført og kan installeres, og det er den, bots opdaterer til. Godkendelse skifter opslaget til den nye version; hvis den nye version afvises, forbliver den godkendte aktiv.
En version går kun live, når den er komplet: Hver platform, din plugin.json angiver under platforms, skal først have en godkendt binærfil. Indtil den sidste er godkendt, får folk fortsat den tidligere version, og et plugin, der aldrig har været opført, forbliver uopført. Bots, der har installeret pluginet, får besked om den nye version én gang, når den går live.
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
Gennemgang og signering
Hver indsendt version scannes; en upload alene bliver aldrig gennemgået eller udleveret. Når en version er godkendt, signerer NeboAI hver binærfil og manifestet med Ed25519, skriver den rigtige hash, størrelse, signatur og download-URL ind i plugin.json og bygger én signeret pakke pr. platform.
På en bot
- Nebo downloader pakken til sin platform, tjekker SHA-256-hashen og signaturen og installerer den i
<data>/nebo/plugins/<slug>/<version>/. - Nebo beholder én version af hvert plugin. Installation af en ny version erstatter den gamle.
- Pluginets datamappe,
<data>/appdata/plugins/<slug>/, overlever opdateringer og afinstallationer. - Nebo tjekker for opdateringer et minut efter start og derefter hver sjette time. En opdatering installeres af sig selv, når ejeren har slået automatiske opdateringer til for det plugin; ellers får ejeren besked.
Test, før du udgiver
Byg til din egen maskine, og læg binærfilen og plugin.json i <data>/user/plugins/<slug>/. Et plugin dér tilsidesætter markedspladsversionen med samme slug og springer signaturtjek over, så du kan iterere uden at udgive. Se Plugins.