AiHummer
Lietuvių▾
PrisijungtiPaskyra
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Turgavietė ir įskiepiai/Įskiepio publikavimas

Įskiepio publikavimas

v1.0.x · atnaujinta 2026-07-19

Sukūrė papildinį su Įskiepio SDK? Jūs galite tai paskelbti du būdai:

  • Privatus (sau) — įkelkite šalutiniu būdu į jūsų instanciją. Artefaktas niekada palieka tai.
  • Bendruomenė (visiems) — paskelbk per savo asmeninė kabina prie my.aihummer.ru, programėlių parduotuvė stilius: įkelti programos versiją, užpildyti parduotuvės puslapį, praėjus peržiūrą, ir ji patenka į pasirašytas bendruomenės katalogas, iš kurio kiekviena instancija gali įdiegti.

Panašumas: įrengiant .vsix rankiniu būdu (privatu) prieš publikuojant programėlių parduotuvėje (bendruomenei).

[!WARNING] Bendruomenės papildinių dabar įdiegti neįmanoma — tai ne ryšio triktis. Raktas, kuriuo buvo pasirašomas bendruomenės katalogas, atšauktas; kol nepasirodys naujas raktas, parašo tikrinimas tokius įrašus atmeta. Nepriklausomai nuo to, trečiųjų šalių kodas dar nepaleidžiamas kaip tarnyba jūsų serveryje: kol nėra izoliuotos vykdymo aplinkos, leidžiamos tik integracijos, veikiančios savo pusėje ir prisijungiančios tinklu.

Ką pamatysite: paspaudus „įdiegti“ pasirodo įprastas pranešimas „diegiama“, bet papildinys niekada neatsiranda įdiegtųjų sąraše. Atmetimo priežastis patenka į šliuzo žurnalą — atverkite Žurnalai valdymo skydelyje.

Kas veikia šiandien:

  • AiHummer papildiniai iš oficialaus katalogo — diegiami kaip įprasta, jie turi kitą, galiojantį parašą;
  • MCP serveris per HTTP — prijungiamas kaip įrankių šaltinis be programavimo, kodas lieka jūsų pusėje;
  • integracija pagal OpenAPI specifikaciją — tas pats, be diegiamos tarnybos.

Savo papildinio įkėlimas rankiniu būdu praeina parašo tikrinimą, bet veiks tik kaip nuotolinis MCP per HTTP arba OpenAPI integracija; darinys, kurį reikia paleisti kaip tarnybą tame pačiame serveryje, atmetamas.

Privatus režimas — įkelti į savo instanciją

Naudokite tai tik tada, kai jums reikia įskiepio: vidinis jungtis, pasirinktinė integracija, testinė versija.

Žingsniai

  1. Supakuokite ir pasirašykite rinkinį: 
    aihummer plugin package ./my-plugin
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz
  2. Įkelkite jį į instanciją dviem būdais:
    • Administratoriaus sąsaja → Įskiepių tvarkymas → „Įkelti įskiepį“ — vilkite paketą; arba
    • Komandinė eilutė: 
      aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz
  3. Po gaubtu tai yra POST /v1/admin/modules/upload (daugiadalis, integrations:write): reliktas patenka į pavyzdžių blob saugykla (AIHUMMER_BLOB_DIR) po blob: ref, ir katalogo eilutė užregistruota su origin = local-private, visibility = private.
  4. Įskiepis pasirodo rinkoje pažymėtas Privatus ir įdiegia per įprastas kelias — sandėliuku apribota systemd vienetė + sveikatos vartai.

Pasitikėjimas: prisegtasis raktas ir pasitikėjimo saugykla

Privatūs artefaktai turi būti pasirašyta. Kai įkeliate papildinį, pasirašytą nežinomu raktu, administratoriaus sąsaja siūlo jums patvirtinti autoriaus raktą į egzemplioriaus pasitikėjimo saugyklą (vienas paspaudimas). Patvirtinus, parašas tikrinamas kiekvieno diegimo ir atnaujinimo metu.

  • Artefaktai iš oficialus šaltinio patikrinimas prieš registro rakto prisegta pačiame branduolyje — pagal numatytuosius nustatymus patikima, jokių papildomų veiksmų.
  • Privatus artefaktai tikrinami pagal raktais esantį instancijos patikimumo saugyklą.
  • Nepasirašyta paketai atmetami – išskyrus kūrimo režimą vietiniam iteravimui: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 išjungia parašo patikrinimą ir yra skirta tik vietiniam kūrimui. Niekada neįjunkite to išoriniam pasiekiamam instancui.

Bendruomenės režimas — publikuoti per asmeninį kabinetą

Kad įskiepis būtų prieinamas kiekvienas pavyzdžiui, paskelbkite tai iš savo asmeninė kabina prie my.aihummer.ru, taip pat kaip skelbiant programėlę programėlių parduotuvėje. Jūs įkeliate versiją, užpildote parduotuvės puslapį ir siunčiate ją peržiūrai; pirmiausia vyksta automatizuotas AI patikrinimas, tada galutinį sprendimą priima žmogaus moderatorius, ir patvirtinus artefaktas yra pasirašomas ir paskelbiamas bendruomenės kataloge.

