AiHummer
Türkmençe▾
GirmekŞahsy kabinet
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Marketpleýs we pluginler/Plugin-i neşir etmek

Plugin-i neşir etmek

v1.1.x · täzelendi 2026-07-19

Bilen bir plugin gurdy Plugin SDK? Muny şu ýerde çap edip bilersiňiz iki ýol:

  • Şahsy (özüň üçin) — seniň nusgaň öňünden ýükle. Artefakt hiç haçan goýýar.
  • Jemgyýet (herkim üçin) — üsti bilen çap et şahsy kabinet at my.aihummer.ru, programma dükan stil: gurluşy ýükläň, dükanyň sahypasyny doldaryň, gözden geçirmeden geçiň we ol ýerleşýär her bir nusga onuňdan gura alyp biljek gol çekilen jemgyýet katalogy.

Mezarlama: gurnamak .vsix el bilen (şahsy) vs programma dükanına çap etmek ( jemgyýetçilik).

[!WARNING] Jemgyýet pluginlerini häzir gurnamak mümkin däl — bu aragatnaşyk näsazlygy däl. Jemgyýet katalogyna gol çeken açar yzyna alyndy; täze açar çykýança gol barlagy şeýle ýazgylary ret edýär. Mundan başga-da, üçünji tarapyň kody heniz siziň serweriňizde hyzmat hökmünde işledilmeýär: üzňeleşdirilen işleýiş gurşawy peýda bolýança diňe öz tarapynda işleýän we tor arkaly birleşýän integrasiýalara rugsat berilýär.

Näme görersiňiz: «gurna» düwmesinden soň adaty «gurnalýar» habary çykýar, ýöne plugin gurnalanlaryň sanawynda hiç haçan peýda bolmaýar. Ret edilmegiň sebäbi derwezäniň gündeligine ýazylýar — dolandyryş panelinde Gündelikler bölümini açyň.

Şu gün näme işleýär:

  • resmi katalogdaky AiHummer pluginleri — adatdakysy ýaly gurnalýar, olarda başga, hereket edýän gol bar;
  • HTTP arkaly MCP serweri — işläp taýýarlamazdan gural çeşmesi hökmünde birikdirilýär, kod siziň tarapyňyzda galýar;
  • OpenAPI spesifikasiýasy boýunça integrasiýa — şonuň ýaly, hyzmat gurnamazdan.

Öz pluginiňizi el bilen ýüklemek gol barlagyndan geçýär, ýöne diňe HTTP arkaly uzakdaky MCP ýa-da OpenAPI integrasiýasy hökmünde işlär; şol serwerde hyzmat hökmünde başladylmaly ýygnama ret edilýär.

Şahsy režim — ünsüňize öňünden ýükle

Munyny diňe plagin gerek bolan wagty ulanyň: içerki birikdiriji, özleşdirilen integrasiýa, synag gurnama.

Basgançaklar

  1. Gaplamany gaplaň we gol çekiň: 
    aihummer plugin package ./my-plugin
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz
  2. Ony iki usuldan birini ulanyp instansiýa ýükläň:
    • Admin UI → Plugins → «Plugin beýlekle» — paketi çek; ýa-da
    • CLI: 
      aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz
  3. Bulyn aşagynda bu POST /v1/admin/modules/upload (çäkli partýalar, integrations:write): artefakt uçýar içine mysal blob saklaýyş (AIHUMMER_BLOB_DIR) aşagynda blob: ref, we katalog setiri bilen hasaba alnan origin = local-private, visibility = private.
  4. Plugin bazarda belliklenen görnüşde görünýär Şahsy we … üsti bilen gurýar kadaly ýol — sandboksyň içinde bolup duran systemd bölümi + saglyk gapysy.

Ynanç: toplumlanan açar we ynanç dükanı

