AiHummer
Lietuvių
PrisijungtiPaskyra
v1.0.x
{ }Swagger

Įdiegimas ir atnaujinimai

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

„AiHummer“ papildinio įdiegimas administratoriaus sąsajoje yra vieno paspaudimo veiksmas, tačiau už to paspaudimo slypi deterministinis, šeimininko natūralus gyvenimo ciklas. Platforma parsisiunčia papildinį, atlieka jo deklaruotus diegimo veiksmus, atvaizduoja apibūdinta smėlio dėžės sistema, ir laiko plėtinį sveiku tik tada, kai jis atsako į sveikatos patikrinimą. Kiekviena instaliacija tada pati atnaujina save.

Vieno spustelėjimo diegimas iš administratoriaus sąsajos

Jūs įdiegiate ir valdote papildinius iš administratoriaus sąsajos, kuri palaikoma administratoriaus modulio API:

GET  /v1/admin/modules
POST /v1/admin/modules/install

Modulio slug yra įdedamas į JSON užklausos kūną, o ne į kelią:

{ "slug": "einstein", "version": "" }

Nereikia nieko sujunginėti rankomis: pasirinkite įskiepį iš katalogo, spustelėkite įdiegti, ir diegėjas pasirūpins viskuo.

[!NOTE] Kanalų jungties diegimas už pagrindinės rinkinio ribų (tik Telegram) reikalauja aktyvaus Starteris, Verslas arba Įmonė licencija. Bendruomenės plane toks prašymas yra grąžinamas HTTP 402 „reikalingas atnaujinimas“ (kodas plan_limit) — žiūrėti Licencijavimas.

[!NOTE] Tas Einšteinas atminties papildinys yra įmontuotas: jis įsidiegia automatiškai, turi „Įmontuoto“ žymeklį ir jo negalima pašalinti arba sustabdyti.

SystemdDeployer srautas

Po gaubtu SystemdDiegėjas atlieka šiuos veiksmus:

  1. Atsisiųsti tarball failą pasirinktam papildiniui.
  2. Vykdykite manifestą install[] žingsniai deklaruota įskiepio.
  3. Pateikti izoliuotą systemd vienetą priedui.
  4. Balsavimas /healthz kol paslauga praneša, kad ji sveika.
download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

Tik kai /healthz Sėkminga yra instaliacija, pažymėta kaip aktyvi — papildinys, kuris nepavyksta įkelti, tyliai nelaikomas įdiegtu.

Kilusio kompiuterio vietinis, izoliuotas systemd — ne Docker

Kiekvienas įskiepis veikia kaip savo atskiras sandboxintas systemd servisas. Nėra konteinerių, nėra Docker, nėra orkestratoriaus: papildinys yra valdomas „Linux“ paslaugos vienetas su savo vienetu, prievadu ir aplinkos apribojimais, prižiūrimas systemd kaip ir likusi diegimo dalis.

[!WARNING] AiHummer yra natyvus serveriui. Įskiepiai diegiami kaip izoliuotos systemd paslaugos iš paleidimo tarball’o — niekada kaip Docker konteineriai. Jei gidė jums sako kad „paleistumėte įskiepių konteinerį“, tai neapibūdina AiHummer.

Sveikatos patikrinimas naudojant /healthz

Diegėjas tikrina įskiepio /healthz galinis taškas prieš paskelbiant sėkmę. Ši sveikatos patikra yra tai, kas daro vieno paspaudimo diegimą saugų: sugadintas arba neteisingai sukonfigūruotas įskiepis yra aptiktas diegimo metu, o ne vėliau gamyboje.

Automatinis atnaujinimas diegimo metu

Atnaujinimai tvarkomi už įrengimą. Kiekvienas įdiegtas įskiepis gali pats atnaujinti save pagal savo tvarkaraštį, todėl įskiepių atnaujinimas nereikalauja rankinio pakartotinio įdiegimo kiekvieną kartą, kai nauja versija pasiekia katalogą. Tas pats atsisiuntimo → įdiegimo → renderio vieneto → sveikatos patikrinimo procesas vyksta atnaujinant, kaip ir pirmą kartą diegiant.

[!TIP] Kadangi automatinis atnaujinimas vyksta pagal diegimą, galite kai kuriuos papildinius laikyti prisegtus, tuo tarpu leidžiant kitiems stebėti naujausią — kiekviena instaliacija valdo savo gyvenimo ciklą.

Daugiašaltinis katalogas

Katalogas nebėra susietas su viena URL. bendruomenės katalogas trečiųjų šalių įskiepiai tiekiami kaip integruota dalis numatytasis šaltinis (įdiegiant užsėta) — jūs jo pats nepridedate. In Įskiepiai → Šaltiniai (Administratoriaus sąsaja, arba POST /v1/admin/modules/catalog/sources) galite pridėti savo papildomus šaltinius. Vartai sinchronizuoja kiekvieną įjungtą šaltinį paleidimo metu ir automatinio atnaujinimo intervale.

  • Tas oficialus šaltinis (pirmųjų šalių moduliai) pagal numatytuosius nustatymus yra užfiksuoti ir jais pasitikima — atskiras objektas, kuris yra neperrašyta pasitelkiant kitus šaltinius.
  • Tas bendruomenės katalogas yra numatytoji šaltinio sėkla; privatūs šaltiniai yra pridėta operatoriaus. Kiekviena katalogo įrašo dalis turi vienas origin, ir tai origin nustato, prie kurio inkaru yra patvirtinamas parašas prieš (oficialus → prisegtas raktas, privatus → pasitikėjimo saugykla).

Norėdami paskelbti bendruomenės kataloge, žr. Įskiepio publikavimas.

Pasitikėjimo modelis ir pritvirtintas raktas

Diegimas patikrina papildinio parašą pagal jo šaltinį:

  • oficialus → patikrinta pagal registro raktas prisegtas branduolyje. Patikima numatytoji, jokių operatoriaus veiksmų.
  • privatus (šoninė įkėlimas) → patikrinta pagal pavyzdžio pasitikėjimo saugykla; autoriaus raktas patvirtinamas operatoriaus įkėlimo metu (vienu spustelėjimu).
  • bežymis → atmesta, išskyrus kūrimo režimu (AIHUMMER_PLUGIN_DEV_UNSIGNED=1, tik vietiniam vystymuisi).

[!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.

Pasirašyti atnaujinimai

Atnaujinimas pakartotinai vykdo tą pačią parašo vartus kaip pirmasis diegimas: pereinant prie naujos versijos, parašas vėl tikrinamas pagal tą patį pasitikėjimo šaltinį. Atnaujinimas negali praleisti patikra — jūs negalite padidinti pasitikėjimo per atnaujinimą.

Oficialus ženklelis ir rangas

Interneto sąsajos kataloge AiHummer įskiepių turinys Oficialus ženklas ir rangas pirmiausia. Trečiųjų šalių įskiepiai rodomi be ženklo ir rūšiuojami pagal atsisiuntimų skaičių. Oficialusis vėliava kilusi iš įrašo origin (oficialu) — jo negalima nustatyti rankiniu būdu manifeste.

Kur toliau