Plagini şəxsi kabinet vasitəsilə təqdim edin

Community-marketplace istənilən qeydiyyatdan keçmiş müştəriyə plagini hamının quraşdıra bilməsi üçün nəşr etmək imkanı verir — eynilə tətbiqi app store-a nəşr etdiyiniz kimi. Siz mağaza səhifəsinin metadatasını doldurur, plagininizə hansı icazələrin lazım olduğunu bəyan edir, build-i yükləyir və onu yoxlamaya göndərirsiniz. Bu səhifə bütün prosesi addım-addım izah edir.

[!NOTE] Bu axın community (üçüncü tərəf) plaginləri üçündür və my.aihummer.ru ünvanındakı şəxsi kabinetiniz vasitəsilə təqdim olunur. AiHummer-in öz birinci tərəf plaginləri öz konveyeri ilə gəlir. Community-plaginlər pulsuzdur; istəyə bağlı ianə linki əlavə edə bilərsiniz.

Başlamazdan əvvəl

Qeydiyyatdan keçmiş şəxsi kabinet hesabı — qeydiyyatdan keçin və onu təsdiqləyin (baxın: Qeydiyyat). İstənilən müştəri təqdim edə bilər.
Hazır plagin — Plagin SDK ilə (aihummer plugin package) yaradılmış imzalanmış release tarball-ı. Əgər hələ birini qurmamısınızsa, əvvəlcə oradan başlayın.
İkon və ən azı bir skrinşot, həmçinin rus və ingilis dillərinin hər ikisində hazır təsvirlər.

Nəşr necə işləyir (ümumi mənzərə)

Təqdimatınız sabit bir konveyerdən keçir. Hər addımda onun statusunu kabinetdə izləyə bilərsiniz.

Mərhələ	Nə baş verir	Kim hərəkət edir
Qaralama	Yazını yaradır və metadatanı doldurursunuz; hələ heç nə ictimai deyil.	Siz
Göndərilib	Onu yoxlamaya göndərirsiniz.	Siz
AI yoxlaması	Avtomatik agent plagini yoxlama siyasətinə görə yoxlayır — təhlükəsizlik, manifest düzgünlüyü, tamlıq, kontent.	Avtomatika
Moderasiya	İnsan moderator AI hesabatını, həmçinin artefaktınızı və metadatanızı oxuyub qərar verir.	AiHummer komandası
Nəşr edilib	Təsdiqdən sonra artefakt imzalanır və community-kataloqa + ictimai marketplace lentinə əlavə olunur.	AiHummer komandası
Rədd edilib	Nəsə keçmirsə, səbəbləri alırsınız; düzəldib yenidən göndərirsiniz.	Siz → yenidən Qaralamaya

[!IMPORTANT] AI heç vaxt öz-özünə nəşr etmir. Yekun qərarı həmişə insan verir və onun təsdiqi olmadan heç nə kataloqa çatmır.

Addım 1 — «Plaginlərim»i açın

my.aihummer.ru-a daxil olun, «Plaginlərim» bölməsini açın və «Nəşr et» (və ya «Yeni plagin») düyməsinə basın. Bu, onu yoxlamaya göndərənə qədər sərbəst redaktə edə biləcəyiniz bir qaralama yaradır.

Addım 2 — Mağaza metadatasını doldurun

Hər sahəni doldurun. Natamam metadata təqdimatın geri qaytarılmasının ən çox yayılmış səbəblərindən biridir.

Sahə	Nə daxil edilir
Ad (RU + EN)	Plaginin hər iki dildə göstərilən adı.
Qısa təsvir (RU + EN)	Kataloq kartı üçün bir sətir.
Tam təsvir (RU + EN)	Plaginin nə etdiyi, ondan necə istifadə olunduğu, ona nəyin lazım olduğu. Mənalı olsun — doldurucu (placeholder) deyil.
Kateqoriya	İcazə verilən dəstdən birini seçin (məsələn: Kanallar, Məhsuldarlıq, İnteqrasiyalar, Səs, Utilitlər).
Versiya	semver sətri, məs. `1.0.0`. Hər yeni təqdimat onu artırmalıdır.
İkon	Etibarlı kvadrat şəkil.
Skrinşotlar	Ən azı bir; plagini iş prosesində göstərən.
Lisenziya	Plaginin lisenziyası (məs. MIT, Apache-2.0).
Sayt / repozitoriya	İstəyə bağlı `https://` linki layihənizə.
İanə linki	İstəyə bağlı. Tanınmış ianə hostuna — məsələn Boosty, Patreon, PayPal və ya YooMoney — aparan etibarlı `https://` linki. Fişinq və ya ixtiyari hostlar rədd edilir.
Changelog (RU + EN)	Bu versiyada nəyin dəyişdiyi.

[!TIP] Təsvirləri plagininizi heç görməmiş real istifadəçi üçün yazın. «Yeni başlayanlar üçün» tərz — məhz lazım olan budur: nə etdiyini, nə vaxt tətbiq edildiyini və ona nəyin lazım olduğunu deyin.

Addım 3 — Capability-manifesti bəyan edin

Capability-manifest təhlükəsizlik modelinin qəlbidir. Bu, plagininizə lazım olan hər bir icazənin qısa, strukturlu bəyanıdır — hansı hostlarla danışdığı, hansı fayllara toxunduğu, xarici əmrlər işlədib-işlətmədiyi, hansı kanallardan və etibarnamələrdən istifadə etdiyi.

Nəyə görə bəyan edilir

