AiHummer
Türkmençe▾
Gir
v1.0.x▾
v1.0.xstable
{ }Swagger
Marketpleýs we pluginler/Şahsy kabinet arkaly plagin ibermek

Şahsy kabinet arkaly plagin ibermek

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

Community-marketpleýs islendik hasaba alnan ulanyja plagin neşir edip, ony hemmeleriň gurnap bilmegine mümkinçilik berýär — dükana (app store) programma ýerleşdirişiňiz ýaly. Siz dükan sahypasynyň metadatalaryny dolduryp, plaginiňize haýsy hukuklaryň gerekdigini yglan edip, ýygnalan gurluşy ýükläp, ony barlaga iberýärsiňiz. Bu sahypa siziň ähli işiňizi ädimme-ädim geçirer.

[!NOTE] Bu akym my.aihummer.ru salgysyndaky şahsy kabinetiňiz arkaly iberilýän community (üçünji tarap) plaginler üçindir. AiHummer-iň öz (first-party) plaginleri öz konweýeri boýunça çykýar. Community-plaginler mugtdur; islege bagly donat baglanyşygyny goşup bilersiňiz.

Başlamazdan öň

  1. Hasaba alnan şahsy kabinet hasaby — hasaba duruň we ony tassyklaň (Hasaba alyş sahypasyna serediň). Islendik ulanyjy plagin iberip biler.
  2. Ýygnalan plagin — Plugin SDK bilen ýygnalan gol çekilen reliz tarbal (aihummer plugin package). Eger entek ony ýygnamadyk bolsaňyz, ilki şol ýerden başlaň.
  3. Nyşan we azyndan bir ekran suraty, hem-de rus we iňlis dilleriniň ikisinde-de taýýar beýanlaryňyz.

Neşir nähili işleýär (umumy görnüş)

Siziň arzaňyz kesgitli konweýerden geçýär. Onuň statusyna her ädimde kabinetde syn edip bilersiňiz.

Etap Näme bolýar Kim hereket edýär
Taslama Ýazgyny döredip metadatalary dolduryňyz; entek hiç zat köpçülige açyk däl. Siz
Iberildi Siz ony barlaga iberýärsiňiz. Siz
AI-barlag Awtomatlaşdyrylan agent plagini barlag syýasaty boýunça barlaýar — howpsuzlyk, manifestiň dogrulygy, dolulyk, mazmun. Awtomatika
Moderasiýa Adam-moderator AI hasabatyny, şeýle hem siziň artefaktyňyzy we metadatalaryňyzy okap, karar berýär. AiHummer topary
Neşir edildi Tassyklanandan soň artefakt gol çekilip, community-kataloga hem-de köpçülige açyk marketpleýs witrinasyna goşulýar. AiHummer topary
Ret edildi Bir zat geçmese, sebäplerini alarsyňyz; düzediň we gaýtadan iberiň. Siz → yzyna Taslama

[!IMPORTANT] AI hiç haçan özbaşdak neşir etmeýär. Ahyrky karary hemişe adam berýär we onuň tassyklamasyz hiç zat kataloga düşmeýär.

1-nji ädim — «Meniň plaginlerim» bölümini açyň

my.aihummer.ru salgysyna giriň, «Meniň plaginlerim» bölümini açyň we «Neşir etmek» (ýa-da «Täze plagin») düwmesine basyň. Bu, ibermezden öň erkin redaktirläp boljak taslama döredýär.

2-nji ädim — Dükan metadatalaryny dolduryň

Ähli meýdanlary dolduryň. Doly däl metadatalar — arzanyň yzyna gaýtarylmagynyň iň ýygy sebäpleriniň biri.

Meýdan Näme girizmeli
Ady (RU + EN) Plaginiň iki dildäki görkeziliş ady.
Gysgaça beýany (RU + EN) Katalog kartoçkasy üçin bir setir.
Doly beýany (RU + EN) Plaginiň näme edýändigi, ony nädip ulanmaly, näme gerekdigi. Manyly — dolduryjy nusga däl.
Kategoriýa Rugsat berlen toplumdan birini saýlaň (meselem: Kanallar, Öndürijilik, Integrasiýalar, Ses, Utilitalar).
Wersiýa semver formatly setir, meselem 1.0.0. Her täze arza ony ulaltmaly.
Nyşan Ýaramly kwadrat şekil.
Ekran suratlary Azyndan biri; plagini iş üstünde görkezýän.
Lisenziýa Plaginiň lisenziýasy (meselem MIT, Apache-2.0).
Sahypa / repozitoriý Taslamaňyza islege bagly https:// baglanyşygy.
Donat baglanyşygy Islege bagly. Meşhur donat-hosta ýaramly https:// baglanyşyk — meselem Boosty, Patreon, PayPal ýa-da ÝuMoney. Fişing ýa-da erkin hostlar ret edilýär.
Changelog (RU + EN) Bu wersiýada näme üýtgedi.

[!TIP] Beýanlary siziň plaginiňizi hiç haçan görmedik hakyky ulanyjy üçin ýazyň. «Düşünmeýänler üçin» — bu edil gerek zat: ol näme edýär, haçan ulanmaly we oňa näme gerek diýip aýdyň.

3-nji ädim — Mümkinçilik manifestini yglan ediň

Mümkinçilik manifesti — howpsuzlyk modeliniň ýüregi. Bu, plaginiňize gerek bolan ähli hukuklaryň gysga, gurluşly yglany: ol haýsy hostlar bilen gürleşýär, haýsy faýllara degýär, daşarky buýruklary ýerine ýetirýärmi, haýsy kanallary we ygtyýarnamalary ulanýar.

