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 نام‌گذاری کنید؛ در 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- پذیرفته می‌شود. هر ربات فایل اجرایی پلتفرم خودش را نصب می‌کند.

بارگذاری و ارسال

شما از طریق سرور MCP مربوط به NeboAI کار می‌کنید؛ انتشار اتصال و حساب‌های توسعه‌دهنده را توضیح می‌دهد. حساب توسعه‌دهنده خود را انتخاب کنید، سپس افزونه را بسازید و یک توکن بارگذاری درخواست کنید.

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، حداکثر ۱ مگابایت.
skillsخیریک .tar.gz از پوشه skills/. ورودی‌های بیرون از skills/ نادیده گرفته می‌شوند.

هر فایل اجرایی برای version فعلی افزونه ذخیره می‌شود، و بارگذاری دوباره همان پلتفرم آن را جایگزین می‌کند. برای عرضه نسخه جدید، ابتدا نسخه را با plugin(action: "update", id, version) تغییر دهید، سپس بارگذاری کنید. هر درخواست بارگذاری به ۱۰۰ مگابایت محدود است.

وقتی همه پلتفرم‌ها بارگذاری شدند، آن نسخه را ارسال کنید.

برای افزونه‌ای که از قبل در فروشگاه فهرست شده، فقط نسخه جدید منتظر بررسی می‌ماند. نسخه تأییدشده همچنان فهرست‌شده و قابل نصب می‌ماند، و ربات‌ها به همان به‌روز می‌شوند. تأیید، فهرست را به نسخه جدید تغییر می‌دهد؛ اگر نسخه جدید رد شود، نسخه تأییدشده فعال می‌ماند.

یک نسخه فقط وقتی کامل باشد منتشر می‌شود: هر پلتفرمی که plugin.json شما زیر platforms فهرست کرده باید ابتدا یک فایل اجرایی تأییدشده داشته باشد. تا وقتی آخرین مورد تأیید نشود، افراد همچنان نسخه قبلی را دریافت می‌کنند، و افزونه‌ای که هرگز فهرست نشده فهرست‌نشده باقی می‌ماند. ربات‌هایی که افزونه را نصب کرده‌اند یک بار، هنگام انتشار، از نسخه جدید باخبر می‌شوند.

plugin(action: "submit", id: "<plugin id>", version: "1.0.0")

بررسی و امضا

هر نسخه ارسال‌شده اسکن می‌شود؛ یک بارگذاری به‌تنهایی هرگز بررسی یا ارائه نمی‌شود. وقتی نسخه‌ای تأیید شود، NeboAI هر فایل اجرایی و مانیفست را با Ed25519 امضا می‌کند، هش، اندازه، امضا و نشانی دانلود واقعی را در plugin.json می‌نویسد، و برای هر پلتفرم یک بسته امضاشده می‌سازد.

روی یک ربات

  • Nebo بسته پلتفرم خودش را دانلود می‌کند، هش SHA-256 و امضا را بررسی می‌کند، و آن را در <data>/nebo/plugins/<slug>/<version>/ نصب می‌کند.
  • Nebo از هر افزونه یک نسخه نگه می‌دارد. نصب نسخه جدید نسخه قدیمی را جایگزین می‌کند.
  • پوشه داده افزونه، <data>/appdata/plugins/<slug>/، پس از به‌روزرسانی‌ها و حذف نصب باقی می‌ماند.
  • Nebo یک دقیقه پس از شروع و سپس هر شش ساعت به‌روزرسانی‌ها را بررسی می‌کند. وقتی مالک به‌روزرسانی خودکار را برای آن افزونه روشن کرده باشد، به‌روزرسانی خودبه‌خود نصب می‌شود؛ در غیر این صورت به مالک اطلاع داده می‌شود.

پیش از عرضه آزمایش کنید

برای دستگاه خودتان بسازید و فایل اجرایی و plugin.json را در <data>/user/plugins/<slug>/ قرار دهید. افزونه‌ای که آنجا باشد بر نسخه فروشگاه با همان slug اولویت دارد و از بررسی امضا معاف است، بنابراین می‌توانید بدون انتشار آن را بهبود دهید. افزونه‌ها را ببینید.