NeboAI
NeboAI
ابدأ الآن

إطلاق إضافة

شحن إضافة يعني بناء ملف تنفيذي واحد لكل منصة، ورفع كل منها مع ملف بيان الإضافة ومهاراتها، وتقديم إصدار للمراجعة. توقّع NeboAI الملفات التنفيذية عند الموافقة على الإصدار، ويتحقق منها كل بوت قبل تشغيلها.

تجهيز الملفات

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>/. الإضافة الموجودة هناك تتجاوز إصدار المتجر ذي الاسم المختصر نفسه وتتخطى فحوص التوقيع، فتستطيع التكرار والتحسين دون نشر. انظر الإضافات.