Плагинді жеке кабинет арқылы жариялау

Community-маркетплейс кез келген тіркелген пайдаланушыға барлығы орната алатын плагин жариялауға мүмкіндік береді — дәл қолданбаны қолданба дүкеніне жариялағандай. Сіз дүкен парақшасының метадеректерін толтырасыз, плагиніңізге қандай рұқсаттар қажет екенін декларациялайсыз, құрылымды жүктейсіз және оны шолуға жібересіз. Бұл бет бүкіл процесті қадам-қадаммен түсіндіреді.

[!NOTE] Бұл ағын — my.aihummer.ru мекенжайындағы жеке кабинетіңіз арқылы жіберілетін community (үшінші тарап) плагиндеріне арналған. AiHummer-дің бірінші тарап плагиндері өз конвейерімен шығады. Community-плагиндер тегін; қалауыңызша донат сілтемесін қоса аласыз.

Бастамас бұрын

Тіркелген жеке кабинет тіркелгісі — тіркеліп, оны растаңыз (Тіркелу бөлімін қараңыз). Плагинді кез келген пайдаланушы жібере алады.
Құрастырылған плагин — Плагин SDK көмегімен жасалған қол қойылған релиз tarball-ы (aihummer plugin package). Егер оны әлі құрастырмаған болсаңыз, алдымен сол жерден бастаңыз.
Белгіше және кемінде бір скриншот, сондай-ақ орыс және ағылшын тілдерінде дайын сипаттамалар.

Жариялау қалай жұмыс істейді (жалпы көрініс)

Өтінішіңіз тұрақты конвейерден өтеді. Әр қадамда оның мәртебесін кабинетте көре аласыз.

Кезең	Не болады	Кім әрекет етеді
Жоба	Сіз жазба жасап, метадеректерді толтырасыз; әзірге ешнәрсе жария емес.	Сіз
Жіберілді	Сіз оны шолуға жібересіз.	Сіз
AI-шолу	Автоматтандырылған агент плагинді шолу саясаты бойынша тексереді — қауіпсіздік, манифест дұрыстығы, толықтық, контент.	Автоматика
Модерация	Модератор-адам AI есебін, сондай-ақ артефактіңіз бен метадеректеріңізді оқып, шешім қабылдайды.	AiHummer командасы
Жарияланды	Мақұлданғаннан кейін артефактіге қол қойылады және community-каталогқа әрі жария маркетплейс таспасына қосылады.	AiHummer командасы
Қабылданбады	Егер бірдеңе өтпесе, себептерін аласыз; түзетіп, қайта жіберіңіз.	Сіз → қайта жобаға

[!IMPORTANT] AI ешқашан плагинді өзі жарияламайды. Соңғы шешімді әрқашан адам қабылдайды, және ол мақұлдамайынша ештеңе каталогқа түспейді.

1-қадам — «Менің плагиндерім» бөлімін ашыңыз

my.aihummer.ru-ға кіріп, «Менің плагиндерім» бөлімін ашыңыз да, «Жариялау» (немесе «Жаңа плагин») түймесін басыңыз. Осылайша жоба жасалады, оны шолуға жібергенше еркін өңдей аласыз.

2-қадам — Дүкен метадеректерін толтырыңыз

Әр өрісті толтырыңыз. Толық емес метадеректер — өтініштің қайтарылуының ең жиі себептерінің бірі.

Өріс	Не енгізу керек
Атауы (RU + EN)	Плагиннің екі тілдегі көрсетілетін атауы.
Қысқаша сипаттама (RU + EN)	Каталог карточкасына арналған бір жол.
Толық сипаттама (RU + EN)	Плагин не істейді, оны қалай пайдалану керек, оған не қажет. Мағыналы — толтырғыш емес.
Санат	Рұқсат етілген жиынтықтан біреуін таңдаңыз (мысалы: Арналар, Өнімділік, Интеграциялар, Дауыс, Утилиталар).
Нұсқа	semver жолы, мысалы `1.0.0`. Әр жаңа өтініш оны арттыруы тиіс.
Белгіше	Жарамды шаршы кескін.
Скриншоттар	Кемінде бір; плагинді іс үстінде көрсететін.
Лицензия	Плагин лицензиясы (мысалы MIT, Apache-2.0).
Сайт / репозиторий	Жобаңызға қалауыңызша `https://` сілтеме.
Донат сілтемесі	Қалауыңызша. Белгілі донат-хостқа жарамды `https://` сілтеме — мысалы Boosty, Patreon, PayPal немесе ЮMoney. Фишинг немесе кездейсоқ хостар қабылданбайды.
Чейнджлог (RU + EN)	Осы нұсқада не өзгергені.

[!TIP] Сипаттамаларды плагиніңізді ешқашан көрмеген нақты пайдаланушыға арнап жазыңыз. «Ешнәрседен хабары жоқ адамға арнағандай» жазу — дәл дұрысы: ол не істейтінін, оны қашан қолдану керегін және оған не қажет екенін айтыңыз.

3-қадам — Capability manifest декларациялаңыз

Capability manifest — қауіпсіздік моделінің жүрегі. Бұл — плагиніңізге қажет барлық рұқсаттардың қысқа әрі құрылымдалған декларациясы: ол қандай хосттармен байланысады, қандай файлдарды қозғайды, сыртқы командаларды іске қоса ма, қандай арналар мен тіркелгі деректерін пайдаланады.

Оны неге декларациялау керек

Пайдаланушылар сұралатын рұқсаттарды орнатпас бұрын көреді және оларға келіседі — ұялы қолданбадағы рұқсат сұрауы сияқты.
Дана манифестті плагинді ол декларациялаған нәрсемен шектеу үшін пайдаланады.
Шолушылар сіздің декларацияланған мүмкіндіктеріңіздің кодтың шын мәнінде істейтінімен сәйкес келетінін тексереді. Декларацияламаған рұқсатқа ұмтылған плагин қабылданбайды.

