Pluginni nashr qilish — AiHummer Hujjatlar

Bilan plugin yaratildi Plagin SDK? Siz buni nashr qilishingiz mumkin ikki yo‘l:

Shaxsiy (o’zingiz uchun) — o‘z instantsiyangizga tomon yuklash. Artefakt hech qachon uni qoldiradi.
Jamiyat (hamma uchun) — orqali nashr eting shaxsiy kabinet da my.aihummer.ru, ilova-do‘koni uslub: qurilmani yuklash, do‘kon sahifasini to‘ldirish, ko‘rib chiqishni o‘tish va u joylashadi har bir nusxa o’rnatishi mumkin bo’lgan imzolangan jamoa katalogi.

Analogiya: o’rnatish .vsix qo‘l bilan (shaxsiy) vs ilova do‘koniga nashr qilish (jamoa).

[!WARNING] Hamjamiyat plaginlarini hozir o’rnatib bo’lmaydi — bu aloqa nosozligi emas. Hamjamiyat katalogini imzolagan kalit bekor qilindi; yangi kalit chiqqunga qadar imzo tekshiruvi bunday yozuvlarni rad etadi. Bundan tashqari, uchinchi tomon kodi hozircha serveringizda xizmat sifatida ishga tushirilmaydi: izolyatsiyalangan ishga tushirish muhiti paydo bo’lguncha faqat o’z tomonida ishlaydigan va tarmoq orqali ulanadigan integratsiyalarga ruxsat beriladi.

Nimani ko’rasiz: «o’rnatish» tugmasidan keyin odatdagi «o’rnatilmoqda» xabari chiqadi, lekin plagin o’rnatilganlar ro’yxatida hech qachon ko’rinmaydi. Rad etish sababi shlyuz jurnaliga yoziladi — boshqaruv panelida Jurnallar bo’limini oching.

Bugun nima ishlaydi:

rasmiy katalogdagi AiHummer plaginlari — odatdagidek o’rnatiladi, ularda boshqa, amaldagi imzo bor;

HTTP orqali MCP server — dasturlashsiz vositalar manbai sifatida ulanadi, kod sizning tomoningizda qoladi;

OpenAPI spetsifikatsiyasi bo’yicha integratsiya — xuddi shu, xizmat o’rnatmasdan.

O’z plaginingizni qo’lda yuklash imzo tekshiruvidan o’tadi, lekin faqat HTTP orqali masofaviy MCP yoki OpenAPI integratsiyasi sifatida ishlaydi; shu serverda xizmat sifatida ishga tushirilishi kerak bo’lgan yig’ma rad etiladi.

Shaxsiy rejim — o‘z instantsiyangizga yon yuklash

Buni faqat siz pluginni talab qilganingizda ishlating: ichki ulanish, maxsus integratsiya, test qurilishi.

Qadamlar

Paketni tayyorlang va to‘plamni imzolang:

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

Buni ikkita usuldan biri bilan instansiyaga yuklang:
- Admin UI → Plaginlar → “Plaginni yuklash” — paketni sudrab olib boring; yoki
- CLI:
```
aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz
```
Qopqoq ostida bu POST /v1/admin/modules/upload (ko‘p qismli, integrations:write): artefakt yerga tushadi namuna blob do’koni (AIHUMMER_BLOB_DIR) ostida blob: ref, va katalog qatori bilan ro‘yxatga olingan origin = local-private, visibility = private.
Plagin bozor joyida yorliq bilan paydo bo’ladi Shaxsiy va orqali o’rnatadi oddiy yo’l — sandbokslangan systemd birlik + sog‘liq eshigi.

Ishonch: o‘rnatilgan kalit va ishonch do‘koni

Shaxsiy buyumlar imzolanishi kerak. Siz noma’lum kalit bilan imzolangan plaginni yuklaganingizda, Admin UI sizga quyidagilarni ko‘rsatadi muallifning kalitini tasdiqlash veb-sayt ishonch do’koniga (bir marta bosish) qo’shiladi. Tasdiqlangach, imzo har bir o’rnatish va yangilashda tekshiriladi.

