ဖိုင်များကို ပြင်ဆင်ရန်
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 | ဖိုင် | ရည်ရွယ်ချက် |
|---|---|
PLUGIN.md | လူများ မထည့်သွင်းမီ ဖတ်သော စျေးကွက် စာရင်းဖော်ပြချက်။ manifestContent အဖြစ် ပို့သည်။ |
plugin.json | Runtime manifest။ ပထမ binary နှင့်အတူ တစ်ကြိမ် upload လုပ်သည်။ plugin.json ကိုးကားချက်ကို ကြည့်ပါ။ |
skills/ | ဝန်ထမ်းများကို Plugin သုံးနည်း သင်ပေးသော ကျွမ်းကျင်မှုများ။ Entry များ skills/ ဖြင့် စသော .tar.gz အဖြစ် တစ်ကြိမ် upload လုပ်သည်။ |
| Binary များ | Platform တစ်ခုလျှင် executable တစ်ခု။ တစ်ခုစီကို binaryName အတိုင်း အမည်ပေးပါ။ Windows တွင် .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.
Platform များ
သင် ပံ့ပိုးသော platform တစ်ခုစီအတွက် binary တစ်ခု upload လုပ်ပါ- darwin-arm64၊ darwin-amd64၊ linux-arm64၊ linux-amd64၊ windows-arm64 သို့မဟုတ် windows-amd64။ macos- ကို darwin- ၏ အဓိပ္ပာယ်တူအဖြစ် လက်ခံသည်။ ဘော့တစ်ခုသည် ၎င်း၏ ကိုယ်ပိုင် platform အတွက် binary ကို ထည့်သွင်းသည်။
Upload လုပ်ပြီး တင်သွင်းရန်
သင်သည် NeboAI MCP server မှတစ်ဆင့် အလုပ်လုပ်သည်။ ချိတ်ဆက်ခြင်းနှင့် developer အကောင့်များအကြောင်းကို ထုတ်ဝေခြင်း တွင် ဖော်ပြထားသည်။ သင့် developer အကောင့်ကို ရွေးပြီးနောက် Plugin ကို ဖန်တီးကာ upload token တစ်ခု တောင်းပါ။
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 သည် ငါးမိနစ် ခံပြီး upload အကြိမ်ရေ မည်မျှမဆို အတွက် အသုံးပြုနိုင်သည်။ Platform တစ်ခုစီ၏ binary ကို upload လုပ်ပါ။ ၎င်းတို့ထဲမှ တစ်ခုနှင့်အတူ config (plugin.json) နှင့် 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
| Form field | မဖြစ်မနေ | အဓိပ္ပာယ် |
|---|---|---|
file | ဟုတ် | Binary။ |
platform | ဟုတ် | Platform key ခြောက်ခုအနက် တစ်ခု။ |
config | မဟုတ် | plugin.json၊ အများဆုံး 1 MB။ |
skills | မဟုတ် | skills/ ဖိုင်တွဲ၏ .tar.gz။ skills/ အပြင်ဘက်ရှိ entry များကို လျစ်လျူရှုသည်။ |
Binary တစ်ခုစီကို Plugin ၏ လက်ရှိ version အောက်တွင် သိမ်းဆည်းပြီး တူညီသော platform ကို ထပ်မံ upload လုပ်ပါက အစားထိုးသည်။ ဗားရှင်းအသစ် ထုတ်ရန် plugin(action: "update", id, version) ဖြင့် ဗားရှင်းကို ဦးစွာ ပြောင်းပြီးမှ upload လုပ်ပါ။ Upload တောင်းဆိုချက်တစ်ခုစီကို 100 MB အထိ ကန့်သတ်ထားသည်။
Platform အားလုံး upload လုပ်ပြီးသောအခါ ထိုဗားရှင်းကို တင်သွင်းပါ။
စာရင်းတင်ပြီးသား Plugin တစ်ခုတွင် ဗားရှင်းအသစ်သာ စစ်ဆေးမှုကို စောင့်ရသည်။ အတည်ပြုပြီးသော ဗားရှင်းသည် စာရင်းတွင် ဆက်ရှိပြီး ထည့်သွင်းနိုင်ဆဲ ဖြစ်ကာ ဘော့များ အပ်ဒိတ်လုပ်မည့် ဗားရှင်းလည်း ဖြစ်သည်။ အတည်ပြုခြင်းက စာရင်းကို ဗားရှင်းအသစ်သို့ ပြောင်းပေးသည်။ ဗားရှင်းအသစ်ကို ငြင်းပယ်ပါက အတည်ပြုပြီးသားဗားရှင်းသည် ဆက်လက် အသုံးပြုနိုင်သည်။
ဗားရှင်းတစ်ခုသည် ပြည့်စုံမှသာ အသုံးပြုနိုင်သည်- သင့် plugin.json က platforms အောက်တွင် ဖော်ပြသော platform တိုင်းတွင် အတည်ပြုပြီး binary ဦးစွာ ရှိရမည်။ နောက်ဆုံးတစ်ခု အတည်ပြုမချင်း လူများသည် ယခင်ဗားရှင်းကို ဆက်ရနေမည်ဖြစ်ပြီး တစ်ခါမှ စာရင်းမတင်ရသေးသော Plugin သည် စာရင်းမတင်ဘဲ ရှိနေမည်။ Plugin ကို ထည့်သွင်းထားသော ဘော့များကို ဗားရှင်းအသစ် အသုံးပြုနိုင်သည့်အခါ တစ်ကြိမ် အသိပေးသည်။
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
စစ်ဆေးခြင်းနှင့် လက်မှတ်ထိုးခြင်း
တင်သွင်းသော ဗားရှင်းတိုင်းကို စကင်ဖတ်သည်။ Upload တစ်ခုတည်းကို ဘယ်တော့မှ စစ်ဆေးခြင်း သို့မဟုတ် ဝန်ဆောင်မှုပေးခြင်း မပြုပါ။ ဗားရှင်းကို အတည်ပြုသောအခါ NeboAI သည် binary တစ်ခုစီနှင့် manifest ကို Ed25519 ဖြင့် လက်မှတ်ထိုးပြီး အမှန်တကယ် hash၊ အရွယ်အစား၊ လက်မှတ်နှင့် ဒေါင်းလုဒ် URL ကို plugin.json ထဲသို့ ရေးကာ platform တစ်ခုလျှင် လက်မှတ်ထိုးထားသော package တစ်ခု တည်ဆောက်သည်။
ဘော့ပေါ်တွင်
- Nebo သည် ၎င်း၏ platform အတွက် package ကို ဒေါင်းလုဒ်လုပ်ပြီး SHA-256 hash နှင့် လက်မှတ်ကို စစ်ဆေးကာ
<data>/nebo/plugins/<slug>/<version>/သို့ ထည့်သွင်းသည်။ - Nebo သည် Plugin တစ်ခုစီ၏ ဗားရှင်းတစ်ခုသာ ထားသည်။ ဗားရှင်းအသစ် ထည့်သွင်းခြင်းက အဟောင်းကို အစားထိုးသည်။
- Plugin ၏ ဒေတာဖိုင်တွဲ
<data>/appdata/plugins/<slug>/သည် အပ်ဒိတ်များနှင့် ဖယ်ရှားခြင်းများကို ကျော်လွန်၍ ကျန်ရှိသည်။ - Nebo သည် စတင်ပြီး တစ်မိနစ်အကြာနှင့် ထို့နောက် ခြောက်နာရီတိုင်း အပ်ဒိတ်များကို စစ်ဆေးသည်။ ပိုင်ရှင်က ထို Plugin အတွက် အလိုအလျောက် အပ်ဒိတ်ကို ဖွင့်ထားပါက အပ်ဒိတ်သည် ကိုယ်တိုင် ထည့်သွင်းသည်။ မဟုတ်ပါက ပိုင်ရှင်ကို အသိပေးသည်။
မထုတ်ဝေမီ စမ်းသပ်ပါ
သင့်ကိုယ်ပိုင်စက်အတွက် တည်ဆောက်ပြီး binary နှင့် plugin.json ကို <data>/user/plugins/<slug>/ ထဲတွင် ထည့်ပါ။ ထိုနေရာရှိ Plugin သည် slug တူသော စျေးကွက်ဗားရှင်းကို အစားထိုးပြီး လက်မှတ်စစ်ဆေးမှုကို ကျော်သောကြောင့် ထုတ်ဝေရန်မလိုဘဲ ထပ်ခါထပ်ခါ ပြင်ဆင်နိုင်သည်။ Plugin များ ကို ကြည့်ပါ။