İstifadəçilər tələb olunan icazələri quraşdırmadan əvvəl görür və onlara razılıq verir — eynilə mobil tətbiqin icazə sorğusu kimi.
İnstance manifestdən istifadə edərək plagini bəyan etdiyi çərçivəyə məhdudlaşdırır.
Yoxlayıcılar bəyan edilmiş qabiliyyətlərin kodun əslində etdiyi ilə uyğunlaşdığını yoxlayır. Bəyan etmədiyi bir icazəyə uzanan plagin rədd edilir.

Minimal imtiyaz prinsipi

Yalnız plagininizin həqiqətən istifadə etdiyini bəyan edin, artığını yox. Daha az icazə — daha sürətli yoxlama, istifadəçi razılığının daha asan olması və daha çox quraşdırma deməkdir. Fayl sistemə toxunmursunuzsa, boş siyahı bəyan edin. Heç vaxt proses işə salmırsınızsa, exec-i false təyin edin.

Format

Capability-manifest bu sahələri olan JSON obyektidir:

Sahə	Tip	Mənası
`network`	string[]	Plaginin qoşulduğu host adları (onun çıxış allowlist-i).
`filesystem`	string[]	Öz plagin qovluğuna nisbətən oxuduğu və ya yazdığı yollar.
`exec`	boolean	Xarici prosesləri / əmrləri işə salıb-salmadığı.
`channels`	string[]	İnteqrasiya etdiyi mesajlaşma kanalları (məs. `telegram`).
`credentials`	string[]	İstifadə etdiyi adlandırılmış secret/konfiqurasiya açarları (heç vaxt secret-in dəyərləri deyil).
`description`	string	Ona nəyin və nə üçün lazım olduğunun qısa, insan tərəfindən oxunan xülasəsi.

Nümunə:

{
  "network": ["api.example.com", "cdn.example.com"],
  "filesystem": ["./cache"],
  "exec": false,
  "channels": ["telegram"],
  "credentials": ["api_token"],
  "description": "Calls the Example API to sync tasks and posts replies to Telegram. Caches responses under its own ./cache directory. No process spawning, no other hosts."
}

[!WARNING] Real secret-ləri, tokenləri və ya açarları heç bir yerə qoymayın — nə manifestə, nə metadataya, nə də artefakta. Etibarnamələri yalnız adına görə bəyan edin (məs. api_token); real dəyəri müştəri quraşdırma zamanı verir. Koda sərt yazılmış (hardcoded) secret-lər avtomatik rəddə səbəb olur.

Addım 4 — Artefaktı yükləyin

Plaginin build-ini yükləyin:

Format: aihummer plugin package tərəfindən yaradılan .tar.gz release tarball-ı.
O, plaginin manifest.json-unu (SDK manifesti — növ, versiya, giriş nöqtəsi, bəyan edilmiş capabilities, konfiqurasiya sahələri) ehtiva etməlidir.
Addım 3-də doldurduğunuz capability-manifest kodun və manifest.json-un əslində etdiyi ilə uyğun olmalıdır.

Əgər hələ etməmisinizsə, ikon və skrinşotları da burada əlavə edirsiniz.

[!TIP] Yükləmədən əvvəl lokal olaraq aihummer plugin validate işə salın. Yoxlama müqaviləsi marketplace-in istifadə etdiyi ilə eynidir, ona görə də lokal olaraq keçən manifest burada da qəbul ediləcək.

Addım 5 — Yoxlamaya göndərin

Bütün sahələr dolduqda və artefakt yükləndikdə «Yoxlamaya göndər» düyməsinə basın. Kabinet əvvəlcə tamlıq yoxlaması aparır; nəsə çatmırsa, dəqiq nəyin çatmadığını deyir. Qəbul edildikdən sonra status Göndərilib, sonra isə AI yoxlaması vəziyyətinə keçir — başqa heç nə etməyə ehtiyac yoxdur.

Addım 6 — Statusu izləyin və hökmü oxuyun

Statusu izləmək üçün plagini **«Plaginlərim»**də açın. Yoxlama bitdikdə aşağıdakılardan birini görəcəksiniz:

Moderasiyada — avtomatik yoxlama keçdi və ya yalnız kiçik məsələləri qeyd etdi; indi ona insan baxır. Sadəcə gözləyin.
Rədd edilib — nəsə keçmədi. Bir hökm, xülasə və keçməyən konkret bəndləri (hər biri üçün səbəbi ilə) görəcəksiniz. Bu, sizin düzəliş siyahınızdır.
Nəşr edilib — təsdiqləndi, imzalandı və canlıdır. Plagininiz indi AiHummer marketplace-də görünür və community-kataloqu aktiv olan istənilən instance-ə quraşdırılır.

Rəddi necə oxumalı və yenidən göndərməli

Plagini açın; keçməyən bəndləri və onların səbəblərini oxuyun.
Onları düzəldin — əksəri bunlardan biridir: çatmayan/zəif təsvir, uyğunsuz capability-manifest, hardcoded secret, pis ianə linki və ya artırmadığınız versiya.
Metadatanı redaktə edin və/və ya artırılmış versiyalı yeni artefakt yükləyin.
Yenidən «Yoxlamaya göndər» düyməsinə basın. O, eyni konveyerdən yenidən keçir.

[!NOTE] Rədd cəza deyil — bir çeklistdir. Yoxlama siyasəti məhz ona görə ictimaidir ki, siz təqdim etməzdən əvvəl hər tələbi ödəyə biləsiniz.

Sonra haraya

Yoxlama siyasəti və çeklist — plagininizin yoxlandığı dəqiq meyarlar.
Plagin SDK — plagini və onun manifest.json-unu qurun.
Plagin nəşri — şəxsi yan yükləmə və digər nəşr rejimləri.
Quraşdırma və yeniləmələr — müştərilərin necə quraşdırdığı və etibar modelinin necə işlədiyi.