آماده کردن فایلها
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 اولویت دارد و از بررسی امضا معاف است، بنابراین میتوانید بدون انتشار آن را بهبود دهید. افزونهها را ببینید.