Plugin dərc etmək — AiHummer Sənədlər

Bununla bir əlavəni qurdu Plugin SDK? Siz bunu yayımlaya bilərsiniz iki yol:

Şəxsi (özün üçün) — öz nüsxənizə yan yükləyin. Artefakt heç vaxt bunu buraxır.
İcma (hər kəs üçün) — vasitənizlə nəşr et şəxsi kabinet at my.aihummer.ru, tətbiq mağazası stil: hazırlanmış faylı yükləyin, mağaza səhifəsini doldurun, yoxlamadan keçin və o yerləşdirilir hər bir nümunənin quraşdıra biləcəyi imzalı icma kataloqu.

Analogi: quraşdırmaq .vsix əl ilə (şəxsi) vs bir tətbiq mağazasına yerləşdirmək (icma).

[!WARNING] İcma plaginlərini hazırda quraşdırmaq mümkün deyil — bu, əlaqə nasazlığı deyil. İcma kataloqunu imzalayan açar geri çağırılıb; yeni açar buraxılana qədər imza yoxlaması belə qeydləri rədd edir. Bundan asılı olmayaraq, üçüncü tərəf kodu hələ sizin serverinizdə xidmət kimi işə salınmır: təcrid olunmuş icra mühiti yaranana qədər yalnız öz tərəfində işləyən və şəbəkə üzərindən qoşulan inteqrasiyalara icazə verilir.

Nə görəcəksiniz: «quraşdır» düyməsindən sonra adi «quraşdırılır» mesajı çıxır, lakin plagin quraşdırılmışlar siyahısında heç vaxt görünmür. İmtina səbəbi şlüz jurnalına yazılır — idarə panelində Jurnallar bölməsini açın.

Bu gün nə işləyir:

rəsmi kataloqdakı AiHummer plaginləri — həmişəki kimi quraşdırılır, onlarda başqa, etibarlı imza var;

HTTP üzərindən MCP serveri — proqramlaşdırma olmadan alət mənbəyi kimi qoşulur, kod sizin tərəfinizdə qalır;

OpenAPI spesifikasiyası üzrə inteqrasiya — eyni şey, quraşdırılacaq xidmət olmadan.

Öz plagininizin əl ilə yüklənməsi imza yoxlamasından keçir, lakin yalnız HTTP üzərindən uzaq MCP və ya OpenAPI inteqrasiyası kimi işləyəcək; həmin serverdə xidmət kimi başladılmalı olan yığım rədd edilir.

Şəxsi rejim — instansiyanıza yan yükləmə

Bunu yalnız pluginə ehtiyacınız olduqda istifadə edin: daxili birləşdirici, xüsusi inteqrasiya, test quruluşu.

Addımlar

Toplamanı paketləyin və 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 nümunəyə iki yoldan biriylə yükləyin:
- Admin UI → Plaginlər → “Plagin yüklə” — paketi sürükləyin; və ya
- CLI:
```
aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz
```
Bunun altında bu var POST /v1/admin/modules/upload (çoxhissəli, integrations:write): artefakt düşür nümunə blob mağazası (AIHUMMER_BLOB_DIR) altında blob: ref və bir kataloq sətri ilə qeydiyyatdan keçirilir origin = local-private, visibility = private.
Plugin bazarda etiketlə göstərilir Şəxsi və vasitəsilə quraşdırır normal yol — sandbox edilmiş systemd vahidi + sağlamlıq qapısı.

Etibar: bağlı açar və etibar mağazası

Şəxsi artefaktlar imzalanmalıdır. Naməlum açarla imzalanmış bir plagini yüklədiyiniz zaman, İdarəetmə İstifadəçi İnterfeysi sizə xatırlatma edir ki, müəllifin açarını təsdiqləmək nümunə etibarlılıq mağazasına (bir kliklə) daxil edilir. Təsdiqləndikdən sonra, imza hər quraşdırmada və yeniləmədə yoxlanılır.

Əşyalar rəsmi mənbəni qarşısında yoxlayın reyestr açarı bağlanmış əsasda — standart olaraq etibarlı, əlavə addım yoxdur.
Şəxsi Artefaktlar instansiya etibar anbarındakı açarlarla yoxlanılır.
İmzalanmamış paketlər rədd edilir — yalnız lokal iterasiya üçün inkişaf rejimində istisnadır: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 imza yoxlamasını deaktiv edir və nəzərdə tutulub yalnız yerli inkişaf üçün. Heç vaxt xaricdən əlçatan olan bir instansiyada aktiv etməyin.

İcma rejimi — şəxsi kabinet vasitəsilə yayım

Bir plagini əldə edilə bilən etmək üçün hər nümunə, onu özünüzdən yayımlayın şəxsi kabinet at my.aihummer.ru, eyni şəkildə bir tətbiqi tətbiq mağazasına yayımladığınız kimi. Siz tikintini yükləyirsiniz, mağaza səhifəsini doldurursunuz və nəzərdən keçirmək üçün göndərirsiniz; əvvəlcə avtomatlaşdırılmış AI yoxlaması aparılır, sonra insan moderator son qərarı verir və təsdiqləndikdə artefakt imzalanır və icma kataloquna yayımlanır.

Tam, addım-addım gedişat burada Plugin göndərinQısaca:

