Kwadebe faịlụ ndị ahụ
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 | Faịlụ | Ebumnuche |
|---|---|
PLUGIN.md | Ndepụta ahịa ndị mmadụ na-agụ tupu ha awụnye. A na-eziga ya dị ka manifestContent. |
plugin.json | Manifest oge ọ na-agba. A na-ebulite ya otu ugboro ya na binary mbụ. Lee Ntụaka plugin.json. |
skills/ | Nka na-akụziri ndị ọrụ otú e si eji plugin ahụ. A na-ebulite ya otu ugboro dị ka .tar.gz nke ndenye ya na-amalite na skills/. |
| Binary | Otu ihe a na-agba maka nyiwe ọ bụla. Kpọọ nke ọ bụla aha binaryName; tinye .exe na 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.
Nyiwe
Bulite binary maka nyiwe ọ bụla ị na-akwado: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 ma ọ bụ windows-amd64. A na-anabata macos- dị ka okwu ọzọ maka darwin-. Bọt na-awụnye binary maka nyiwe nke ya.
Bulite ma zipu
Ị na-arụ ọrụ site na sava NeboAI MCP; Mbipụta na-akọwa njikọ na akaụntụ ndị mmepụta. Họrọ akaụntụ onye mmepụta gị, wee mepụta plugin ahụ ma rịọ token mbulite.
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 ahụ na-adị nkeji ise ma kpuchie mbulite ọ bụla n'ọnụọgụ. Bulite binary nke nyiwe ọ bụla. Ziga config (plugin.json) na skills ya na otu n'ime ha.
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
| Mpaghara fọm | A chọrọ ya | Ihe ọ pụtara |
|---|---|---|
file | ee | Binary ahụ. |
platform | ee | Otu n'ime igodo nyiwe isii ahụ. |
config | mba | plugin.json, ọ karịghị 1 MB. |
skills | mba | .tar.gz nke folda skills/. A na-eleghara ndenye ndị dị n'èzí skills/ anya. |
A na-echekwa binary ọ bụla megide version ugbu a nke plugin ahụ, ibulite otu nyiwe ahụ ọzọ na-edochikwa ya. Iji zipu ụdị ọhụrụ, buru ụzọ gbanwee ụdị ahụ site na plugin(action: "update", id, version), wee bulite. Arịrịọ mbulite ọ bụla nwere oke 100 MB.
Mgbe e bulitere nyiwe niile, zipu ụdị ahụ.
Na plugin e depụtalarị, ọ bụ naanị ụdị ọhụrụ na-eche nyocha. Ụdị a kwadoro ka dị na ndepụta ma enwere ike ịwụnye ya, ọ bụkwa ya ka bọt na-emelite gaa. Nkwado na-agbanwe ndepụta ahụ gaa n'ụdị ọhụrụ; ọ bụrụ na a jụrụ ụdị ọhụrụ ahụ, nke a kwadoro ka na-arụ ọrụ.
Ụdị na-aga ndụ naanị mgbe o zuru oke: nyiwe ọ bụla plugin.json gị depụtara n'okpuru platforms ga-ebu ụzọ nwee binary a kwadoro. Ruo mgbe a kwadoro nke ikpeazụ, ndị mmadụ na-anọgide na-enweta ụdị gara aga, plugin a na-edepụtabeghị ma ọlị na-anọgidekwa na-adịghị na ndepụta. A na-agwa bọt ndị wụnyere plugin ahụ maka ụdị ọhụrụ ahụ otu ugboro, mgbe ọ gara ndụ.
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
Nyocha na mbinye aka
A na-enyocha ụdị ọ bụla e zipụrụ; a naghị enyocha ma ọ bụ nye naanị mbulite. Mgbe a kwadoro ụdị, NeboAI na-eji Ed25519 abinye aka na binary ọ bụla na manifest ahụ, dee hash n'ezie, nha, mbinye aka na URL nbudata n'ime plugin.json, ma wuo otu ngwugwu e binyere aka maka nyiwe ọ bụla.
Na bọt
- Nebo na-ebudata ngwugwu maka nyiwe ya, nyochaa hash SHA-256 na mbinye aka ahụ, ma wụnye ya na
<data>/nebo/plugins/<slug>/<version>/. - Nebo na-edebe otu ụdị nke plugin ọ bụla. Ịwụnye ụdị ọhụrụ na-edochi nke ochie.
- Folda data nke plugin ahụ,
<data>/appdata/plugins/<slug>/, na-adịgide n'agbanyeghị mmelite na nwepụ. - Nebo na-enyocha mmelite otu nkeji mgbe ọ malitere, wee kwa awa isii. Mmelite na-awụnye onwe ya mgbe onye nwe ya gbanyere mmelite akpaaka maka plugin ahụ; ma ọ bụghị ya, a na-agwa onye nwe ya.
Nwalee tupu ị zipu
Wuo maka igwe nke gị ma tinye binary ahụ na plugin.json na <data>/user/plugins/<slug>/. Plugin dị ebe ahụ na-akagbu ụdị ahịa nwere otu slug ahụ ma gafee nyocha mbinye aka, ya mere ị nwere ike ịnwale ugboro ugboro na-ebipụtaghị. Lee Plugin.