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 | Dosya | Amaç |
|---|---|
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 dosyalar | Her 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ı | Zorunlu | Anlamı |
|---|---|---|
file | evet | İkili dosya. |
platform | evet | Altı platform anahtarından biri. |
config | hayır | En fazla 1 MB boyutunda plugin.json. |
skills | hayır | skills/ 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.