Visas žingsnis po žingsnio gidas yra Pateikti papildinį. Trumpai tariant:

  1. Kurti ir supakuoti jūsų įskiepis su SDK (aihummer plugin package) — šis artefaktas yra pasirašytas .tar.gz nešantis savo manifest.json.
  2. Atidaryti „Mano įskiepius“ spintoje ir sukurti pateikimą: įkelti artefaktas, užpildykite saugojimo metaduomenys (vardai ir aprašymai RU + EN, versija, piktograma, ekrano nuotraukos, kategorija, pasirinktina aukojimo nuoroda, pakeitimų istorija) ir paskelbti galimybių manifestas.
  3. Siųsti peržiūrai. Automatizuotas DI peržiūra tikrina pateikimą pagal tas peržiūrėti politiką (saugumas, manifestas teisingumas, išsamumas, turinys), tada a žmogaus moderatorius skaito ataskaitą ir priima sprendimus. Automatika niekada neskelbia pati.
  4. Patvirtinus artefaktas yra pasirašytas ir paskelbta atskirti community-catalog.json CDN. Kiekvienas atvejis, kuris pridėjo bendruomenės šaltinis mato įskiepį; branduolys juo pasitiki per prisegtas registro raktas — nereikia jokių tarpinio operatoriaus pasitikėjimo žingsnių.

[!NOTE] Senasis viešosios publikacijos procesas nutrauktas; aukščiau aprašytas asmeninio kabineto srautas — „Mano papildiniai“ — yra vienintelis bendruomenės leidybos kelias. Bendruomenės papildiniai yra nemokami; galite pridėti neprivalomą aukos nuorodą.

[!NOTE] Pirmosios šalies įskiepiai (Einšteinas, SIP, Bitrix24, pocket-agent, os-client) yra nepaskelbtas tokiu būdu — jie siunčiami per savo AiHummer CI pipeline ir patenka į prisegtasis oficialus katalogas. Asmeninės paskyros srautas skirtas bendruomenė (trečiosios šalies) įskiepiai.

Tarpininkavimas

Kiekvienas bendruomenės pateikimas pereina per automatinė patikra (išsamumas, galimybių manifestas, parašas ir saugumo patikrinimas), tada DI rizikos peržiūra, ir galiausiai a privalomas žmogaus peržiūra AiHummer komandos. Nei automatizavimas, nei dirbtinis intelektas niekada nepaskelbia savarankiškai – sprendimą visada priima moderatorius, ir niekas nepatenka į katalogą be jų patvirtinimo. Paskelbtas modulis, vėliau nustatytas kaip kenksmingas ar neveikiantis, gali būti atšauktas ir buvo pašalinta iš katalogo kito sinchronizavimo metu.

Bendruomenės katalogas kaip papildomas šaltinis

Bendruomenės papildiniai yra skelbiami į atskirti community-catalog.json tai daro ne perrašyti paruoštą pirmosios šalies katalogą. Vienetas prideda jį kaip papildomą šaltinį Įskiepiai → Šaltiniai (arba POST /v1/admin/modules/catalog/sources). Žr. Įdiegimas ir atnaujinimai ir Apžvalga ir lygiai.

Papildinio gyvavimo ciklas (App Store)

Prekyvietė veikia kaip tikroji Programėlių parduotuvė — kiekvienas įskiepis turi tapatybė (nuolatinis slėgis + autorius), pagal kurį jis siunčiamas versijos.

Versijos ir atnaujinimai

Atnaujinimas pateikiamas kaip nauja versija jau paskelbto įskiepio: tas pats slugas, savo pačių pakeitimų žurnalas, savo apžvalgos ir moderavimo sistema. Tik vienas versija gali būti nagrinėjama vienu metu – jūs pateikiate kitą tik tada, kai dabartinė gauna sprendimą. Kai nauja versija paskelbiama, ankstesnė žymima superseded, o katalogas + kiekvienas atvejis perkeltas į naują.

Planuotas publikavimas

Po to, kai tai patvirtina moderatorius, autorius kontroliuoja išleidimą: skelbkite dabar arba suplanuokite tam tikram laikui – įskiepis įsijungia numatytu momentu.

Atšaukti publikavimą

  • Pauzė — laikinas įskiepio paslėpimas: jis iškrenta iš viešosios katalogo ir iš instancijų (kitame sinchronizavime), bet jis išlieka ir gali būti perleista bet kuriuo metu.
  • Pašalinti iš sąrašo — visam laikui pašalinti įskiepį iš rinkos.

Vos tik įskiepis tampa nepublikuotas (sustabdytas arba pašalintas iš sąrašo), jo įrašas pašalinamas iš community-catalog.json, ir atvejai nustoja jį rodyti kitame sinchronizavime.

Autorius

Įskiepis paskelbiamas pagal jūsų vartotojo vardas (pvz., jūsų studijos pavadinimas) — arba anonimiškaiViešasis katalogas ir instancijos žiniatinklio sąsaja rodo pasirinktą vardą arba „Anonimas“; jūsų tikrasis el. pašto adresas/ID niekada nėra atskleidžiamas.

Kūrėjų statistika

Kiekvienas įskiepis turi bendros statistikos: atsisiuntimai, įdiegimai, aktyvūs egzemplioriai ir pašalinimai, taip pat dienos grafikas. Tik suvestinės reikšmės — joks duomenų apie atskirus egzempliorius nebūna atskleistas kūrėjui.

Leidybos atlygis

Už kiekvieną kartą, kai pirmą kartą skelbiate papildinį, jūsų AiHummer prenumerata gauna vienas nemokamas mėnuo (suteikiama vieną kartą kiekvienam papildiniui).

Kur toliau