រៀបចំឯកសារ
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 | manifest សម្រាប់ពេលដំណើរការ។ ផ្ទុកឡើងម្ដងជាមួយ binary ដំបូង។ សូមមើល ឯកសារយោង plugin.json។ |
skills/ | ជំនាញដែលបង្រៀនបុគ្គលិកឱ្យប្រើ Plugin។ ផ្ទុកឡើងម្ដងជា .tar.gz ដែលធាតុចាប់ផ្ដើមដោយ skills/។ |
| Binary | កម្មវិធីដំណើរការមួយក្នុងមួយវេទិកា។ ដាក់ឈ្មោះនីមួយៗតាម binaryName; បន្ថែម .exe នៅលើ 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.
វេទិកា
ផ្ទុកឡើង binary សម្រាប់វេទិកានីមួយៗដែលអ្នកគាំទ្រ៖ darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 ឬ windows-amd64។ macos- ត្រូវបានទទួលយកជាសទិសន័យនៃ darwin-។ បូតមួយដំឡើង binary សម្រាប់វេទិកាផ្ទាល់ខ្លួនរបស់វា។
ផ្ទុកឡើង និងដាក់ស្នើ
អ្នកធ្វើការតាមរយៈម៉ាស៊ីនមេ NeboAI MCP; ការបោះផ្សាយ ពន្យល់ពីការតភ្ជាប់ និងគណនីអ្នកអភិវឌ្ឍន៍។ ជ្រើសរើសគណនីអ្នកអភិវឌ្ឍន៍របស់អ្នក បន្ទាប់មកបង្កើត Plugin ហើយស្នើសុំ 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 មានសុពលភាពប្រាំនាទី ហើយគ្របដណ្ដប់ការផ្ទុកឡើងប៉ុន្មានដងក៏បាន។ ផ្ទុកឡើង binary របស់វេទិកានីមួយៗ។ ផ្ញើ config (plugin.json) និង skills ជាមួយ binary មួយក្នុងចំណោមនោះ។
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
| វាលទម្រង់ | ចាំបាច់ | អត្ថន័យ |
|---|---|---|
file | បាទ/ចាស | binary។ |
platform | បាទ/ចាស | មួយក្នុងចំណោម key វេទិកាទាំងប្រាំមួយ។ |
config | ទេ | plugin.json យ៉ាងច្រើន 1 MB។ |
skills | ទេ | .tar.gz នៃថត skills/។ ធាតុនៅខាងក្រៅ skills/ ត្រូវបានមិនអើពើ។ |
Binary នីមួយៗត្រូវបានរក្សាទុកតាម version បច្ចុប្បន្នរបស់ Plugin ហើយការផ្ទុកឡើងវេទិកាដដែលម្ដងទៀតនឹងជំនួសវា។ ដើម្បីចេញផ្សាយកំណែថ្មី ជាដំបូងប្ដូរកំណែដោយប្រើ plugin(action: "update", id, version) បន្ទាប់មកផ្ទុកឡើង។ សំណើផ្ទុកឡើងនីមួយៗត្រូវបានកំណត់ត្រឹម 100 MB។
នៅពេលវេទិកាទាំងអស់ត្រូវបានផ្ទុកឡើង សូមដាក់ស្នើកំណែនោះ។
ចំពោះ Plugin ដែលមាននៅក្នុងបញ្ជីរួចហើយ មានតែកំណែថ្មីទេដែលរង់ចាំការពិនិត្យ។ កំណែដែលបានយល់ព្រមនៅតែមាននៅក្នុងបញ្ជី និងអាចដំឡើងបាន ហើយវាគឺជាកំណែដែលបូតធ្វើបច្ចុប្បន្នភាពទៅ។ ការយល់ព្រមប្ដូរបញ្ជីទៅកំណែថ្មី; ប្រសិនបើកំណែថ្មីត្រូវបានបដិសេធ កំណែដែលបានយល់ព្រមនៅតែដំណើរការ។
កំណែមួយចេញផ្សាយបានតែនៅពេលពេញលេញប៉ុណ្ណោះ៖ រាល់វេទិកាដែល plugin.json របស់អ្នករាយនៅក្រោម platforms ត្រូវតែមាន binary ដែលបានយល់ព្រមជាមុនសិន។ រហូតដល់ binary ចុងក្រោយត្រូវបានយល់ព្រម មនុស្សនៅតែទទួលបានកំណែមុន ហើយ Plugin ដែលមិនធ្លាប់មាននៅក្នុងបញ្ជីនៅតែមិនមាននៅក្នុងបញ្ជី។ បូតដែលបានដំឡើង Plugin ត្រូវបានជូនដំណឹងអំពីកំណែថ្មីម្ដង នៅពេលវាចេញផ្សាយ។
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
ការពិនិត្យ និងការចុះហត្ថលេខា
រាល់កំណែដែលបានដាក់ស្នើត្រូវបានស្កេន; ការផ្ទុកឡើងតែឯងមិនដែលត្រូវបានពិនិត្យ ឬផ្ដល់ជូនទេ។ នៅពេលកំណែមួយត្រូវបានយល់ព្រម NeboAI ចុះហត្ថលេខាលើ binary នីមួយៗ និង manifest ដោយប្រើ Ed25519 សរសេរ hash ទំហំ ហត្ថលេខា និង URL ទាញយកពិតប្រាកដចូលក្នុង plugin.json ហើយបង្កើតកញ្ចប់ដែលបានចុះហត្ថលេខាមួយក្នុងមួយវេទិកា។
នៅលើបូត
- Nebo ទាញយកកញ្ចប់សម្រាប់វេទិការបស់វា ពិនិត្យ hash SHA-256 និងហត្ថលេខា ហើយដំឡើងវាទៅ
<data>/nebo/plugins/<slug>/<version>/។ - Nebo រក្សាកំណែតែមួយនៃ Plugin នីមួយៗ។ ការដំឡើងកំណែថ្មីជំនួសកំណែចាស់។
- ថតទិន្នន័យរបស់ Plugin គឺ
<data>/appdata/plugins/<slug>/នៅរស់រានក្រោយការធ្វើបច្ចុប្បន្នភាព និងការលុបការដំឡើង។ - Nebo ពិនិត្យរកការធ្វើបច្ចុប្បន្នភាពមួយនាទីបន្ទាប់ពីវាចាប់ផ្ដើម ហើយបន្ទាប់មករៀងរាល់ប្រាំមួយម៉ោងម្ដង។ ការធ្វើបច្ចុប្បន្នភាពដំឡើងដោយខ្លួនឯង នៅពេលម្ចាស់បានបើកការធ្វើបច្ចុប្បន្នភាពស្វ័យប្រវត្តិសម្រាប់ Plugin នោះ; បើមិនដូច្នោះទេ ម្ចាស់ត្រូវបានជូនដំណឹង។
សាកល្បងមុនពេលចេញផ្សាយ
បង្កើតសម្រាប់ម៉ាស៊ីនផ្ទាល់ខ្លួនរបស់អ្នក ហើយដាក់ binary និង plugin.json នៅក្នុង <data>/user/plugins/<slug>/។ Plugin នៅទីនោះបដិសេធកំណែទីផ្សារដែលមាន slug ដូចគ្នា ហើយរំលងការពិនិត្យហត្ថលេខា ដូច្នេះអ្នកអាចកែលម្អម្ដងហើយម្ដងទៀតដោយមិនចាំបាច់បោះផ្សាយ។ សូមមើល Plugin។