Şahsy sungat eserleri gol çekilmeli. Näbelli açar bilen gol çekilen plagin ýüklediňizde, Dolandyryjy UI size teklip berýär awtoryň açary tassyklamak instansiýa ynam saklaýjysyna (bir gezek basmak bilen) girizilýär. Tassyklanan soň, gol ýazylyşy her gurnama we täzelikde barlanýar.

  • Şol ýerde tapylan eserler resmi Çeşmä garanyňyzda tassyklamak hasplanylan registr açary esasynda — standart ýagdaýda ynanlary, goşmaça ädim gerek däl.
  • Şahsy artifaktlar mysal ynam dükanyndaky açarlara garşy barlanýar.
  • Imzalanmady toplamlar ret edilýär — diňe ýerli gaýtalaw üçin dev režiminde bolmazdan: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 gol çekişleri barlagyny öçürýär we niýetlenendir diňe ýerli öňe gidiş üçin. Ony daşarky elýeterli nusgada hiç haçan açmaň.

Jemgyýetçilik režimi — şahsy kabinet arkaly çap etmek

Bir plagin elýeterli etmek üçin her meselem, ony özüňizden neşir ediň şahsy kabinet at my.aihummer.ru, programmany goşmaça dükanlaryna çap edýän usulyňyz ýaly. Siz gurluşy ýükläp, dükan sahypasyny doldurýar we barlag üçin iberýärsiňiz; ilkinji nobatda awtomatiki AI barlagy geçýär, soňra adam moderator iň soňky karary berýär, we tassyklananda artefakt gol çekilip, jemgyýetçilik katalogyna çykarylýar.

Täze-täze ädim beýnünde görkezme elýeterli Plugin-i tabşyrmak. Gysgaça aýdanyňda:

  1. Gurluş we gaplama SDK bilen siziň pluginiňiz (aihummer plugin package) — artefakt gol çekilen .tar.gz özüniň bilen alyp barýan manifest.json.
  2. «Meniň goşundylarym»-y aç deşikte we tabşyrma döret: ýükle artykul, dolduryň maglumatlaryň metainfo maglumaty (ady we düşündirişleri RU + EN-de, wersiýa, ikonka, skrinşotlar, kategoriýa, islege bagly sadaka baglanyşygy, üýtgeşmeler sanawy) we yglan et ukyp-bashy ýüze çykarmak.
  3. Gözden geçirmek üçin iberiň. Avtomatlaşdyrylan AI baha beriş tabşyrygy bilen deňeşdirýär şu syýasaty gözden geçirmek (howpsuzlyk, ýüze çykarmak) dogrulyk, dolulyk, mazmuny), soňra bir adam ýolbaşçysy hasabaty okaýar we karar berýär. Awtomatlaşma hiç haçan özbaşdak çap etmeýär.
  4. Tassyklananda bu eseri gol çekilen we çap edildi ayıraýmak community-catalog.json CDN-de. Goşulan her bir nusga daşky çeşme modulyny görýär; esasy bolsa ony ynanýar bellenen registri açary — operatoryň özara ynam basgysy gerek däldir.

[!NOTE] Köne umumy neşir etmek akymy hyzmatdan aýryldy; ýokarydaky şahsy kabinet akymy — «Meniň goşundym» — jemgyýetiň ýeke-täk neşir etmek ýoludyr. Jemagat plaginleri mugt; islän ýagdaýyňyzda goşmaça sadaka baglanyşygyny goşup bilersiňiz.

[!NOTE] Birinji tarap goşundylary (Einstein, SIP, Bitrix24, pocket-agent, os-client) bolup durýar şu görnüşde neşir edilmeýär — olar öz AiHummer CI ulgamynda iberilýär we ýere düşýär berilen resmi katalog. Şahsy kabinet akymy üçin jemagat (üçünji tarap) pluginler.

Ýumşaklyk