dan arxeologik topilmalar rasmiy manbani shunga qarshi tekshiring ro‘yxat kaliti pinlangan yadroda — sukut bo‘yicha ishonchli, qo‘shimcha qadam yo‘q.
Shaxsiy artefaktlar instansiya ishonch do‘konidagi kalitlarga nisbatan tekshiriladi.
Imzosiz paketlar rad etiladi — faqat mahalliy iteratsiya uchun dev rejimida bundan mustasno: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 imzo tekshiruvini o‘chiradi va mo‘ljallangan faqat mahalliy rivojlanish uchun. Hech qachon uni tashqi kirish mumkin bo‘lgan instansiyada yoqmang.

Jamoa rejimi — shaxsiy kabinet orqali nashr qilish

Plaginni mavjud qilish uchun har masalan, uni o’zingizdan nashr qiling shaxsiy kabinet da my.aihummer.ru, ilovani ilova do‘koniga nashr qilish usuli bilan bir xil. Siz buildni yuklaysiz, do‘kon sahifasini to‘ldirasiz va uni ko‘rib chiqishga yuborasiz; avvalo avtomatlashtirilgan AI tekshiruvi o‘tkaziladi, so‘ngra inson moderator yakuniy qarorni qabul qiladi, va tasdiqlangandan so‘ng artefakt imzolangan holda hamjamiyat katalogiga nashr etiladi.

To‘liq, bosqichma-bosqich qo‘llanma mavjud Plagin yuborish. Qisqasi:

Qurish va paketlash sizning SDK bilan plagin (aihummer plugin package) — bu artefakt imzolangan .tar.gz uni olib yurish manifest.json.
«Mening plaginlarim»ni oching shkafda va taqdimot yaratish: yuklash artefakt, to‘ldiring ma’lumotlar metamasini saqlash (ism va tavsiflar RU + EN da, versiya, ikonka, ekran tasvirlari, toifa, ixtiyoriy xayriya havolasi, o‘zgartirishlar jurnal) va e’lon qil qobiliyat namoyonoti.
Ko‘rib chiqish uchun yuboring. Avtomatlashtirilgan AI ko’rib chiqish topshirilmani tekshiradi bu sharh siyosati (xavfsizlik, manifest) toʻgʻrilik, toʻliqlik, mazmun), soʻngra bir inson moderatori hisobotni o’qiydi va qaror qiladi. Avtomatlashtirish hech qachon o’zi chop etmaydi.
Tasdiqlanganda artefakt imzolangan va chop etildi ajratish community-catalog.json CDN-da. Har bir nusxa qo‘shilgan jamoa manbasi plaginini ko’radi; yadrosi uni orqali ishonadi tirkalgan ro‘yxat kaliti — operator bo‘yicha ishonch bosqichi kerak emas.

[!NOTE] Eski ommaviy nashr qilish oqimi nafaqaga chiqarilgan; yuqoridagi shaxsiy kabinet oqimi — «Mening plaginlarim» — endi hamjamiyat nashr qilishning yagona yo‘li. Hamjamiyat plaginlari bepul; siz ixtiyoriy xayriya havolasini qo‘shishingiz mumkin.

[!NOTE] Birinchi tomon plaginlari (Einstein, SIP, Bitrix24, pocket-agent, os-client) quyidagilar: bunday nashr etilmagan — ular o’z AiHummer CI pipeline orqali yuklanadi va keladi tirkalgan rasmiy katalog. Shaxsiy kabinet oqimi uchun jamiyat (uchinchi tomon) plaginlar.

O‘rta yo‘l

Har bir jamoa taqdimoti orqali o‘tadi avtomatlashtirilgan tekshiruv (to‘liqlik, imkoniyatlar manifesti, imzo va xavfsizlik skaneri), keyin esa bir AI xavfi sharhi, va nihoyat bir majburiy insoniy tekshiruv AiHummer jamoasi tomonidan. Na avtomatlashtirish, na AI o’z-o’zidan hech qachon nashr qilmaydi — qaror har doim moderatornikidir va ularning tasdig’isiz hech narsa katalogga yetib bormaydi. Keyinchalik zararli yoki buzilgan deb topilgan nashr qilingan plagin boʻlishi mumkin bekor qilindi va keyingi sinxronizatsiyada katalogdan o‘chirildi.

