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 Reference دیکھیں۔
skills/مہارتیں جو ملازمین کو پلگ ان استعمال کرنا سکھاتی ہیں۔ ایک بار .tar.gz کی صورت میں اپ لوڈ ہوتی ہیں جس کے اندراجات skills/ سے شروع ہوتے ہیں۔
بائنریزہر پلیٹ فارم کے لیے ایک ایگزیکیوٹیبل۔ ہر ایک کا نام 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.

پلیٹ فارمز

ہر اس پلیٹ فارم کے لیے بائنری اپ لوڈ کریں جسے آپ سپورٹ کرتے ہیں: 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نہیںskills/ فولڈر کی .tar.gz۔ 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>/ میں رکھیں۔ وہاں موجود پلگ ان اسی slug والے مارکیٹ پلیس ورژن پر فوقیت رکھتا ہے اور دستخط کی جانچ سے مستثنیٰ ہوتا ہے، اس لیے آپ شائع کیے بغیر بار بار بہتری کر سکتے ہیں۔ پلگ انز دیکھیں۔