Ең аз артықшылық қағидаты

Плагиніңіз шынымен пайдаланатын нәрсені ғана декларациялаңыз, артығын емес. Рұқсат неғұрлым аз болса — шолу жылдамырақ, пайдаланушының келісімі оңайырақ және орнату көбірек болады. Файлдық жүйені қозғамасаңыз — бос тізім көрсетіңіз. Процестерді ешқашан іске қоспасаңыз — exec-ті false етіп қойыңыз.

Пішімі

Capability manifest — мына өрістері бар JSON нысаны:

Өріс	Түр	Мағынасы
`network`	string[]	Плагин қосылатын хосттар (оның шығыс рұқсат тізімі).
`filesystem`	string[]	Ол өзінің плагин каталогына қатысты оқитын немесе жазатын жолдар.
`exec`	boolean	Ол сыртқы процестерді / командаларды іске қоса ма.
`channels`	string[]	Ол интеграцияланатын хабар алмасу арналары (мысалы `telegram`).
`credentials`	string[]	Ол пайдаланатын аталған құпиялар/конфигурация кілттері (ешқашан құпия мәндері емес).
`description`	string	Оған не және не үшін қажет екенінің қысқа, адам оқи алатын түйіні.

Мысал:

{
  "network": ["api.example.com", "cdn.example.com"],
  "filesystem": ["./cache"],
  "exec": false,
  "channels": ["telegram"],
  "credentials": ["api_token"],
  "description": "Тапсырмаларды синхрондау үшін Example API-ге жүгінеді және Telegram-ға жауаптар жібереді. Жауаптарды өзінің ./cache каталогында кэштейді. Процестерді іске қоспайды, басқа хосттарды пайдаланбайды."
}

[!WARNING] Нақты құпияларды, токендерді немесе кілттерді ешқайда салмаңыз — манифестке де, метадеректерге де, артефактіге де. Тіркелгі деректерін тек атымен көрсетіңіз (мысалы api_token); нақты мәнді пайдаланушы орнату кезінде енгізеді. Қатты кодталған құпиялар — автоматты түрде бас тарту.

4-қадам — Артефактіні жүктеңіз

Плагиніңіздің құрылымын жүктеңіз:

Пішімі: aihummer plugin package командасымен жасалған .tar.gz релиз tarball-ы.
Ол плагиннің manifest.json-ын қамтуы тиіс (SDK манифесті — түрі, нұсқасы, кіру нүктесі, декларацияланған capabilities, конфигурация өрістері).
3-қадамда толтырған capability manifest коды мен manifest.json шын мәнінде істейтін нәрсемен сәйкес болуы тиіс.

Белгіше мен скриншоттарды әлі тіркемеген болсаңыз, дәл осы жерде тіркейсіз.

[!TIP] Жүктемес бұрын aihummer plugin validate-ті жергілікті жерде орындаңыз. Тексеру келісімшарты маркетплейс пайдаланатынымен бірдей, сондықтан жергілікті жерде өткен манифест мұнда да қабылданады.

5-қадам — Шолуға жіберіңіз

Барлық өріс толтырылып, артефакт жүктелгенде, «Шолуға жіберу» түймесін басыңыз. Кабинет алдымен толықтықты тексереді; бірдеңе жетіспесе, ол нақты нені екенін айтады. Қабылданғаннан кейін мәртебе Жіберілді-ге, содан кейін AI-шолу-ға ауысады — басқа ешнәрсе істеудің қажеті жоқ.

6-қадам — Мәртебені бақылап, үкімді оқыңыз

Мәртебені бақылау үшін плагинді «Менің плагиндерім» ішінде ашыңыз. Шолу аяқталғанда мына нұсқалардың бірін көресіз:

Модерацияда — автошолу өтті немесе тек ұсақ нәрселерді белгіледі; енді плагинді адам қарап жатыр. Тек күтіңіз.
Қабылданбады — бірдеңе өтпеді. Сіз үкімді, қысқаша түйінді және өтпеген нақты тармақтарды (әрқайсысының себебімен) көресіз. Бұл — сіздің түзету тізіміңіз.
Жарияланды — мақұлданды, қол қойылды және өндірісте. Плагиніңіз енді AiHummer маркетплейсінде пайда болады және community-каталогы қосылған кез келген данаға орнатылады.

Бас тартуды қалай оқып, қайта жіберу керек

Плагинді ашыңыз; өтпеген тармақтарды және олардың себептерін оқыңыз.
Оларды түзетіңіз — көбіне бұл мыналардың бірі: жоқ/әлсіз сипаттама, сәйкес келмейтін capability manifest, қатты кодталған құпия, нашар донат сілтемесі немесе арттырылмаған нұсқа.
Метадеректерді өңдеп және/немесе нұсқасы арттырылған жаңа артефактіні жүктеңіз.
Қайтадан «Шолуға жіберу» түймесін басыңыз. Ол дәл сол конвейерден қайта өтеді.

[!NOTE] Бас тарту — жаза емес, чек-лист. Шолу саясаты дәл сол үшін жария — барлық талапты жібермес бұрын орындай алуыңыз үшін.

Әрі қарай қайда

Шолу саясаты және чек-лист — плагиніңіз тексерілетін нақты критерийлер.
Плагин SDK — плагинді және оның manifest.json-ын құру.
Плагинді жариялау — жеке бүйірден жүктеу және басқа жариялау режимдері.
Орнату және жаңартулар — пайдаланушылар қалай орнатады және сенім моделі қалай жұмыс істейді.