NeboAI
NeboAI
Başlayın

Bir eklentiyi yayına alma

Bir eklentiyi yayına almak, her platform için bir ikili dosya derlemek, her birini eklentinin bildirim dosyası ve becerileriyle birlikte yüklemek ve incelenmek üzere bir sürüm göndermek demektir. NeboAI, sürüm onaylandığında ikili dosyaları imzalar ve her bot onları çalıştırmadan önce doğrular.

Dosyaları hazırlayın

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
DosyaAmaç
PLUGIN.mdİnsanların kurulumdan önce okuduğu pazar yeri ilanı. manifestContent olarak gönderilir.
plugin.jsonÇalışma zamanı bildirim dosyası. İlk ikili dosyayla birlikte bir kez yüklenir. Bkz. plugin.json başvurusu.
skills/Çalışanlara eklentiyi kullanmayı öğreten beceriler. Girdileri skills/ ile başlayan bir .tar.gz olarak bir kez yüklenir.
İkili dosyalarHer platform için bir çalıştırılabilir dosya. Her birine binaryName adını verin; Windows’ta .exe ekleyin.
---
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.

Platformlar

Desteklediğiniz her platform için bir ikili dosya yükleyin: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 veya windows-amd64. macos-, darwin- ile eş anlamlı olarak kabul edilir. Bir bot, kendi platformuna ait ikili dosyayı kurar.

Yükleyin ve gönderin

NeboAI MCP sunucusu üzerinden çalışırsınız; bağlanma ve geliştirici hesapları Yayımlama sayfasında anlatılır. Geliştirici hesabınızı seçin, ardından eklentiyi oluşturun ve bir yükleme belirteci isteyin.

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>")

Belirteç beş dakika geçerlidir ve istediğiniz sayıda yüklemeyi kapsar. Her platformun ikili dosyasını yükleyin. config (plugin.json) ve skills dosyalarını bunlardan biriyle birlikte gönderin.

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
Form alanıZorunluAnlamı
fileevetİkili dosya.
platformevetAltı platform anahtarından biri.
confighayırEn fazla 1 MB boyutunda plugin.json.
skillshayırskills/ klasörünün bir .tar.gz dosyası. skills/ dışındaki girdiler yok sayılır.

Her ikili dosya, eklentinin geçerli version değerine göre saklanır ve aynı platformu yeniden yüklemek onu değiştirir. Yeni bir sürüm yayımlamak için önce sürümü plugin(action: "update", id, version) ile değiştirin, ardından yükleyin. Her yükleme isteği 100 MB ile sınırlıdır.

Her platform yüklendiğinde o sürümü gönderin.

Zaten listelenmiş bir eklentide yalnızca yeni sürüm incelemeyi bekler. Onaylanmış sürüm listede ve kurulabilir kalır; botların güncellendiği sürüm de odur. Onay, ilanı yeni sürüme geçirir; yeni sürüm reddedilirse onaylanmış olan yayında kalır.

Bir sürüm yalnızca eksiksiz olduğunda yayına girer: plugin.json dosyanızın platforms altında listelediği her platformun önce onaylanmış bir ikili dosyası olmalıdır. Sonuncusu onaylanana kadar insanlar önceki sürümü almaya devam eder ve hiç listelenmemiş bir eklenti listelenmemiş kalır. Eklentiyi kurmuş botlara yeni sürüm, yayına girdiğinde bir kez bildirilir.

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

İnceleme ve imzalama

Gönderilen her sürüm taranır; tek başına bir yükleme asla incelenmez veya sunulmaz. Bir sürüm onaylandığında NeboAI her ikili dosyayı ve bildirim dosyasını Ed25519 ile imzalar, gerçek karma değerini, boyutu, imzayı ve indirme URL’sini plugin.json içine yazar ve her platform için imzalı bir paket oluşturur.

Bir botta

  • Nebo kendi platformunun paketini indirir, SHA-256 karma değerini ve imzayı denetler ve onu <data>/nebo/plugins/<slug>/<version>/ konumuna kurar.
  • Nebo her eklentinin tek bir sürümünü tutar. Yeni bir sürüm kurmak eskisinin yerini alır.
  • Eklentinin veri klasörü <data>/appdata/plugins/<slug>/, güncellemelerden ve kaldırmalardan sonra da korunur.
  • Nebo, başladıktan bir dakika sonra ve ardından altı saatte bir güncellemeleri denetler. Sahip o eklenti için otomatik güncellemeleri açtıysa güncelleme kendiliğinden kurulur; aksi hâlde sahibe bildirim gider.

Yayına almadan önce test edin

Kendi makineniz için derleyin ve ikili dosyayı ve plugin.json’ı <data>/user/plugins/<slug>/ içine koyun. Oradaki bir eklenti, aynı slug’a sahip pazar yeri sürümünü geçersiz kılar ve imza denetimlerini atlar; böylece yayımlamadan deneme yapabilirsiniz. Bkz. Eklentiler.