Plaginni shaxsiy kabinet orqali yuborish
Community-marketplace har qanday ro‘yxatdan o‘tgan foydalanuvchiga o‘z plaginini hamma o‘rnata olishi uchun nashr qilish imkonini beradi — xuddi ilovani ilovalar do‘koniga joylagandek. Siz do‘kon kartochkasi metama’lumotlarini to‘ldirasiz, plaginingizga qanday ruxsatlar kerakligini e’lon qilasiz, buildni yuklaysiz va uni ko‘rikka yuborasiz. Ushbu sahifa butun jarayonni bosqichma-bosqich ko‘rsatib beradi.
[!NOTE] Bu oqim my.aihummer.ru dagi shaxsiy kabinetingiz orqali yuboriladigan community (uchinchi tomon) plaginlari uchun. AiHummer’ning o‘z birinchi tomon plaginlari o‘zining alohida quvurida chiqadi. Community-plaginlar bepul; ixtiyoriy donat havolasini qo‘shishingiz mumkin.
Boshlashdan oldin
- Ro‘yxatdan o‘tgan shaxsiy kabinet hisobi — ro‘yxatdan o‘ting va uni tasdiqlang (qarang Ro‘yxatdan o‘tish). Plaginni har qanday foydalanuvchi yuborishi mumkin.
- Yig‘ilgan plagin — Plagin SDK yordamida
(
aihummer plugin package) tayyorlangan imzolangan relizli tarball. Agar hali yig‘magan bo‘lsangiz, avval o‘shandan boshlang. - Ikonka va kamida bitta skrinshot, hamda rus va ingliz tillarida tayyor tavsiflaringiz.
Nashr qanday ishlaydi (umumiy manzara)
Arizangiz qat’iy belgilangan quvurdan o‘tadi. Har bir bosqichda uning holatini kabinetda kuzatib borishingiz mumkin.
| Bosqich | Nima sodir bo‘ladi | Kim harakat qiladi |
|---|---|---|
| Qoralama | Siz yozuvni yaratasiz va metama’lumotlarni to‘ldirasiz; hali hech narsa ommaviy emas. | Siz |
| Yuborilgan | Siz uni ko‘rikka yuborasiz. | Siz |
| AI ko‘rik | Avtomatik agent plaginni ko‘rik siyosati bo‘yicha tekshiradi — xavfsizlik, manifest to‘g‘riligi, to‘liqlik, kontent. | Avtomatika |
| Moderatsiya | Inson-moderator AI hisobotini hamda artefakt va metama’lumotlaringizni o‘qib chiqadi va qaror qabul qiladi. | AiHummer jamoasi |
| Nashr etilgan | Tasdiqlangach artefakt imzolanadi va community-katalogga hamda ommaviy marketplace lentasiga qo‘shiladi. | AiHummer jamoasi |
| Rad etilgan | Agar biror narsa o‘tmasa, sizga sabablari beriladi; tuzatib qayta yuborasiz. | Siz → yana qoralamaga |
[!IMPORTANT] AI hech qachon o‘zi mustaqil nashr qilmaydi. Yakuniy qarorni har doim inson qabul qiladi va uning tasdig‘isiz hech narsa katalogga tushmaydi.
1-qadam — «Mening plaginlarim»ni oching
my.aihummer.ru ga kiring, «Mening plaginlarim» bo‘limini oching va «Nashr qilish» (yoki «Yangi plagin») tugmasini bosing. Shunday qilib qoralama yaratiladi, uni ko‘rikka yuborguningizcha bemalol tahrirlashingiz mumkin.
2-qadam — Store metama’lumotlarini to‘ldiring
Har bir maydonni to‘ldiring. To‘liqsiz metama’lumotlar — ariza qaytarilishining eng ko‘p tarqalgan sabablaridan biri.
| Maydon | Nima kiritiladi |
|---|---|
| Nomi (RU + EN) | Plaginning ikki tildagi ko‘rsatiladigan nomi. |
| Qisqa tavsif (RU + EN) | Katalog kartochkasi uchun bir qator. |
| To‘liq tavsif (RU + EN) | Plagin nima qiladi, undan qanday foydalaniladi, unga nima kerak. Mazmunli — zaglushka emas. |
| Kategoriya | Ruxsat etilgan to‘plamdan bittasini tanlang (masalan: Kanallar, Samaradorlik, Integratsiyalar, Ovoz, Utilitalar). |
| Versiya | semver formatidagi qator, masalan 1.0.0. Har bir yangi ariza uni oshirishi shart. |
| Ikonka | To‘g‘ri kvadrat tasvir. |
| Skrinshotlar | Kamida bitta; plaginni ish jarayonida ko‘rsatuvchi. |
| Litsenziya | Plagin litsenziyasi (masalan MIT, Apache-2.0). |
| Sayt / repozitoriy | Loyihangizga ixtiyoriy https:// havola. |
| Donat havolasi | Ixtiyoriy. Taniqli donat-xostga to‘g‘ri https:// havola — masalan Boosty, Patreon, PayPal yoki YooMoney. Fishing yoki ixtiyoriy xostlar rad etiladi. |
| Changelog (RU + EN) | Ushbu versiyada nima o‘zgargani. |
[!TIP] Tavsiflarni plaginingizni hech qachon ko‘rmagan real foydalanuvchi uchun yozing. «Eng oddiy tilda» — aynan shu kerak: u nima qilishini, qachon ishlatilishini va unga nima kerakligini ayting.
3-qadam — Capability-manifestni e’lon qiling
Capability-manifest — xavfsizlik modelining yuragi. Bu plaginingizga kerak bo‘lgan har bir ruxsatning qisqa, tuzilgan e’lonidir — u qaysi xostlar bilan gaplashadi, qaysi fayllarga tegadi, tashqi buyruqlar ishga tushiradimi, qaysi kanallar va hisob ma’lumotlaridan foydalanadi.
Nima uchun e’lon qilinadi
- Foydalanuvchilar so‘ralayotgan ruxsatlarni o‘rnatishdan oldin ko‘radi va ularga rozilik bildiradi — xuddi mobil ilovadagi ruxsat so‘rovi kabi.
- Instans manifestdan foydalanib plaginni u e’lon qilgan narsa bilan cheklaydi.
- Ko‘rik o‘tkazuvchilar e’lon qilingan imkoniyatlar kod aslida qiladigan narsaga mos kelishini tekshiradi. E’lon qilmagan ruxsatga cho‘zilgan plagin rad etiladi.
Minimal imtiyoz tamoyili
Plaginingiz haqiqatan foydalanadigan faqat shu narsani e’lon qiling, undan
ortiqchasini emas. Ruxsat kamroq bo‘lsa — ko‘rik tezroq, foydalanuvchi roziligi
osonroq va o‘rnatishlar ko‘proq bo‘ladi. Agar fayl tizimiga tegmasangiz — bo‘sh
ro‘yxat e’lon qiling. Agar hech qachon jarayon ishga tushirmasangiz — execni
false qiling.
Format
Capability-manifest — quyidagi maydonlarga ega JSON obyekt:
| Maydon | Tur | Ma’nosi |
|---|---|---|
network |
string[] | Plagin ulanadigan xost nomlari (uning chiquvchi so‘rovlar ruxsat ro‘yxati). |
filesystem |
string[] | U o‘qiydigan yoki yozadigan yo‘llar, o‘z plagin katalogiga nisbatan. |
exec |
boolean | U tashqi jarayonlar ishga tushiradimi / buyruqlar bajaradimi. |
channels |
string[] | U integratsiyalashadigan xabar kanallari (masalan telegram). |
credentials |
string[] | U foydalanadigan nomlangan sirlar/konfiguratsiya kalitlari (hech qachon sir qiymatlari emas). |
description |
string | Unga nima va nima uchun kerakligining qisqa, insonlar o‘qiy oladigan xulosasi. |
Misol:
{
"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 sirlar, tokenlar yoki kalitlarni hech qayerga qo‘ymang — na manifestga, na metama’lumotlarga, na artefaktga. Hisob ma’lumotlarini faqat nomi bo‘yicha e’lon qiling (masalan
api_token); haqiqiy qiymatni foydalanuvchi o‘rnatish paytida kiritadi. Qotirib qo‘yilgan (hardcoded) sirlar — avtomatik rad etish.
4-qadam — Artefaktni yuklang
Plagin buildingizni yuklang:
- Format:
aihummer plugin packagetomonidan tayyorlangan.tar.gzrelizli tarball. - U plaginning
manifest.json’ini o‘z ichiga olishi kerak (SDK manifesti — tur, versiya, kirish nuqtasi, e’lon qilingancapabilities, konfiguratsiya maydonlari). - 3-qadamda to‘ldirgan capability-manifest kod va
manifest.jsonaslida qiladigan narsaga mos bo‘lishi shart.
Agar hali qilmagan bo‘lsangiz, ikonka va skrinshotlarni ham shu yerda biriktirasiz.
[!TIP] Yuklashdan oldin
aihummer plugin validateni lokal ishga tushiring. Tekshiruv shartnomasi marketplace ishlatadigani bilan aynan bir xil, shuning uchun lokal o‘tgan manifest bu yerda ham qabul qilinadi.
5-qadam — Ko‘rikka yuboring
Har bir maydon to‘ldirilib, artefakt yuklangach, «Ko‘rikka yuborish» tugmasini bosing. Kabinet avval to‘liqlikni tekshiradi; agar biror narsa yetishmasa, aynan nima yetishmayotganini aytadi. Qabul qilingach, holat Yuborilganga, so‘ng AI ko‘rikka o‘tadi — boshqa hech narsa qilishingiz shart emas.
6-qadam — Holatni kuzating va hukmni o‘qing
Holatini kuzatib borish uchun plaginni **«Mening plaginlarim»**da oching. Ko‘rik tugagach, quyidagilardan birini ko‘rasiz:
- Moderatsiyada — avtomatik ko‘rik o‘tdi yoki faqat mayda-chuydalarni belgiladi; endi uni inson ko‘rmoqda. Shunchaki kuting.
- Rad etilgan — biror narsa o‘tmadi. Siz hukm, qisqa xulosa va o‘tmagan aniq bandlarni (har biri uchun sabab bilan) ko‘rasiz. Bu — sizning tuzatishlar ro‘yxatingiz.
- Nashr etilgan — tasdiqlangan, imzolangan va ishga tushirilgan. Endi plaginingiz AiHummer marketplace’da paydo bo‘ladi va community-katalog yoqilgan har qanday instansga o‘rnatiladi.
Rad etishni qanday o‘qish va qayta yuborish
- Plaginni oching; o‘tmagan bandlarni va ularning sabablarini o‘qing.
- Ularni tuzating — ko‘pincha bu quyidagilardan biri bo‘ladi: yetishmaydigan/zaif tavsif, mos kelmagan capability-manifest, qotirib qo‘yilgan sir, yomon donat havolasi yoki oshirilmagan versiya.
- Metama’lumotlarni tahrirlang va/yoki versiyasi oshirilgan yangi artefaktni yuklang.
- Yana **«Ko‘rikka yuborish»**ni bosing. Ariza xuddi shu quvurdan qaytadan o‘tadi.
[!NOTE] Rad etish — jazo emas, u chek-list. Ko‘rik siyosati aynan shuning uchun ochiq — siz barcha talablarni yuborishdan oldin bajara olishingiz uchun.
Keyin qayerga
- Ko‘rik siyosati va chek-list — plaginingiz qaysi aniq mezonlar bo‘yicha tekshirilishi.
- Plagin SDK — plaginni va uning
manifest.json’ini qurish. - Plaginni nashr qilish — maxfiy side-load va boshqa nashr rejimlari.
- O‘rnatish va yangilanishlar — foydalanuvchilar qanday o‘rnatishi va ishonch modeli qanday ishlashi.