Плагинді жариялау

Плагинді қостым [Плагин SDK](/kk/v1.0/marketplace/sdk)? Сіз оны жариялай аласыз **екі тәсіл**: - **Жеке (өз үшін)** — өз данасына жүктеп салу. Артефакт ешқашан оны қалдырады. - **Қауымдастық (бәріне)** — өзіңіз арқылы жариялау [жеке кабинет](/kk/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:` ref, және каталог жолы тіркелген `origin = local-private`, `visibility = private`. 4. Плагин нарықта белгілерімен көрсетіледі **Жеке** және арқылы орнатады әдеттегі жол — [песочницадағы systemd бірлігі + денсаулық қақпасы](/kk/v1.0/marketplace/install-updates). ### Сенім: бекітілген кілт және сенім қоймасы Жеке жәдігерлер **қол қою қажет**. Белгісіз кілтпен қол қойылған плагинді жүктегенде, Әкімші UI сізге хабарлайды **автордың кілтін мақұлдау** Инстанция сенім дүкеніне (бір рет басу) қосылады. Бір рет мақұлданғаннан кейін, қолтаңба әрбір орнату және жаңарту кезінде тексеріледі. - Зерттеулерден табылған жәдігерлер **ресми** көзді дереккөзге қарсы тексеру **тіркеу кілті бекітілді негізінде** — әдепкі бойынша сенімді, қосымша қадам жоқ. - **Жеке** Артефактілер инстанцияның сенім дүкеніндегі кілттерге қарсы тексеріледі. - **Қолы жоқ** пакеттер қабылданбайды — тек жергілікті қайталау үшін дамытушы режимінде ғана: `AIHUMMER_PLUGIN_DEV_UNSIGNED=1`. > [!WARNING] > `AIHUMMER_PLUGIN_DEV_UNSIGNED=1` қолтаңба тексеруін өшіріп, арналған > тек жергілікті дамыту үшін. Оны сырттан қолжетімді нысанда ешқашан қоспаңыз. ## Қауымдастық режимі — жеке кабинет арқылы жариялау Плагинді қолжетімді ету үшін **әр** мысалы, оны өзіңізден жариялаңыз **жеке кабинет** де, -де **my.aihummer.ru**, қосымшаны қосымша дүкеніне жариялаған сияқты. Сіз құрылымды жүктейсіз, дүкен бетін толтырасыз және оны қарауға жібересіз; алдымен автоматтандырылған AI тексеруі жүргізіледі, содан кейін адам модераторы соңғы шешімді қабылдайды, және мақұлданған соң артефакт қол қойылып, қауымдастық каталогына жарияланады. Толық, қадамдық нұсқаулық осында [Плагинді жіберу](/kk/v1.0/marketplace/submit-plugin). Қысқаша айтқанда: 1. **Құрастыру және пакеттілеу** SDK-пен сіздің плагиніңіз ([`aihummer plugin package`](/kk/v1.0/marketplace/sdk)) — бұл артефакт қолы қойылған `.tar.gz` оны таситын `manifest.json`. 2. **«Менің плагиндерім» ашу** шкафта және ұсыныс жасау: **жүктеу өрнек зат**, толтырыңыз **метадеректерді сақтау** (аты мен сипаттамалар RU + EN) нұсқасы, белгішесі, скриншоттары, категориясы, ерікті донат сілтемесі, өзгерістер журналы) және жариялау [қабілет манифесті](/kk/v1.0/marketplace/submit-plugin#step-3--declare-the-capability-manifest). 3. **Шолу үшін жіберу.** Автоматтандырылған **ЖИ шолу** жазбаны тексеру [шолу саясаты](/kk/v1.0/marketplace/review-policy) талаптарына сай тексереді (қауіпсіздік, манифест дұрыстығы, толықтығы, мазмұны), содан кейін **адам-модератор** есепті оқиды және шешім қабылдайды. Автоматтандыру өздігінен ешқашан жарияламайды. 4. **Бекітілгенде** өрнек **қолы қойылған** және жарияланды **ажыратылған `community-catalog.json`** CDN-де. Қосқан әрбір мысал қоғамдық көз плагинді көреді; ядро оны арқылы сенеді **бекітілген тіркеу кілті** — әр операторға сенім қадамы қажет емес. > [!NOTE] > **Ескі қоғамдық жариялау ағыны тоқтатылды**; жоғарыдағы жеке кабинет ағыны — > «Менің плагиндерім» — енді қауымдастық жариялауының жалғыз жолы. > Қауымдастық плагиндері **тегін**; қалауыңызша қайырымдылық сілтемесін қоса > аласыз. > [!NOTE] > **Бірінші тарап плагиндері** (Эйнштейн, SIP, Bitrix24, pocket-agent, os-client) болып табылады > осылай жарияланбаған — олар өздерінің AiHummer CI желісі арқылы жіберіледі және орынға түседі > бекітілген ресми каталог. Жеке кабинет процессі үшін **қауымдастық > (үшінші тарап)** плагиндер. ## Орташа деңгей Әрбір қауымдастық ұсынысы арқылы өтеді **автоматты тексеру** (толықтық, мүмкіндіктерді көрсету, қолтаңба және қауіпсіздік тексеруі), содан кейін **ЖИ қауіп-қатерін шолу**, және соңында бір **міндетті адамдық тексеру** AiHummer командасы арқылы. Автоматтандыру немесе ЖИ ешқашан өздігінен жарияламайды — шешімді әрқашан модератор қабылдайды, және олардың мақұлдауынсыз ештеңе каталогқа жетпейді. Кейін зиянды немесе бұзылғаны анықталған жарияланған плагин болуы мүмкін **қайтарылды** және келесі синхронда каталогтан шығарылды. ## Қауымдастық каталогы қосымша ресурс ретінде Қауымдастық плагиндері жарияланады **ажыратылған** `community-catalog.json` сол істейді **емес** таңдалған бірінші тарап каталогын үстінен жазу. Бір мысал оны қосымша көзі ретінде қосады **Плагиндер → Бастауыштар** (немесе `POST /v1/admin/modules/catalog/sources`). Қараңыз [Орнату және жаңартулар](/kk/v1.0/marketplace/install-updates#multi-source-catalog) және [Шолу және деңгейлер](/kk/v1.0/marketplace/overview-tiers#official-and-community). ## Плагиннің өмірлік циклі (App Store) Нарық нақты App Store сияқты жұмыс істейді — әр плагинде бар **кімендік** (тұрақты слаг + автор) оның астында жеткізіледі **нұсқалары**. ### Нұсқалар мен жаңартулар Жаңарту ретінде жіберіледі **жаңа нұсқа** арта жарияланған плагиннің: сол слаг, өз өзгерістер журналы, өз шолуы мен модерациясы. Тек **бір** нұсқа бір уақытта қаралып жатқан болуы мүмкін — сіз келесі нұсқаны ағымдағы нұсқа шешім қабылдағаннан кейін жібересіз. Жаңа нұсқа жарияланған кезде, алдыңғысы белгіленеді `superseded`, және каталог + әрбір үлгі жаңа нұсқаға көшіріледі. ### Жоспарланған жариялау Модератор оны мақұлдағаннан кейін, **автор шығару процесін басқарады**: қазір жариялаңыз немесе оны нақты уақытқа жоспарлаңыз — плагин белгілі бір сәтте іске қосылады. ### Жарияламау - **Кідірту** — плагинді уақытша жасыру: ол қоғамдық каталогтан және нұсқалардан түседі (келесі синхронда), бірақ сақталып қалады және болуы мүмкін **қайта жарияланған** кез келген уақытта. - **Тізімнен шығару** — плагинді нарықтан мүлдем алып тастау. Плагин жарияланбаған (тоқтатылған немесе тізімнен шығарылған) сәтте оның жазбасы жойылады `community-catalog.json`, және жағдайлар келесі синхрондау кезінде оны көрсетуді тоқтатады. ### Авторлық Плагин жарияланған **сіздің көрсету атауыңыз** (мысалы, студияңыздың атауы) — немесе **аноним түрде**. Қоғамдық каталог және инстанцияның Web UI таңдалған атауды немесе «Анонимді» көрсетеді; сіздің нақты электрондық поштаңыз/ID ешқашан жарияланбайды. ### Әзірлеуші статистикасы Әрбір плагинде бар **жалпылама статистика**: жүктеулер, орнатулар, белсенді мысалдар және жоюлар, сонымен қатар күнделікті кесте. Тек жиынтық сандар — әзірлеушіге әрбір мысал бойынша деректер көрсетілмейді. ### Жариялау сыйлығы үшін **сіз жариялап отырған әрбір плагин бірінші рет**, сіздің AiHummer жазылымыңыз алады **бір ай тегін** (әр плагин үшін бір рет беріледі). ## Келесі қайда - [Жеке кабинет арқылы жіберу](/kk/v1.0/marketplace/submit-plugin) — толық қадам-қадам бойынша: метадеректер, мүмкіндіктер манифесті, ЖИ шолуы және модерация. - [Плагин SDK](/kk/v1.0/marketplace/sdk) — манифест өрістері және `aihummer плагин командалары. - [Орнату және жаңартулар](/kk/v1.0/marketplace/install-updates) — көп дереккөзді, бұл сенім моделі, қол қойылған жаңартулар, рейтинг. - [Саясат пен тексеру тізімі](/kk/v1.0/marketplace/review-policy) — критерийлер a плагин жарияламас бұрын тексеріледі. - [Нарық алаңы: шолу және деңгейлер](/kk/v1.0/marketplace/overview-tiers) — ресми VS қауымдастық тіркеуі.