Плагин жарыялоо

Плагинди менен түздү [Плагин SDK](/ky/v1.0/marketplace/sdk)? Сиз муну жарыялай аласыз **эки жол**: - **Жеке (өзүң үчүн)** — аны *сиздин* экземплярыңызга кошуңуз. Артефакт эч качан анчап кетет. - **Жамаат (бардыгы үчүн)** — аркылуу жарыялоо [жеке кабинет](/ky/v1.0/portal/overview) жана **my.aihummer.ru**, колдонмо дүкөн стиль: курулушту жүктөө, дүкөн бетин толтуруу, кароодон өтүү, жана ал жерге түшөт ар бир экземпляр орното ала турган кол коюлган коомчулук каталогү. Аналогия: орнотуу `.vsix` кол менен (жеке) vs тиркеме дүкөнүнө жарыялоо (коомчулук). > [!WARNING] > **Коомчулуктун плагиндерин азыр орнотууга болбойт — бул байланыш үзгүлтүгү > эмес.** Коомчулук каталогуна кол коюлган ачкыч кайра чакырылды; жаңы ачкыч > чыкканга чейин кол тамга текшерүүсү мындай жазууларды четке кагат. Мындан > тышкары, үчүнчү тараптын коду азырынча сиздин серверде кызмат катары > иштетилбейт: обочолонгон аткаруу чөйрөсү пайда болгонго чейин өз жагында > иштеген жана тармак аркылуу туташкан интеграцияларга гана уруксат берилет. > > **Эмнени көрөсүз:** «орнотуу» баскычынан кийин кадимки «орнотулууда» билдирүүсү > чыгат, бирок плагин орнотулгандардын тизмесинде **эч качан пайда болбойт**. > Четке кагуунун себеби шлюз журналына жазылат — башкаруу панелинде > **Журналдар** бөлүмүн ачыңыз. > > **Бүгүн эмне иштейт:** > > - расмий каталогдогу **AiHummer плагиндери** — адаттагыдай орнотулат, аларда > башка, жарактуу кол тамга бар; > - **HTTP аркылуу MCP сервери** — иштеп чыгуусуз аспап булагы катары туташат, > код сиздин жагыңызда калат; > - **OpenAPI спецификациясы боюнча интеграция** — ошол эле, кызмат орнотпостон. > > Өз плагиниңизди кол менен жүктөө кол тамга текшерүүсүнөн өтөт, бирок **HTTP > аркылуу алыскы MCP** же OpenAPI интеграциясы катары гана иштейт; ушул сервердин > өзүндө кызмат катары иштетилиши керек болгон курама четке кагылат. ## Жеке режим — өз миссияңызга кол менен жүктөө Бул плагинди гана сизге керек болгондо колдонуңуз: ички байланыштыруучу, өзгөчө интеграция, тесттик курулуш. ### Кадамдар 1. Пакеттөө жана топтомго кол коюу: ```bash aihummer plugin package ./my-plugin aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz ``` 2. Муну экземплярга эки жолдун бири менен жүктөп коюңуз: - **Админ UI → Плагиндер → «Плагинди жүктөө»** — топтомду сүйрү; же - CLI: ```bash aihummer plugin publish --private --instance https://your-instance \ --token <admin-token> my-plugin-1.0.0.tar.gz ``` 3. Мунун түбүнөн бул `POST /v1/admin/modules/upload` (көп бөлүктүү, `integrations:write`): буюм жерде конот **мисалдык блоб сактагыч** (`AIHUMMER_BLOB_DIR`) астында `blob:` реф, жана каталог катар катталган `origin = local-private`, `visibility = private`. 4. Плагин рынокто белгиленген тэг менен көрүнөт **Жеке** жана аркылуу орнотот адаттагы жол — [sandboxed systemd бөлүмү + саламаттык текшерүү шлюзу](/ky/v1.0/marketplace/install-updates). ### Ишеним: аныкталган ачкыч жана ишеним кампасы Жеке буюмдар **имзалануу керек**. Белгисиз ачкыч менен кол коюлган плагинди жүктөгөндө, Админ UI сизге сунуштайт **автордун ачкычын бекит** мисал процессиндеги ишеним дүкөнүнө (бир чык менен) киргизилет. Жоболонгондон кийин, кол тамга ар бир орнотуу жана жаңыртуу учурунда текшерилет. - дан калдык буюмдар **расмий** булакты текшерүү **реестр ачкычы бышырылган негизги бөлүгүндө** — демейки боюнча ишенимдүүлүк менен, кошумча кадам жок. - **Жеке** Артефактылар инстанциянын ишеним сактагычындагы ачкычтарга каршы текшерилет. - **Кол коюлбаган** топтомдор четке кагылат — жергиликтүү кайталануу үчүн dev режиминен башка: `AIHUMMER_PLUGIN_DEV_UNSIGNED=1`. > [!WARNING] > `AIHUMMER_PLUGIN_DEV_UNSIGNED=1` кол тамга текшерүүнү өчүрөт жана багытталган > бөлөк жергиликтүү өнүктүрүү үчүн гана. Аны сырттан жеткиликтүү экземплярда эч качан күйгүзбөңүз. ## Жамааттык режим — жеке кабинет аркылуу жарыялоо Плагинди жеткиликтүү кылуу үчүн **ар бир** мисал, аны өзүңүздүн тараптан жарыялагыла **жеке кабинет** жана **my.aihummer.ru**, колдонмону колдонмо дүкөнүнө жарыялаган сыяктуу. Сиз курулушту жүктөйсуз, дүкөн барагын толтурасыз жана текшерүүгө жөнөтөсүз; алгач автоматташтырылган AI текшерүүсү жүргүзүлөт, андан кийин адам модератор акыркы чечимди чыгарат, жана макулдуктан кийин чыгарма кол коюлуп, коомдук каталогго жарыяланат. Толук, кадам сайын көрсөтмө бар [Плагинди жөнөтүү](/ky/v1.0/marketplace/submit-plugin). Кыскача: 1. **Куруу жана таңгактоого** SDK менен сиздин плагин ([`aihummer plugin package`](/ky/v1.0/marketplace/sdk)) — бул буюм кол коюлган `.tar.gz` анын үстүндө алып жүрүп `manifest.json`. 2. **«Менин плагиндеримди» ачыңыз** шкафта жана тапшыруу түзүңүз: **жүктөө кол жазма буюм**, толтуруңуз **маалыматтарды сактоо** (аты жана сүрөттөмөлөрү RU + EN) версиясы, иконка, скриншоттор, категория, кошумча донордук шилтеме, өзгөртүүлөр журналы) жана жар салуу [имкандык манифест](/ky/v1.0/marketplace/submit-plugin#step-3--declare-the-capability-manifest). 3. **Кароочу үчүн жибериңиз.** Автоматташтырылган **ЖИ карап чыгуу** тапшырманы текшерет [карап чыгуу саясаты](/ky/v1.0/marketplace/review-policy) боюнча текшерет (коопсуздук, манифест тактыгы, толуктугу, мазмуну), андан соң **адам-модератор** отчётту окуйт жана чечим чыгарат. Автоматташтыруу өз алдынча эч качан жарыялайт. 4. **Approval боюнча** байыркы буюм **кол коюлган** жана жарыяланган **ажыратуу `community-catalog.json`** CDNде. Кошулган ар бир нуска коомчулук булагы плагинди көрөт; ядро аны ишенимдүү деп эсептейт **түйүлгөн реестр ачкычы** — ар бир операторго ишенүү кадамы талап кылынбайт. > [!NOTE] > **Эски коомдук жарыялоо агымы токтотулган**; жогорудагы жеке кабинет агымы — > «Менин плагиндерим» — эми коомчулук жарыялоосунун бирден-бир жолу. > Коомдук плагиндер **акысыз**; кааласаңыз кайрымдуулук шилтемесин кошо > аласыз. > [!NOTE] > **Биринчи тараптын плагиндери** (Эйнштейн, SIP, Bitrix24, pocket-agent, os-client) болуп саналат > ушундай жол менен жарыяланган эмес — алар өзүнчө AiHummer CI түйүнүндө жөнөтүшөт жана жерге түшөт > тартылган расмий каталог. Жеке кабинет агыны үчүн **коомчулук > (үчүнчү тарап)** плагиндер. ## Орточо өлчөм Ар бир коомдук сунуштук каралат **автоматташтырылган текшерүү** (толуктоо, мүмкүнчүлүк манифести, кол тамга жана коопсуздук текшерүү), андан кийин **ЖИ кооптуулугун кайра карап чыгуу**, жана акыры **милдеттүү адам тарабынан карап чыгу** AiHummer командасы тарабынан. Автоматташтыруучу же AI өз алдынча эч качан жарыяламайт — чечим ар дайым модератордун колунда, жана алардын макулдугусу жок эч нерсе каталогго жетпейт. Кейинчирээк зыяндуу же иштебей калган деп табылган жарыяланган плагин болушу мүмкүн **жоогазылган** жана кийинки синкрондоштуруу учурунда каталогдон өчүрүлгөн. ## Жамаат каталогун кошумча булак катары Жамааттык плагиндер жарыяланат **ажыратуу** `community-catalog.json` ал жасайт **эмес** сарпталган биринчи жактын каталогун үстүнө жазуу. Мисал аны кошумча булак катары кошот **Плагиндер → Булагылар** (же `POST /v1/admin/modules/catalog/sources`). Караңыз [Орнотуу жана жаңыртуулар](/ky/v1.0/marketplace/install-updates#multi-source-catalog) жана [Киришүү жана деңгээлдер](/ky/v1.0/marketplace/overview-tiers#official-and-community). ## Плагиндин жашоо цикли (App Store) Базар чыныгы App Store сыяктуу иштейт — ар бир плагинде бар **жеке өздүк** (туруктуу слуг + автор) анын астында жеткирилет **версиялар**. ### Версиялар жана жаңыртуулар Жаңыртуу катары жөнөтүлөт **жаңы нуска** мурун басылып чыккан плагиндин: ошол эле слуг, өзүнүн өзгөртүүлөр журналы, өзүнүн сын-пикирлери жана модерациясы. Жалгыз **бир** Версия учурда каралып жатканда болушу мүмкүн — сиз кийинки версияны учурдагысына чечим чыккан соң жөнөтөсүз. Жаңы версия жарыяланганда, мурункусу белгиленет `superseded`, жана каталог + ар бир учур жаңысына көчүрүлөт. ### Пландалган жарыялоо Модератор аны бекиткенден кийин, **автор чыгарууну башкарат**: азыр жарыялоо же аны белгилүү бир убакытка пландаштыруу — плагин белгиленген учурда жанданышы мүмкүн. ### Жарыялоочу эмес кылуу - **Үзүү** — плагинди убактылуу жашыруу: ал коомдук каталогдон жана инстанциялардан чыгып калат (кийинки синхрондо), бирок сакталат жана болушу мүмкүн **кайра басылган** кайсы убакта болбосун. - **Каталогдон чыгаруу** — плагинди базардан толугу менен алып салуу. Плагин жарыяланбай калганда (уктатылган же тизмеден чыгарылган), анын киргизүүсү жок кылынат `community-catalog.json`, жана учурлар аны кийинки синхрондоштурууда көрсөтүүнү токтотот. ### Автордук Плагин бул жерде жарыяланган **сиздин көрсөтүү атыңыз** (мисалы, сиздин студияңыздын аты) — же **атын жашырып**Жалпы каталог жана экземплярдын Веб интерфейси тандалган аталышы же «Анонимдүү» деп көрсөтөт; сиздин чыныгы электрондук почтаңыз/ID эч качан көрсөтүлбөйт. ### Өнүгүүчү көрсөткүчтөрү Ар бир плагинде бар **жалпы статистика**: жүктөөлөр, орнотуулар, активдүү учурлар жана жоюулар, ошондой эле күнүмдүк диаграмма. Жалпы көрсөткүчтөр гана — бирдиктүү учур боюнча маалыматтар иштеп чыгуучуга көрсөтүлбөйт. ### Басып чыгаруу сыйлыгы Үчүн **биринчи жолу жарыялаган ар бир плагин**, сиздин AiHummer жазылууңуз алынат **бир ай акысыз** (пайдалануу үчүн плагин сайын берилет). ## Кайда кийинки - [Жеке кабинет аркылуу жүктөө](/ky/v1.0/marketplace/submit-plugin) — толугу менен бөлөк-бөлөк: метадата, мүмкүнчүлүктөрдүн манифесттери, ЖИ карап чыгуу жана модерация. - [Плагин SDK](/ky/v1.0/marketplace/sdk) — талааларды көрсөтүңүз жана `aihummer плагин буйруктары. - [Орнотуу жана жаңыртуулар](/ky/v1.0/marketplace/install-updates) — көп булактуу, ишеним модели, кол коюлган жаңыртуулар, рейтинг. - [Саясатты жана текшерүү тизмесин карап чыгыңыз](/ky/v1.0/marketplace/review-policy) — критерийлер а плагин чыгарманын алдында текшерилет. - [Marketplace: кыскача маалымат жана катмарлар](/ky/v1.0/marketplace/overview-tiers) — расмий жамаат регистриси менен.