Yarat və paketlə sizin SDK ilə əlavəniz (aihummer plugin package) — artefakt imzalanmış .tar.gz daşıyan onun manifest.json.
«Mənim əlavələrim» bölməsini aç şkafda və təqdimat yarat: yüklə sənət əsəri, doldurun metadataları saxlamaq (ad & təsvirlər RU + EN dilində, versiya, ikon, ekran görüntüləri, kateqoriya, isteğe bağlı ianə linki, dəyişiklik jurnalı) və elan et bacarıq manifesti.
Yoxlama üçün göndərin. Avtomatlaşdırılmış Süni intellekt icmalı təqdimatı qarşısında yoxlayır o rəylər siyasəti (təhlükəsizlik, manifesto) düzgünlük, tamlıq, məzmun), sonra bir insan moderatoru hesabatı oxuyur və qərar verir. Avtomatlaşdırma özü-özünə heç vaxt yayım etmir.
Təsdiqdən sonra artefaktdır imzalanmış və nəşr olundu ayrılmış community-catalog.json CDN-də. Hər bir nüsxə ki əlavə olunub icma mənbəyi plaginı görür; əsas onu vasitəsilə etibar edir sabitlənmiş registr açarı — operator üzrə etimad addımı tələb olunmur.

[!NOTE] Köhnə ictimai nəşr axını ləğv edilib; yuxarıdakı şəxsi kabinet axını — «Mənim plaginlərim» — indi yeganə icma nəşr yoludur. İcma plaginləri pulsuz; istəyə görə ianə linki əlavə edə bilərsiniz.

[!NOTE] Birinci tərəf plaginləri (Einstein, SIP, Bitrix24, pocket-agent, os-client) bunlardır belə yayımlanmır — onlar öz AiHummer CI boru xəttində göndərilir və çatır sabitlenmiş rəsmi kataloq. Şəxsi kabinet axını üçün icma (üçüncü tərəf) plaginlər.

Moderasiyası

Hər icma təqdimatı bir avtomatlaşdırılmış yoxlama (tamlıq, qabiliyyət manifesti, imza və təhlükəsizlik skanı), sonra isə bir Süni intellekt riski icmalı, və nəhayət bir mütləq insan yoxlaması AiHummer komandası tərəfindən. Avtomatlaşdırma da, AI da heç vaxt öz-özünə nəşr etmir — qərar həmişə moderatorundur və onların təsdiqi olmadan heç nə kataloqa daxil olmur. Sonradan zərərli və ya işləməyən olduğu aşkar edilən bir nəşr olunmuş plagin ləğv edildi və növbəti sinxronizasiyada kataloqdan çıxarıldı.

İcma kataloqu əlavə mənbə kimi

Cəmiyyət əlavələri nəşr olunur ayrılmış community-catalog.json bu edir yox seçilmiş birinci tərəf kataloqunu üzərinə yazın. Bir nümunə bunu əlavə mənbə kimi əlavə edir Plaginlər → Mənbələr (və ya POST /v1/admin/modules/catalog/sources). Bax Quraşdırma və yeniləmələr və Ümumi baxış və səviyyələr.

Pluginin həyat dövrü (App Store)

Bazar real App Store kimi işləyir — hər bir plaginə malikdir şəxsiyyət (daimi şəkilçi + müəllif) altında göndərilir versiyalar.

Versiyalar və yeniləmələr

Yeniləmə kimi göndərilir yeni versiya artıq dərc olunmuş plagin haqqında: eyni slug, onun öz dəyişiklik jurnal, onun öz rəy və moderasiyası. Yalnız bir Versiya eyni vaxtda nəzərdən keçirilə bilər — siz növbəti versiyanı mövcud olan qərar aldıktan sonra təqdim edirsiniz. Yeni versiya yayımlandıqda, əvvəlki versiya işarələnir superseded, və kataloq + hər bir nümunə yeni yerə köçür.

Planlaşdırılmış nəşr

Bir moderator onu təsdiqlədikdən sonra, müəllif buraxılışı idarə edir: indi dərc et, yoxsa müəyyən bir vaxta planlaşdır — əlavə proqram təyin olunmuş anda istifadəyə verilir.

Yayımdan çıxarma

Fasilə — plaginı müvəqqəti gizlət: o, ictimai kataloqdan və nümunələrdən çıxar (növbəti sinxronizasiyada), amma saxlanılır və ola bilər təkrar nəşr edilmiş hər zaman.
Siyahıdan çıxarmaq — plagini bazardan tamamilə çıxarın.

Bir plaginin yayımlanması dayandırıldığı anda (pauzaya qoyulduqda və ya siyahıdan çıxarıldıqda), onun girişi silinir community-catalog.json, və nümunələr növbəti sinxronizasiya zamanı onu göstərməyi dayandırır.

Müəlliflik

Bir plugin yayımlanır sizin göstərilən adınız (məsələn, studiyanızın adı) — və ya anonim. İctimai kataloq və instansiya Veb İstifadəçi İntefeysi seçilmiş adı və ya “Anonim”i göstərir; sizin real e-poçtunuz/ID-niz heç vaxt açıqlanmır.

Tərtibatçı statistikası

Hər bir pluginin ümumi statistika: yükləmələr, quraşdırmalar, aktiv nümunələr və silmələr, həmçinin gündəlik qrafik. Yalnız ümumi göstəricilər — hər nümunəyə aid məlumat developerə açıqlanmır.

Nəşr mükafatı

üçün hər bir plagini ilk dəfə yayımladığınız zaman, sizin AiHummer abunəliyiniz əldə edir bir ay pulsuz (plugin başına bir dəfə verilir).

Növbəti haradır

Şəxsi kabinet vasitəsilə göndər — tam addım-addım: metadatalar, qabiliyyət manifesti, süni intellektin nəzərdən keçirilməsi və moderasiya.
Plugin SDK — manifest sahələri və aihummer plugin əmrləri.
Quraşdırma və yeniləmələr — çoxmənbəli, etibar modeli, imzalanmış yeniləmələr, sıralama.
Siyasəti və yoxlama siyahısını nəzərdən keçirin — meyar a plugin nəşrdən əvvəl yoxlanılır.
Bazar yeri: ümumi baxış və səviyyələr — rəsmi vs icma qeydiyyatı.