Her jemgyýet tarapyndan berlen arza üsti bilen barlanýar awtomatlaşdyrylan barlag (dolylyk, mümkinçilik manifesti, gol goýmak we howpsyzlyk skanirlemesi), soňra bir AI howpy gözden geçiriş, we ahyrsoň qürrä meşhur adam gözden geçiriş AiHummer topary tarapyndan. Awtomatlaşdyryş hem-de AI hiç haçan özbaşdak neşir etmeýär — karar hemişe moderatoryňyzdyr, we olaryň tassyklamasy bolmazdan hiç zat kataloga ýetýär. Soňundan zyýanly ýa-da işlemeýän diýlip tapylan neşir edilen plugin bolsa ýatyrylan we soňky sinhronizasiýada katalogdan çykaryldy.

Jemgyýet katalogy goşmaça çeşme hökmünde

Jemgyýetçilik goşundylary birine neşir edilýär ayıraýmak community-catalog.json şol edýär däk öň öňünden taýýarlanan birinji tarap katalogyny ýazyp geçýär. Bir nusga ony goşmaça çeşme hökmünde goşýar Pluginler → Çeşmeler (ýa-da POST /v1/admin/modules/catalog/sources). Göz aýla Gurnama we täzelenmeler we Görnüş we derejeler.

Plugin ömri (App Store)

Bazar hakykatdanam bir App Store ýaly işleýär — her bir goşmaça modulda bar şahsyýet (daimi slak + awtor) öňünden iberýän ýagdaýynda wersiýalar.

Wersiýalar we täzelenmeler

Täzelenme hökmünde çykarylýar täze wersiýa aldan neşir edilen plagin: şol bir slug, onuň öz üýtgeşmeler sanawy, onuň öz syn we dolandyryş tizligi. Diňe bir bir wersiýa bir wagtda gözden geçirilişde bolup biler — siz indiki wersiýany häzirki wersiýa karar berilenden soň tabşyrýarsyňyz. Täze wersiýa neşir edilende, öňküsi bellendigi bolýar superseded, we katalog + her bir nusga täzäsi bilen göçürilsin.

Çap etmegi meýilleşdirilen

Bir moderator muny tassyklandan soň, awtor neşiri dolandyrýar: häzir çykarmak ýa-da anyk bir wagta meýilleşdirmek — goşmaça bellenilen wagtynda iş başyna geçýär.

Neşirden aýyrmak

  • Ündürmek — bölümi wagtlaýyn gizlemek: ol jemgyýetçilik katalogyndan we ulgamlardan çykarylýar (indiki sinhronizasiýada), ýöne saklanyp galýar we bolup bilýär täzeden neşir edilen islendik wagtda.
  • Sanawdan çykarmak — plagininiň bazardan hemişelik aýrylmagy.

Plugin neşirden aýrylanda (üçürilen ýa-da sanawdan aýrylan), onuň girizmesi öçürilýär community-catalog.json, we beýleki ýagdaýlarda onuň indiki sinhronizasiýada görkezilmegini togtadýar.

Awtorçylyk

Plugin aşakdaky şertler bilen çap edilýär siziň görkezme adyňyz (meselem, studiiýanyňyzyň ady) — ýa-da aty syzylman. Jemgyýetçilik katalogy we nusga Web ulanyjy interfeýsi saýlanan adyňyz ýa-da “Anonim” diýen ady görkezýär; hakyky elektron poçtaňyz/identifikasiýaňyz asla mälim edilmeýär.

Öndüriji statistikalary

Her bir goşmaça modulda bar jemleýji statistika: göçürmeler, gurnamalar, işjeň nusgalar we gurnamalary bozmak, şeýle-de her gün üçin diagramma. Jemi sanlar diňe — bir görnüşde-de maglumat developer bilen paýlaşylmaýar.

Neşir baýragy

Üçin her plugin-iňizi ilkinji gezek çap edeniňiz, siziň AiHummer abunalygyňyz bolýar bir mugt aý (her bir plugin üçin bir gezek berilýär).

Indiki nirede