Qo‘shimcha manba sifatida jamoat katalogi

Jamoa plaginlari quyidagiga nashr etiladi ajratish community-catalog.json shuni qiladi emas tanlangan birinchi tomon katalogini ustiga yozib qo’ying. Biror bir holat uni qo’shimcha manba sifatida qo’shadi Plaginlar → Manbalar (yoki POST /v1/admin/modules/catalog/sources). Ko’ring O’rnatish va yangilanishlar va Ko’rib chiqish va darajalar.

Plagin umr bo‘yi (App Store)

Bozor haqiqiy App Store kabi ishlaydi — har bir plagin o’ziga xos bo‘ladi shaxsiyat (doimiy slug + muallif) ostida jo‘natiladi versiyalar.

Versiyalar va yangilanishlar

Yangilanish sifatida yetkaziladi yangi versiya allaqachon nashr etilgan plagin: bir xil slug, o‘zining o‘zgartirish jurnalini, o‘zining sharh va moderatsiyasini. Faqat bir versiya bir vaqtning o‘zida ko‘rib chiqilayotgan bo‘lishi mumkin — siz keyingisini faqat joriy nusxa qaror qabul qilinishidan so‘ng yuborasiz. Yangi versiya nashr etilganda, oldingi versiya belgilangan bo‘ladi superseded, va katalog + har bir holatni yangi versiyaga ko‘chiring.

Rejalashtirilgan nashr

Moderator uni tasdiqlagandan keyin, muallif chiqarishni nazorat qiladi: hoziroq nashr qilish yoki ma’lum bir vaqtgacha rejalashtirish — plagin belgilangan vaqtda jonli bo’ladi.

Nashrni bekor qilish

Tanaffus — plaginini vaqtincha yashirish: u jamoat katalogidan va instansiyalardan chiqadi (keyingi sinxronizatsiyada), lekin saqlanib qoladi va bo‘lishi mumkin qayta nashr etilgan har qanday vaqtda.
Ro’yxatdan chiqarish — plaginni bozordanoq butunlay olib tashlang.

Plugin nashrdan chiqarilgan (to‘xtatilgan yoki ro‘yxatdan o‘chirlangan) zahoti, uning kiriti o‘chirib tashlanadi community-catalog.json, va keyingi sinxronizatsiyada uni ko‘rsatishni to‘xtatadi.

Mualliflik

Plagin quyidagi shartlar asosida nashr etilgan sizning ko’rsatish nomingiz (masalan, studiyangizning nomi) — yoki nomushtirilgan holda. Jamoat katalogi va instance Web UI tanlangan nomni yoki “Anonymous” ni ko‘rsatadi; sizning haqiqiy elektron pochta manzilingiz/id hech qachon oshkor qilinmaydi.

Dasturchi statistikalari

Har bir plaginning bor jami statistika: yuklamalar, o’rnatishlar, faol nusxalar va o’chirishlar, shuningdek kunlik grafik. Faqat umumiy raqamlar — har bir nusxaga oid ma’lumot ishlab chiquvchiga oshkor qilinmaydi.

Nashr mukofoti

uchun siz birinchi marta nashr qilayotgan har bir plagin, sizning AiHummer obunangiz oladi bir oy bepul (har bir plagin uchun bir marta beriladi).

Keyin qayerga

Shaxsiy kabinet orqali yuboring — to‘liq bosqichma-bosqich: metadata, imkoniyat manifesti, AI ko‘rib chiqishi va moderatsiya.
Plagin SDK — manifest maydonlari va `aihummer plugin buyruqlari.
O’rnatish va yangilanishlar — ko’p manbali, ishonch modeli, imzolangan yangilanishlar, reyting.
Siyosat va tekshiruv ro’yxatini ko’rib chiqish — mezonlar a plagin nashr qilinishidan oldin tekshiriladi.
Marketplace: umumiy ko‘rinish va darajalar — rasmiy vs jamoatchilik registri.