تجهيز الملفات
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 | ملف البيان وقت التشغيل. يُرفع مرة واحدة مع أول ملف تنفيذي. انظر مرجع plugin.json. |
skills/ | مهارات تعلّم الموظفين استخدام الإضافة. تُرفع مرة واحدة كملف .tar.gz تبدأ إدخالاته بـ skills/. |
| الملفات التنفيذية | ملف تنفيذي واحد لكل منصة. سمِّ كلًا منها باسم 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.
المنصات
ارفع ملفًا تنفيذيًا لكل منصة تدعمها: darwin-arm64 أو darwin-amd64 أو linux-arm64 أو linux-amd64 أو windows-arm64 أو windows-amd64. ويُقبل macos- كمرادف لـ darwin-. يثبّت البوت الملف التنفيذي الخاص بمنصته.
الرفع والتقديم
تعمل عبر خادم NeboAI MCP، وتغطي صفحة النشر الاتصال وحسابات المطوّرين. اختر حساب المطوّر الخاص بك، ثم أنشئ الإضافة واطلب رمز رفع.
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>") يدوم الرمز خمس دقائق ويغطي أي عدد من عمليات الرفع. ارفع الملف التنفيذي لكل منصة. وأرسل 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
| حقل النموذج | مطلوب | المعنى |
|---|---|---|
file | نعم | الملف التنفيذي. |
platform | نعم | واحد من مفاتيح المنصات الستة. |
config | لا | ملف plugin.json، بحد أقصى 1 MB. |
skills | لا | ملف .tar.gz للمجلد skills/. تُتجاهل الإدخالات خارج skills/. |
يُخزَّن كل ملف تنفيذي مقابل version الحالي للإضافة، ورفع المنصة نفسها مجددًا يستبدله. لشحن إصدار جديد، غيّر الإصدار أولًا عبر plugin(action: "update", id, version)، ثم ارفع. كل طلب رفع محدود بـ 100 MB.
عندما تُرفع كل المنصات، قدّم ذلك الإصدار.
في الإضافة المدرجة مسبقًا، لا ينتظر المراجعة إلا الإصدار الجديد. يبقى الإصدار المعتمد مدرجًا وقابلًا للتثبيت، وهو ما تتحدّث إليه البوتات. الموافقة تحوّل صفحة الإدراج إلى الإصدار الجديد، وإذا رُفض الإصدار الجديد، يبقى المعتمد متاحًا.
لا يصبح الإصدار متاحًا إلا كاملًا: يجب أن يكون لكل منصة يسردها plugin.json تحت platforms ملف تنفيذي معتمد أولًا. وحتى تُعتمد المنصة الأخيرة، يستمر الناس في الحصول على الإصدار السابق، وتبقى الإضافة التي لم تُدرج قط غير مدرجة. وتُبلَّغ البوتات التي ثبّتت الإضافة بالإصدار الجديد مرة واحدة، عندما يصبح متاحًا.
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
المراجعة والتوقيع
يُفحص كل إصدار مقدَّم، والرفع وحده لا يُراجَع ولا يُقدَّم أبدًا. وعند الموافقة على إصدار، توقّع NeboAI كل ملف تنفيذي وملف البيان بـ Ed25519، وتكتب البصمة والحجم والتوقيع وعنوان URL للتنزيل الحقيقية في plugin.json، وتبني حزمة موقَّعة واحدة لكل منصة.
على البوت
- ينزّل Nebo الحزمة الخاصة بمنصته، ويتحقق من بصمة SHA-256 والتوقيع، ويثبّتها في
<data>/nebo/plugins/<slug>/<version>/. - يحتفظ Nebo بإصدار واحد من كل إضافة. وتثبيت إصدار جديد يستبدل القديم.
- يبقى مجلد بيانات الإضافة،
<data>/appdata/plugins/<slug>/، بعد التحديثات وإلغاء التثبيت. - يتحقق Nebo من وجود تحديثات بعد دقيقة من بدء تشغيله ثم كل ست ساعات. يُثبَّت التحديث تلقائيًا عندما يكون المالك قد فعّل التحديثات التلقائية لتلك الإضافة، وإلا يُبلَّغ المالك.
اختبر قبل الشحن
ابنِ لجهازك الخاص وضع الملف التنفيذي وplugin.json في <data>/user/plugins/<slug>/. الإضافة الموجودة هناك تتجاوز إصدار المتجر ذي الاسم المختصر نفسه وتتخطى فحوص التوقيع، فتستطيع التكرار والتحسين دون نشر. انظر الإضافات.