Маркетплейс жана плагиндер/Плагинди жеке кабинети аркылуу жөнөтүңүз
Плагинди жеке кабинети аркылуу жөнөтүңүз
v1.2.x · жаңыланды 2026-07-19
Бул коомдук базар кайсы бир катталган кардарга плагинди бардыгы орното ала турган кылып жарыялоого мүмкүн — сиз колдонмону колдонмо дүкөнүнө жарыялагандай эле. Сиз дүкөн барагынын метадатасын толтурасыз, плагиниңизге кандай уруксаттар керектигин жарыялайсыз, курулушту жүктөйсүз жана текшерүүгө жөнөтөсүз. Бул бет бүт процессти кадам сайын көрсөтөт.
[!NOTE]
Бул агым үчүн коомчулук (үчүнчү тарап) сиз аркылуу тапшырылган плагиндер
жеке кабинет жана my.aihummer.ru. Биринчи тарап
AiHummer плагиндер өз алдынча түтүкчөсүндө келет. Коомчулук плагиндер эркин; сен
кошумча ынаным каттоо шилтемесин кошуу мүмкүн.
Баштаардан мурун
A катталган жеке кабинет аккаунту — каттоодон өтүп, аны тастыктаңыз (караңыз
Каттоо). Ар кандай кардар жибериши мүмкүн.
A курулган плагин — кол менен кол коюлган чыгарууга даярдалган архив
Плагин SDK (aihummer plugin package). Эгерде сизде
азырынча курулган жок, анын менен биринчи башта.
Бир иконка жана кеминде бир скриншот, жана сиздин сүрөттөмөлөрүңүз даяр экиси
Орус жана Англис.
Жарыялоо кантип иштейт (чоң сүрөт)
Сиздин тапшырмаңыз белгиленген процесс аркылуу өтөт. Анын абалын ар бир кадамда кабинеттен көрө аласыз.
Сахна
Эмне болот
Ким аракет кылат
Черновик
Сиз кирүүнү түзөсүз жана метадаталарды толтурсаңыз болот; азырынча эч нерсе коомчулукка ачык эмес.
Сен
Жөнөтүлгөн
Сиз аны кароого жибересиз.
Сен
ЖИ карап чыгуу
Автоматташтырылган агент плагинди текшерет саясатты карап чыгуу — коопсуздук, тууралыгын көрсөтүү, толук процесс, мазмун.
Автоматташтыруу
Орточо өлчөм
Адам модератор AI отчетун жана сиздин өнөрүңүздү жана метадатаңызды окуп, чечим чыгарат.
АйХаммер командасы
Жарыяланган
Жаңыдан бекитилгенден кийин, артефакт кол коюлуп, коомчулуктун каталогуна жана коомдук базардын агымына кошулат.
АйХаммер командасы
Баш тартылган
Эгер бир нерсе иштебей калса, себептерин билесиң; оңдоп кайра тапшыруу.
Сиз → черновикке кайтуу
[!IMPORTANT]
ЖИ эч качан өзү жарыялайт. Адам ар дайым акыркы чечимди кабыл алат,
жана эч нерсе алардын макулдугусуз каталогго жетпейт.
Кадам 1 — «Менин плагиндеримди» ачыңыз
Кирүү my.aihummer.ru, ач «Менин плагиндерим» бөлүм, жана чыкылдатыңыз «Жариялоо» (же «Жаңы плагин»). Бул түзөт черновик Сиз аны тапшырууга чейин эркин түзөтө аласыз.
2‑кадам — Дүкөндүн метадеректерин толтуруңуз
Ар бир талааны толтуруңуз. Толук эмес метадата тапшыруунун кайтарып берилишинин эң кеңири таралган себептеринин бири болуп эсептелет.
Дала
Эмне киргизүү керек
Аты (RU + EN)
Плагиндин көрсөтүүчү аталышы эки тилде.
Кыскача баяндама (RU + EN)
Каталог карточкасы үчүн бир сап.
Толук сүрөттөмө (RU + EN)
Плагин эмне кылат, аны кантип колдону керек, эмне керек. Маанилүү — жок дегенде бос орун эмес.
A semver жол, мисалы 1.0.0. Ар бир жаңы тапшырма аны көбөйтүшү керек.
Иконка
Жарамдуу төрт бурчтук сүрөт.
Скриншоттор
Эң аз дегенде бирөө; плагиндин иштеп жатканын көрсөтүү.
Лицензия
Плагиндин лицензиясы (мисалы, MIT, Apache-2.0).
Башкы бет / репозиторий
Мажбур эмес https:// жобоңузга шилтеме.
Сыйлык берүү шилтемеси
Ишке ашырылышы мүмкүн. Жачыктуу https:// aга шилтеме жакшы таанымал салым берүүчү — мисалга Boosty, Patreon, PayPal же YooMoney. Фишинг же каалаган хосттор четтетилет.
Өзгөрүүлөрдүн журналы (RU + EN)
Бул версияда эмне өзгөрдү.
[!TIP]
Сиздин плагиниңизди эч качан көрбөгөн чыныгы колдонуучу үчүн сүрөттөмөлөрдү жазыңыз. “Үчүн”
“dummies” так туура: эмне кыларын, качан колдонорун, жана эмне керек экенин тийгизип айткыла.
3‑кадам — мүмкүнчүлүктөр манифестин жарыялоо
Бул имкандык манифест коопсуздук моделинин жүрөгү болуп саналат. Бул кыска, структураланган декларация болуп саналат силердин плагиниңизге керек болгон ар бир уруксат — кайсы хосттор менен байланышат, кайсы файлдарга тийишет, тышкы буйруктарды аткаратбы, кайсы каналдар жана күбөлүктөр колдонулат.
Эмне үчүн жарыялап жатасыз?
Кардарлар талап кылынган уруксаттарды көрүшөт алуудан мурун жана макул болуу
аларга, мобилдик тиркеменин уруксат сурамындегидей эле.
Бул учур манифестти колдонушат чектөө плагин өзүнүн жарыялаганына чейин.
Сынчылар сиздин менен текшеришет жариятталган мүмкүнчүлүктөр матч код деген эмне
чынында эле жасайт. Өзү билдирбеген уруксатты сураган плагин
четке кагылды.
Эң аз артыкчылык принциби
Жар сал жалгыз Сиздин плагин чындыгында эмне колдонот жана андан ары эч нерсе жок. Аз уруксаттар тезирээк текшерүү, жеңилирээк кардар макулдугу жана көбүрөөк орнотууларды билдирет. Эгер сиз файл тутумуна тийбесеңиз, бош тизмени белгилеңиз. Эгер эч качан процесс жаратпасаңыз, белгилеңиз exec көрсөтүү false.
Форматы
Күчтүүлүктүн манифести бул талаалар менен JSON объектиси:
Дала
Түрү
Маани
network
жол[]
Плагин туташкан хост аттары (анын чыгуу уруксат тизмеси).
filesystem
жол[]
Ал окуй турган же жазган жолдор, өзүнүн плагин каталогуна салыштырмалуу.
exec
логикалык
Ал тышкы процесстерди жаратабы / буйруктарды аткарат же жокпу.
Аты аталган сырлар/конфигурация ачкычтары, ал колдонгон (сыр баалуулуктар эмес).
description
жол
Эмне керек экенин жана эмнеге керек экенин кыска, адам түшүнө тургандай баян.
Мисал:
{ "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]
Жасау эмес чыга анын чындыгындагы сырларын, белгилерин же ачкычтарын эч жерге салба — манифестте дагы, башка жерде дагы эмес
метадатада, артефактта эмес. Кирүү маалыматтарын жар салуу ат боюнча гана (мисалы,
api_token); кардар орнотууда чыныгы баасын камсыздайт. Туура которулган
сырлар автоматтык жоопкерчиликке жокко чыгаруу болуп саналат.
Бул плагиндин болушу керек manifest.json (SDK манифести — түрү,
версия, кирүү чекити, жарыяланган capabilities, конфигурация талаалары).
Сиз 3‑кадамда толтурган мүмкүнчүлүктөрдүн манифести болушу керек туруктуу кайсы менен
код жана manifest.json чындап эле кылат.
Сен дагы тиркейсиң иконка жана түшүрмөлөр эгер сен буга чейин кылбаган болсоң, бул жерде.
[!TIP]
Жүр aihummer plugin validate жергиликтүү жүктөөдөн мурун. Текшерүү келишими
бул базар колдонгону менен бирдей, ошондуктан жергиликтүү өткөрүлгөн манифест
бул жерде да кабыл алынат.
5-кадам — Кароого жөнөтүү
Ар бир талаа толтурулуп, артефакт жүктөлгөндө, чыкылдатыңыз «Кароо үчүн жүктөө». Кабинет биринчи толуктоо текшерүүсүн жүргүзөт; эгер бир нерсе жок болсо, так кайсы экенин айтып берет. Кабыл алынгандан кийин, абалы Жөнөтүлгөн анан ЖИ карап чыгуу — сен эч нерсе жасоонун кереги жок.
6-кадам — Абалды көзөмөлдөп, чечимди окуу
Плагинди ачыңыз «Менин плагиндерим» анын абалын көзөмөлдөөгө. Кароо бүткөндө сиз төмөнкүдөй нерселердин бирин көрөсүз:
Мезгил-мезгили менен — автоматтык карап чыгуу өттү же болгону майда нерселерди белгиледи; а
адам азыр ага карап жатат. Түшкө чейин күт.
Баш тартылган — бир нерсе ийгиликсиз болду. Сен көрөсүң өкүм, кыскача баяндама, жана
өтпөгөн конкреттүү буюмдар (ар биринин себеби менен). Бул сиздин
түзөтүү-тизмеси.
Жарыяланган — бекитилген, кол коюлган жана түз. Сиздин плагин азыр көрсөтүлөт
AiHummer базары жана кайсы гана болбосун инстанцияга орнотулат
коомдук каталог күйгүзүлгөн.
Баш тартууну кантип окуп, кайра тапшыруу керек
Плагинди ач; оку иштен чыккан буюмдар жана алардын себептери.
Аларды оңдоңуз — көпчүлүгү төмөнкү бири: жетишсиз/күчсүз сүрөттөө, туура келбеген мүмкүнчүлүк
манифест, катырылган сыр, начар донордук шилтеме же сиз колдонбогон версия
өстүрүү.
Метадайындарды түзүңүз жана/же жүктөңүз версиясы жогорулаган жаңы артефакт.
Бас «Кароо үчүн жүктөө» қайра. Ал ошол эле түтүктөн кайра өтөт.
[!NOTE]
Рад болуу жазалоо эмес — бул текшерүү тизмеси.
саясатты карап чыгуу айрыкча сен үчүн коомчулукка ачык
ар бир талапты канааттандыра алат мурда сен баш ийесиң.
Бул **коомдук базар** кайсы бир катталган кардарга плагинди бардыгы орното ала турган кылып жарыялоого мүмкүн — сиз колдонмону колдонмо дүкөнүнө жарыялагандай эле. Сиз дүкөн барагынын метадатасын толтурасыз, плагиниңизге кандай уруксаттар керектигин жарыялайсыз, курулушту жүктөйсүз жана текшерүүгө жөнөтөсүз. Бул бет бүт процессти кадам сайын көрсөтөт.
> [!NOTE]
> Бул агым үчүн **коомчулук (үчүнчү тарап)** сиз аркылуу тапшырылган плагиндер
> [жеке кабинет](/ky/v1.0/portal/overview) жана **my.aihummer.ru**. Биринчи тарап
> AiHummer плагиндер өз алдынча түтүкчөсүндө келет. Коомчулук плагиндер **эркин**; сен
> кошумча ынаным каттоо шилтемесин кошуу мүмкүн.
## Баштаардан мурун
1. A **катталган жеке кабинет аккаунту** — каттоодон өтүп, аны тастыктаңыз (караңыз
[Каттоо](/ky/v1.0/portal/registration)). Ар кандай кардар жибериши мүмкүн.
2. A **курулган плагин** — кол менен кол коюлган чыгарууга даярдалган архив
[Плагин SDK](/ky/v1.0/marketplace/sdk) (`aihummer plugin package`). Эгерде сизде
азырынча курулган жок, анын менен биринчи башта.
3. Бир **иконка жана кеминде бир скриншот**, жана сиздин сүрөттөмөлөрүңүз даяр **экиси
Орус жана Англис**.
## Жарыялоо кантип иштейт (чоң сүрөт)
Сиздин тапшырмаңыз белгиленген процесс аркылуу өтөт. Анын абалын ар бир кадамда кабинеттен көрө аласыз.
| Сахна | Эмне болот | Ким аракет кылат |
|---|---|---|
| **Черновик** | Сиз кирүүнү түзөсүз жана метадаталарды толтурсаңыз болот; азырынча эч нерсе коомчулукка ачык эмес. | Сен |
| **Жөнөтүлгөн** | Сиз аны кароого жибересиз. | Сен |
| **ЖИ карап чыгуу** | Автоматташтырылган агент плагинди текшерет [саясатты карап чыгуу](/ky/v1.0/marketplace/review-policy) — коопсуздук, тууралыгын көрсөтүү, толук процесс, мазмун. | Автоматташтыруу |
| **Орточо өлчөм** | Адам модератор AI отчетун жана сиздин өнөрүңүздү жана метадатаңызды окуп, чечим чыгарат. | АйХаммер командасы |
| **Жарыяланган** | Жаңыдан бекитилгенден кийин, артефакт кол коюлуп, коомчулуктун каталогуна жана коомдук базардын агымына кошулат. | АйХаммер командасы |
| **Баш тартылган** | Эгер бир нерсе иштебей калса, себептерин билесиң; оңдоп кайра тапшыруу. | Сиз → черновикке кайтуу |
> [!IMPORTANT]
> ЖИ **эч качан** өзү жарыялайт. Адам ар дайым акыркы чечимди кабыл алат,
> жана эч нерсе алардын макулдугусуз каталогго жетпейт.
## Кадам 1 — «Менин плагиндеримди» ачыңыз
Кирүү **my.aihummer.ru**, ач **«Менин плагиндерим»** бөлүм, жана чыкылдатыңыз **«Жариялоо»** (же **«Жаңы плагин»**). Бул түзөт **черновик** Сиз аны тапшырууга чейин эркин түзөтө аласыз.
## 2‑кадам — Дүкөндүн метадеректерин толтуруңуз
Ар бир талааны толтуруңуз. Толук эмес метадата тапшыруунун кайтарып берилишинин эң кеңири таралган себептеринин бири болуп эсептелет.
| Дала | Эмне киргизүү керек |
|---|---|
| **Аты (RU + EN)** | Плагиндин көрсөтүүчү аталышы эки тилде. |
| **Кыскача баяндама (RU + EN)** | Каталог карточкасы үчүн бир сап. |
| **Толук сүрөттөмө (RU + EN)** | Плагин эмне кылат, аны кантип колдону керек, эмне керек. Маанилүү — жок дегенде бос орун эмес. |
| **Категория** | Рухсат берилген топтомдон бирөөүн тандаңыз (мисалы, Каналдар, Продуктивдүүлүк, Интеграциялар, Добуш, Стандарттык өнүмдөр). |
| **Версия** | A [semver](https://semver.org) жол, мисалы `1.0.0`. Ар бир жаңы тапшырма аны көбөйтүшү керек. |
| **Иконка** | Жарамдуу төрт бурчтук сүрөт. |
| **Скриншоттор** | Эң аз дегенде бирөө; плагиндин иштеп жатканын көрсөтүү. |
| **Лицензия** | Плагиндин лицензиясы (мисалы, MIT, Apache-2.0). |
| **Башкы бет / репозиторий** | Мажбур эмес `https://` жобоңузга шилтеме. |
| **Сыйлык берүү шилтемеси** | Ишке ашырылышы мүмкүн. Жачыктуу `https://` aга шилтеме **жакшы таанымал салым берүүчү** — мисалга Boosty, Patreon, PayPal же YooMoney. Фишинг же каалаган хосттор четтетилет. |
| **Өзгөрүүлөрдүн журналы (RU + EN)** | Бул версияда эмне өзгөрдү. |
> [!TIP]
> Сиздин плагиниңизди эч качан көрбөгөн чыныгы колдонуучу үчүн сүрөттөмөлөрдү жазыңыз. "Үчүн"
> "dummies" так туура: эмне кыларын, качан колдонорун, жана эмне керек экенин тийгизип айткыла.
## 3‑кадам — мүмкүнчүлүктөр манифестин жарыялоо
Бул **имкандык манифест** коопсуздук моделинин жүрөгү болуп саналат. Бул кыска, структураланган декларация болуп саналат **силердин плагиниңизге керек болгон ар бир уруксат** — кайсы хосттор менен байланышат, кайсы файлдарга тийишет, тышкы буйруктарды аткаратбы, кайсы каналдар жана күбөлүктөр колдонулат.
### Эмне үчүн жарыялап жатасыз?
- Кардарлар талап кылынган уруксаттарды көрүшөт **алуудан мурун** жана макул болуу
аларга, мобилдик тиркеменин уруксат сурамындегидей эле.
- Бул учур манифестти колдонушат **чектөө** плагин өзүнүн жарыялаганына чейин.
- Сынчылар сиздин менен текшеришет **жариятталган** мүмкүнчүлүктөр **матч** код деген эмне
чынында эле жасайт. Өзү билдирбеген уруксатты сураган плагин
четке кагылды.
### Эң аз артыкчылык принциби
Жар сал **жалгыз** Сиздин плагин чындыгында эмне колдонот жана андан ары эч нерсе жок. Аз уруксаттар тезирээк текшерүү, жеңилирээк кардар макулдугу жана көбүрөөк орнотууларды билдирет. Эгер сиз файл тутумуна тийбесеңиз, бош тизмени белгилеңиз. Эгер эч качан процесс жаратпасаңыз, белгилеңиз `exec` көрсөтүү `false`.
### Форматы
Күчтүүлүктүн манифести бул талаалар менен JSON объектиси:
| Дала | Түрү | Маани |
|---|---|---|
| `network` | жол[] | Плагин туташкан хост аттары (анын чыгуу уруксат тизмеси). |
| `filesystem` | жол[] | Ал окуй турган же жазган жолдор, өзүнүн плагин каталогуна салыштырмалуу. |
| `exec` | логикалык | Ал тышкы процесстерди жаратабы / буйруктарды аткарат же жокпу. |
| `channels` | жол[] | Интеграцияланган билдирүү каналдары (мисалы) `telegram`). |
| `credentials` | жол[] | Аты аталган сырлар/конфигурация ачкычтары, ал колдонгон (сыр баалуулуктар эмес). |
| `description` | жол | Эмне керек экенин жана эмнеге керек экенин кыска, адам түшүнө тургандай баян. |
Мисал:
```json
{
"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]
> Жасау **эмес** чыга анын чындыгындагы сырларын, белгилерин же ачкычтарын эч жерге салба — манифестте дагы, башка жерде дагы эмес
> метадатада, артефактта эмес. Кирүү маалыматтарын жар салуу **ат боюнча гана** (мисалы,
> `api_token`); кардар орнотууда чыныгы баасын камсыздайт. Туура которулган
> сырлар автоматтык жоопкерчиликке жокко чыгаруу болуп саналат.
## 4‑кадам — археологиялык байлыкты жүктөө
Плагинингиздин түзүмүн жүктөңүз:
- **Формат:** а `.tar.gz` жарыялоо үчүн түзүлгөн тарбөлөк
[`aihummer plugin package`](/ky/v1.0/marketplace/sdk#the-cli).
- Бул плагиндин болушу керек **`manifest.json`** (SDK манифести — түрү,
версия, кирүү чекити, жарыяланган `capabilities`, конфигурация талаалары).
- Сиз 3‑кадамда толтурган мүмкүнчүлүктөрдүн манифести болушу керек **туруктуу** кайсы менен
код жана `manifest.json` чындап эле кылат.
Сен дагы тиркейсиң **иконка** жана **түшүрмөлөр** эгер сен буга чейин кылбаган болсоң, бул жерде.
> [!TIP]
> Жүр `aihummer plugin validate` жергиликтүү жүктөөдөн мурун. Текшерүү келишими
> бул базар колдонгону менен бирдей, ошондуктан жергиликтүү өткөрүлгөн манифест
> бул жерде да кабыл алынат.
## 5-кадам — Кароого жөнөтүү
Ар бир талаа толтурулуп, артефакт жүктөлгөндө, чыкылдатыңыз **«Кароо үчүн жүктөө»**. Кабинет биринчи толуктоо текшерүүсүн жүргүзөт; эгер бир нерсе жок болсо, так кайсы экенин айтып берет. Кабыл алынгандан кийин, абалы **Жөнөтүлгөн** анан **ЖИ карап чыгуу** — сен эч нерсе жасоонун кереги жок.
## 6-кадам — Абалды көзөмөлдөп, чечимди окуу
Плагинди ачыңыз **«Менин плагиндерим»** анын абалын көзөмөлдөөгө. Кароо бүткөндө сиз төмөнкүдөй нерселердин бирин көрөсүз:
- **Мезгил-мезгили менен** — автоматтык карап чыгуу өттү же болгону майда нерселерди белгиледи; а
адам азыр ага карап жатат. Түшкө чейин күт.
- **Баш тартылган** — бир нерсе ийгиликсиз болду. Сен көрөсүң **өкүм, кыскача баяндама, жана
өтпөгөн конкреттүү буюмдар** (ар биринин себеби менен). Бул сиздин
түзөтүү-тизмеси.
- **Жарыяланган** — бекитилген, кол коюлган жана түз. Сиздин плагин азыр көрсөтүлөт
[AiHummer базары](https://aihummer.ru) жана кайсы гана болбосун инстанцияга орнотулат
коомдук каталог күйгүзүлгөн.
### Баш тартууну кантип окуп, кайра тапшыруу керек
1. Плагинди ач; оку **иштен чыккан буюмдар** жана алардын себептери.
2. Аларды оңдоңуз — көпчүлүгү төмөнкү бири: жетишсиз/күчсүз сүрөттөө, туура келбеген мүмкүнчүлүк
манифест, катырылган сыр, начар донордук шилтеме же сиз колдонбогон версия
өстүрүү.
3. Метадайындарды түзүңүз жана/же жүктөңүз **версиясы жогорулаган жаңы артефакт**.
4. Бас **«Кароо үчүн жүктөө»** қайра. Ал ошол эле түтүктөн кайра өтөт.
> [!NOTE]
> Рад болуу жазалоо эмес — бул текшерүү тизмеси.
> [саясатты карап чыгуу](/ky/v1.0/marketplace/review-policy) айрыкча сен үчүн коомчулукка ачык
> ар бир талапты канааттандыра алат **мурда** сен баш ийесиң.
## Кайда кийинки
- [Саясатты жана текшерүү тизмесин карап чыгыңыз](/ky/v1.0/marketplace/review-policy) — так
сиздин плагин текшерилген критерийлер.
- [Плагин SDK](/ky/v1.0/marketplace/sdk) — плагинди жана анын куруу
`manifest.json`.
- [Плагин жарыялоо](/ky/v1.0/marketplace/publishing) — жеке тараптан жүктөө жана
башка басып чыгаруу режимдери.
- [Орнотуу жана жаңыртуулар](/ky/v1.0/marketplace/install-updates) — кардарлар кантип
орнотуу жана ишеним модели кандай иштээрин.