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

Community-маркетплейс каттоодон өткөн каалаган кардарга өз плагинин бардыгы орното ала турган кылып жарыялоого мүмкүндүк берет — так App Store’го колдонмо жарыялагандай эле. Сиз карточканын метадайындарын толтурасыз, плагиниңизге кандай уруксаттар керек экенин декларациялайсыз, курулманы жүктөйсүз жана аны текшерүүгө жөнөтөсүз. Бул барак сизди бүт процесс аркылуу кадам-кадам алып өтөт.

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

Баштоодон мурун

Каттоодон өткөн жеке кабинет аккаунту — катталып, аны ырастаңыз (караңыз: Каттоо). Плагинди каалаган кардар жөнөтө алат.
Курулган плагин — Plugin SDK менен чогултулган (aihummer plugin package) кол коюлган релиздик tarball. Эгер аны азырынча курбаган болсоңуз, адегенде ошол жерден баштаңыз.
Иконка жана эң аз дегенде бир скриншот, ошондой эле орусча жана англисче даяр сүрөттөмөлөр.

Жарыялоо кантип иштейт (жалпы сүрөт)

Сиздин арызыңыз белгиленген конвейерден өтөт. Ар бир кадамда анын статусун кабинетте көрө аласыз.

Этап	Эмне болот	Ким аракет кылат
Каралама	Сиз жазууну түзүп, метадайындарды толтурасыз; азырынча эч нерсе жалпыга ачык эмес.	Сиз
Жөнөтүлдү	Сиз аны текшерүүгө жөнөтөсүз.	Сиз
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://` шилтемеси, милдеттүү эмес.
Донат шилтемеси	Милдеттүү эмес. Белгилүү донат-хостко — мисалы Boosty, Patreon, PayPal же ЮMoney’ге — жарактуу `https://` шилтемеси. Фишинг же кокус хосттор четке кагылат.
Changelog (RU + EN)	Бул версияда эмне өзгөргөнү.

[!TIP] Сүрөттөмөлөрдү плагиниңизди эч качан көрбөгөн чыныгы колдонуучу үчүн жазыңыз. «Эң жөнөкөй тил менен» — так ушул керек: ал эмне кылат, качан колдонуу керек жана ага эмне керек экенин айтыңыз.

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

Capability manifest — коопсуздук моделинин жүрөгү. Бул сиздин плагиниңизге керек болгон бардык уруксаттардын кыска, структуралуу декларациясы — ал кайсы хосттор менен байланышат, кайсы файлдарды тиет, сырткы буйруктарды иштетеби, кайсы каналдарды жана эсептик маалыматтарды колдонот.

Аны эмне үчүн декларациялоо керек

Колдонуучулар суралган уруксаттарды орнотуудан мурун көрүшөт жана аларга макул болушат — мобилдик колдонмонун уруксат сурашындай.
Инстанция манифестти плагинди ал декларациялаган нерсе менен чектөө үчүн колдонот.
Текшерүүчүлөр сиздин декларацияланган мүмкүнчүлүктөрүңүз коддун чындыгында эмне кыларына дал келерин текшеришет. Декларацияланбаган уруксатка умтулган плагин четке кагылат.

Эң аз артыкчылык принциби

Плагиниңиз чындап колдонгон нерсени гана декларациялаңыз, андан ашыгын эмес. Аз уруксат — тезирээк текшерүү, оңой кардар макулдугу жана көбүрөөк орнотуулар. Эгер файл системасын тийбесеңиз — бош тизме көрсөтүңүз. Эгер процесс иштетпесеңиз — exec талаасын false кылып коюңуз.

Формат

Capability manifest — төмөнкү талаалары бар JSON-объект:

Талаа	Түр	Мааниси
`network`	string[]	Плагин туташкан хосттор (анын чыгуучу сурамдарынын allowlist’и).
`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": "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-кадам — Артефактты жүктөңүз

Плагиниңиздин курулмасын жүктөңүз:

Формат: 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] Четке кагуу — жаза эмес, чек-лист. Текшерүү саясаты так ошол үчүн жалпыга ачык — сиз бардык талаптарды жөнөтүүдөн мурун аткара алышыңыз үчүн.

Кийинки кадам

Текшерүү саясаты жана чек-лист — плагиниңиз текшериле турган так критерийлер.
Plugin SDK — плагинди жана анын manifest.json файлын куруу.
Плагинди жарыялоо — жеке side-load жана башка жарыялоо режимдери.
Орнотуу жана жаңылоолор — кардарлар кантип орнотот жана ишеним модели кантип иштейт.