Näme üçin ony yglan etmeli

  • Ulanyjylar soralýan hukuklary gurnamazdan öň görüp, mobil programmanyň rugsat soragy ýaly olara razylyk berýärler.
  • Instans manifesti ulanyp, plagini onuň yglan edenleri bilen çäklendirýär.
  • Barlaýjylar siziň yglan eden mümkinçilikleriňiziň kodyň hakykatda edýän işine gabat gelýändigini barlaýarlar. Yglan etmedik hukugyna ýapyşýan plagin ret edilýär.

Iň az hukuk prinsipi

Plaginiňiziň hakykatdan-da ulanýan zatlaryny diňe yglan ediň, artykmaç hiç zat. Az hukuk — çalt barlag, ulanyjynyň razylygynyň aňsatlygy we köp gurnama diýmekdir. Faýl ulgamyna degmeýän bolsaňyz, boş sanaw yglan ediň. Prosesi hiç haçan işletmeýän bolsaňyz, exec meýdanyny false ediň.

Format

Mümkinçilik manifesti şu meýdanlary bolan JSON-obýektidir:

Meýdan Görnüş Manysy
network string[] Plaginiň birleşýän host atlary (onuň çykyş allowlist-i).
filesystem string[] Onuň öz plagin katalogyna görä okaýan ýa-da ýazýan ýollary.
exec boolean Ol daşarky prosesleri işledýärmi / buýruklary ýerine ýetirýärmi.
channels string[] Ol integrasiýa edýän habarlaşma kanallary (meselem telegram).
credentials string[] Ol ulanýan atlandyrylan gizlinlikler/konfig açarlary (hiç haçan gizlin bahalary däl).
description string Oňa näme we näme üçin gerekdiginiň gysga, adam okap boljak beýany.

Mysal:

{
  "network": ["api.example.com", "cdn.example.com"],
  "filesystem": ["./cache"],
  "exec": false,
  "channels": ["telegram"],
  "credentials": ["api_token"],
  "description": "Wezipeleri sinhronlamak üçin Example API-a ýüzlenýär we Telegram-a jogaplary iberýär. Jogaplary öz ./cache katalogynda keşleýär. Proses işletmeýär, başga hostlary ulanmaýar."
}

[!WARNING] Hakyky gizlinlikleri, tokenleri ýa-da açarlary hiç ýere goýmaň — ne manifeste, ne metadata, ne artefakta. Ygtyýarnamalary diňe at boýunça yglan ediň (meselem api_token); hakyky bahany ulanyjy gurnama wagtynda berýär. Koda berk ýazylan gizlinlikler — awtomatiki ret ediş.

4-nji ädim — Artefakty ýükläň

Plaginiňiziň ýygnalan gurluşyny ýükläň:

  • Format: aihummer plugin package tarapyndan öndürilen .tar.gz reliz tarbaly.
  • Ol plaginiň manifest.json faýlyny (SDK-manifest — kind, wersiýa, giriş nokady, yglan edilen capabilities, konfig meýdanlary) saklamaly.
  • 3-nji ädimde dolduran mümkinçilik manifestiňiz kodyň we manifest.json-yň hakykatda edýän işi bilen ylalaşykly bolmaly.

Eger entek etmedik bolsaňyz, nyşany we ekran suratlaryny hem şu ýerde goşýarsyňyz.

[!TIP] Ýüklemezden öň ýerli ýagdaýda aihummer plugin validate işlediň. Barlag şertnamasy marketpleýsiň ulanýany bilen birmeňzeşdir, şonuň üçin ýerli geçen manifest bu ýerde-de kabul ediler.

5-nji ädim — Barlaga iberiň

Ähli meýdanlar dolduryldy we artefakt ýüklendi bolsa, «Barlaga ibermek» düwmesine basyň. Kabinet ilki dolulyk barlagyny geçirýär; bir zat ýetmese, näme ýetýändigini takyk aýdar. Kabul edilenden soň status Iberildi, soňra AI-barlag ýagdaýyna geçýär — başga hiç zat etmeli däl.

6-njy ädim — Statusa yzarlaň we verdikti okaň

Statusyny yzarlamak üçin plagini «Meniň plaginlerim» bölüminde açyň. Barlag tamamlananda şulardan birini görersiňiz:

  • Moderasiýada — awtomatiki barlag geçdi ýa-da diňe ownuk zatlary belledi; indi ony adam seredýär. Diňe garaşyň.
  • Ret edildi — bir zat geçmedi. Siz verdikti, gysgaça mazmuny we geçmedik anyk bentleri (her biriniň sebäbi bilen) görersiňiz. Bu siziň düzediş sanawyňyz.
  • Neşir edildi — tassyklandy, gol çekildi we işjeň. Plaginiňiz indi AiHummer marketpleýsinde peýda bolýar we community-katalog açylan islendik instansa gurnalýar.

Ret edişi nädip okamaly we gaýtadan ibermeli

  1. Plagini açyň; geçmedik bentleri we olaryň sebäplerini okaň.
  2. Olary düzediň — köplenç şulardan biri: ýetmeýän/gowşak beýan, gabat gelmeýän mümkinçilik manifesti, koda berk ýazylan gizlinlik, erbet donat baglanyşygy ýa-da ulaltmadyk wersiýaňyz.
  3. Metadatalary redaktirläň we/ýa-da ulaldylan wersiýaly täze artefakt ýükläň.
  4. Ýene «Barlaga ibermek» düwmesine basyň. Ol şol bir konweýerden geçýär.

[!NOTE] Ret ediş — jeza däl, ol barlag sanawydyr. Barlag syýasaty edil şonuň üçin köpçülige açyk — ibermezden öň ähli talaby ýerine ýetirip bilmegiňiz üçin.

Indi nirä