Bir eklenti yayımlamak — AiHummer Belgeler

İle bir eklenti oluşturuldu Eklenti SDK? Bunu şurada yayınlayabilirsiniz iki yol:

Özel (kendin için) — senin örneğine yan yükle. Artefakt hiçbir zaman bırakır.
Topluluk (herkes için) — kendi aracılığınızla yayınlayın kişisel dolap de/da my.aihummer.ru, uygulama mağazası stil: yapıyı yükle, mağaza sayfasını doldur, incelemeyi geç ve o şurada yer alır her örneğin yükleyebileceği imzalı topluluk kataloğu.

Benzetme: kurulum .vsix elle (özel) vs bir uygulama mağazasına yayınlamak (topluluk).

[!WARNING] Topluluk eklentileri şu anda kurulamıyor — bu bir bağlantı sorunu değil. Topluluk kataloğunu imzalayan anahtar geri çekildi; yeni bir anahtar yayınlanana kadar imza denetimi bu kayıtları reddediyor. Bundan bağımsız olarak, üçüncü taraf kod sunucunuzda henüz bir servis olarak çalıştırılmıyor: yalıtılmış bir çalışma ortamı hazır olana kadar yalnızca kendi tarafında çalışan ve ağ üzerinden bağlanan entegrasyonlara izin veriliyor.

Ne göreceksiniz: «kur» düğmesinden sonra her zamanki «kuruluyor» mesajı çıkar, ama eklenti kurulu listesinde hiç görünmez. Reddin nedeni ağ geçidi günlüğüne yazılır — yönetim panelinde Günlükler’i açın.

Bugün işleyenler:

AiHummer’ın resmî katalogdaki eklentileri — her zamanki gibi kurulur, bunlar farklı ve geçerli bir imza taşır;

HTTP üzerinden MCP sunucusu — geliştirme gerektirmeyen bir araç kaynağı olarak bağlanır, kod sizin tarafınızda kalır;

OpenAPI belirtimiyle entegrasyon — aynısı, kurulacak servis olmadan.

Kendi eklentinizi elle yüklemek imza denetimini geçer, ama yalnızca HTTP üzerinden uzak MCP ya da OpenAPI entegrasyonu olarak çalışır; aynı sunucuda servis olarak başlatılması gereken bir yapı reddedilir.

Özel mod — örneğinize yan yükleme yapın

Bunu yalnızca eklentiye ihtiyacınız olduğunda kullanın: dahili bir bağlayıcı, özel bir entegrasyon, bir test sürümü.

Adımlar

Paketi hazırlayın ve demeti imzalayın:

aihummer plugin package ./my-plugin
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

Bunu instance’a iki şekilde yükleyin:

Admin UI → Eklentiler → “Eklenti yükle” — paketi sürükle; veya

CLI:

aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz

Kapağın altında bu POST /v1/admin/modules/upload (çok parçalı, integrations:write): eser yere düşer örnek blob deposu (AIHUMMER_BLOB_DIR) altında bir blob: ref ve bir katalog satırı ile kaydedilir origin = local-private, visibility = private.
Eklenti, pazaryerinde etiketlenmiş olarak görünüyor Özel ve aracılığıyla kurar normal yol — sandboxlu systemd birimi + sağlık kapısı.

Güven: sabitlenmiş anahtar ve güven deposu

Özel eserler imzalanmış olmalıdır. Bilinmeyen bir anahtarla imzalanmış bir eklenti yüklediğinizde, Yönetici Arayüzü size şunu yapmanızı söyler yazarın anahtarını onayla örnek güven deposuna (tek tıkla) eklenir. Onaylandıktan sonra, imza her yükleme ve güncellemede doğrulanır.

den kalma eserler resmî kaynağı doğrula karşı kayıt defteri anahtarı sabitlendi çekirdekte — varsayılan olarak güvenilir, ekstra adım yok.
Özel artefaktlar, örnek güven deposundaki anahtarlara karşı doğrulanır.
İmzalanmamış paketler reddedilir — yerel yineleme için geliştirme modunda hariç: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 imza doğrulamayı devre dışı bırakır ve amaçlanmıştır sadece yerel geliştirme için. Asla harici olarak erişilebilen bir örnekte etkinleştirmeyin.

Topluluk modu — kişisel kabin üzerinden yayınla

Bir eklentiyi kullanılabilir hale getirmek için her örneğin, onu sizin tarafınızdan yayınlayın kişisel dolap de/da my.aihummer.ru, bir uygulamayı uygulama mağazasına yayınladığınız şekilde. Yapıyı yüklersiniz, mağaza sayfasını doldurursunuz ve incelemeye gönderirsiniz; önce otomatik bir yapay zeka kontrolü yapılır, sonra bir insan moderatör nihai kararı verir ve onaylandığında ürün imzalanır ve topluluk kataloğuna yayınlanır.

Tam adım adım rehber şurada Bir eklenti gönder. Kısaca:

Oluştur ve paketle SDK ile eklentiniz (aihummer plugin package) — eser bir imzalı .tar.gz taşıyan manifest.json.
«Eklentilerim»i aç dolapta ve bir gönderim oluştur: yükle eser, doldurun meta veriyi saklamak (isim ve açıklamalar RU + EN’de, sürüm, simge, ekran görüntüleri, kategori, isteğe bağlı bağış bağlantısı, değişiklik günlüğü) ve ilan et yetenek bildirimi.
İncelenmek üzere gönder. Otomatik Yapay zeka incelemesi teslimatı karşılaştırır inceleme politikası (güvenlik, bildirim) doğruluk, bütünlük, içerik), sonra bir insan moderatör raporu okur ve karar verir. Otomasyon kendi başına hiç yayın yapmaz.
Onay üzerine eser imzalı ve bir … olarak yayınlandı ayrı community-catalog.json CDN üzerinde. Ekleyen her örnek topluluk kaynağı eklentiyi görür; çekirdek buna aracılığıyla güvenir sabitleştirilmiş kayıt defteri anahtarı — operatör başına güven adımı gerekmez.

[!NOTE] Eski genel yayınlama akışı emekliye ayrıldı; yukarıdaki kişisel-dolap akışı — “Eklentilerim” — artık tek topluluk yayınlama yoludur. Topluluk eklentileri ücretsizdir; isteğe bağlı bir bağış bağlantısı ekleyebilirsiniz.

[!NOTE] Birinci taraf eklentiler (Einstein, SIP, Bitrix24, pocket-agent, os-client) şunlardır bu şekilde yayımlanmadı — kendi AiHummer CI boru hattında gönderiliyorlar ve ulaşıyorlar sabitlenmiş resmi katalog. Kişisel kabin akışı şudur topluluk (üçüncü taraf) eklenti.

Ortalama

Her topluluk gönderimi bir süreçten geçer otomatik kontrol (tamlık, yetenek bildirimi, imza ve bir güvenlik taraması), sonra bir Yapay zeka risk incelemesi, ve nihayet bir zorunlu insan incelemesi AiHummer ekibi tarafından. Ne otomasyon ne de yapay zeka kendi başına yayın yapmaz — karar her zaman bir moderatörün olur ve onayları olmadan hiçbir şey kataloğa ulaşmaz. Daha sonra kötü niyetli veya bozuk olduğu tespit edilen bir yayınlanmış eklenti iptal edildi ve bir sonraki senkronizasyonda katalogdan kaldırıldı.

Topluluk kataloğu ek bir kaynak olarak

Topluluk eklentileri bir yere yayımlanır ayrı community-catalog.json bunu yapar değil önceden seçilmiş birinci taraf kataloğunu üzerine yaz. Bir örnek, bunu ek bir kaynak olarak ekler Eklentiler → Kaynaklar (veya POST /v1/admin/modules/catalog/sources). Bak Kurulum ve güncellemeler ve Genel Bakış ve Katmanlar.

Eklenti yaşam döngüsü (Uygulama Mağazası)

Pazar yeri gerçek bir Uygulama Mağazası gibi çalışır — her eklentinin bir kimlik (gönderildiği kalıcı bir kısayol + yazar) sürümler.

Sürümler ve güncellemeler

Bir güncelleme olarak gönderilir yeni sürüm zaten yayımlanmış bir eklentinin: aynı kısa ad, kendi değişiklik günlüğü, kendi inceleme ve denetimi. Sadece bir sürüm bir seferde incelemede olabilir — mevcut sürüme bir karar verildikten sonra bir sonrakini gönderirsiniz. Yeni bir sürüm yayınlandığında, önceki sürüm işaretlenir superseded, ve katalog + her bir örnek yenisine taşındı.

Planlanmış yayın

Bir moderatör onayladıktan sonra, yazar yayını kontrol eder: şimdi yayınlayın veya belirli bir zaman için planlayın — eklenti belirlenen anda yayına girer.

Yayından kaldırma

Duraklat — eklentiyi geçici olarak gizle: genel katalogdan ve örneklerden düşer (bir sonraki senkronizasyonda), ancak korunur ve kullanılabilir yeniden yayımlandı her zaman.
Listeden çıkar — eklentiyi pazaryerinden tamamen kaldır.

Bir eklenti yayından kaldırılır kaldırılmaz (durdurulduğunda veya listeden çıkarıldığında), kaydı kaldırılır community-catalog.json, ve örnekler bir sonraki senkronizasyonda bunu göstermeyi bırakır.

Yazarlık

Bir eklenti altında yayımlanır görünen adınız (ör. stüdyonuzun adı) — veya anonim olarak. Genel katalog ve örnek Web UI, seçilen adı veya “Anonim”i gösterir; gerçek e-posta/adınız asla açığa çıkarılmaz.

Geliştirici istatistikleri

Her eklentinin toplam istatistikler: indirmeler, kurulumlar, aktif örnekler ve kaldırmalar, artı günlük bir grafik. Sadece toplam rakamlar — geliştiriciye örnek başına veri sunulmaz.

Yayın ödülü

için ilk kez yayınladığınız her eklenti, AiHummer aboneliğiniz alır bir ay ücretsiz (her eklenti için bir kez verilir).

Sırada neresi

Kişisel kabin üzerinden gönder — tamamı adım adım: metadata, yetenek manifestosu, yapay zeka incelemesi ve moderasyon.
Eklenti SDK — manifest alanları ve aihummer plugin komutları.
Kurulum ve güncellemeler — çok kaynaklı, güven modeli, imzalı güncellemeler, sıralama.
Politika ve kontrol listesi incelemesi — kriterler a Eklenti, yayınlanmadan önce kontrol edilir.
Pazar Yeri: genel bakış ve seviyeler — resmi vs topluluk kaydı.