AiHummer
Eesti▾
SisselogimineKonto
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Turg ja lisandmoodulid/Paigalda ja uuendused

Paigalda ja uuendused

v1.2.x · uuendatud 2026-07-05

AiHummeris plugina installimine on administraatori kasutajaliideses ühe klõpsuga, kuid selle klõpsu taga on deterministlik, hosti-lokaalne elutsükkel. Platvorm laadib plugina alla, käivitab selle deklareeritud installimisetapid, kuvab a liivakastitud systemd-üksus, ja peab pluginat tervislikuks ainult siis, kui see vastab tervisekontrollile. Iga installatsioon hoiab seejärel iseennast ajakohasena.

Ühe klikiga installimine administreerimise liidese kaudu

Sa installeerid ja haldad pluginaid administraatori kasutajaliidese kaudu, mida toetab administraatori mooduli API:

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

Mooduli lühinimi läheb JSON-päringu kehasse, mitte teele:

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

Pole midagi käsitsi ühendada: vali kataloogist pistikprogramm, klõpsa installi ja juurutaja võtab üle.

[!NOTE] Kanalikonnektori paigaldamine väljaspool põhikomplekti (ainult Telegram) nõuab aktiivset Algaja, Äri või Ettevõte litsents. Kogukonna plaanil tagastab selline taotlus HTTP 402 „uuendamine vajalik“ (kood plan_limit) — see Litsentseerimine.

[!NOTE] See Einstein mälu pistikprogramm on sisseehitatud: see installib ennast automaatselt, kandis märgist „Sisseehitatud“ ja seda ei saa eemaldada ega peatada.

SystemdDeployeri voog

Kapoti all SystemdDeployer täidab need sammud:

  1. Laadi alla tarball valitud pistikprogrammi jaoks.
  2. Käivita manifest install[] astmed määratud pistikprogrammi poolt.
  3. Renderda sandboxitud systemd-ühik pistikprogrammi jaoks.
  4. Uuring /healthz kuni teenus teatab, et on terve.
download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

Ainult siis, kui /healthz installatsioon märgitakse aktiivseks, kui see õnnestub — plugin, mis ei käivitu, ei loeta vaikides paigaldatuks.

Hosti-põhine, liivakastis systemd — mitte Docker

Iga pistikprogramm töötab kui oma eraldatud systemd-teenus. Pole konteinerite, pole Dockerit, pole orkestreerijat: plugin on hallatud Linuxi teenus omaenda ühiku, pordi ja liivakasti piirangutega, mida jälgib systemd nagu ülejäänud installi puhul.

[!WARNING] AiHummer on hosti-sisemine. Pluginad paigaldatakse liivakastitud systemd teenustena väljaandedatud tarballist — mitte kunagi Docker konteineritena. Kui giid ütleb sulle et “käivitada pistikprogrammi konteiner”, see ei kirjelda AiHummerit.

Tervise kontroll /healthz abil

Paigaldaja küsib pistikprogrammi /healthz lõpp-punkt enne edu deklareerimist. See tervisevärav on see, mis teeb ühe-klõpsuga installi turvaliseks: purunenud või valesti konfigureeritud pistikprogramm tabatakse installimise ajal, mitte hiljem tootmises.

Iga installi puhul automaatne uuendus

Uuendusi hallatakse paigaldamise kohta. Iga installitud plugin saab automaatselt oma graafiku järgi uuendada, nii et pluginate ajakohasena hoidmiseks ei ole vaja iga uue versiooni ilmumise korral käsitsi uuesti installida. Sama allalaadimine → installimine → renderdusüksus → tervisekontrolli protsess käib värskenduse puhul samamoodi nagu esmasel installimisel.

[!TIP] Kuna automaatvärskendus on iga paigalduse kohta, saate mõned pistikprogrammid kinnitatuna hoida, samal ajal kui lastes teistel jälgida viimast — iga paigaldus haldab oma elutsüklit.

Mitmeallikaga kataloog

Kataloog ei ole enam seotud ühe URL-iga. kogukonna kataloog kolmandate osapoolte pistikprogrammidest tarnitakse sisseehitatuna vaikesäte (installimisel etteantud) — sa ei lisa seda ise. Selles Pistikprogrammid → Allikad (Admini liides, või POST /v1/admin/modules/catalog/sources) saate lisada ka oma täiendavaid allikaid. Värav sünkroonib käivitamisel ja automaatse värskenduse intervalli ajal kõiki lubatud allikaid.

  • See ametlik allikas (esmakordsete osade moodulid) on vaikimisi külmutatud ja usaldusväärsed — eraldi objekt, mis on mitte üle kirjutatud teiste allikate järgi.
  • See kogukonna kataloog on eelseatud vaikeallikas; privaatallikad olevad lisatud operaatori poolt. Iga kataloogi kirje sisaldab üks origin, ja see origin otsustab, millist ankrut allkiri kontrollitakse vastu (ametlik → kinnitatud võti, privaatne → usalduspoest).

Kogukonna kataloogi avaldamiseks vaadake Plugina avaldamine.

Usaldusmudel ja kinnitatud võti

Installeerimine kontrollib plugina allkirja selle allika järgi:

  • ametlik → kontrollitud suhte tuumasse kinnitatud registrivõti. Usaldatud vaikimisi, operaatori tegevust ei toimu.
  • privaatne (külgedele laadimine) → kontrollitud vastavuses eksemplari usaldusandmebaas; see Autori võti on üleslaadimisel operaatori poolt heaks kiidetud (üks klõps).
  • allkirjastamata → tagasi lükatud, välja arvatud arendaja režiimis (AIHUMMER_PLUGIN_DEV_UNSIGNED=1, ainult kohalik areng).

[!WARNING] Kogukonna pistikprogramme ei saa praegu paigaldada — see ei ole ühendusetõrge. Võti, millega kogukonna kataloogi allkirjastati, on tagasi võetud; kuni uus võti välja tuleb, lükkab allkirjakontroll need kirjed tagasi. Sellest sõltumatult ei käivitata kolmanda osapoole koodi veel teenusena teie serveris: kuni isoleeritud käituskeskkonda pole, on lubatud ainult integratsioonid, mis töötavad omal poolel ja ühenduvad üle võrgu.

Mida näete: pärast „paigalda” vajutamist ilmub tavapärane teade „paigaldatakse”, kuid pistikprogramm ei ilmu kunagi paigaldatute loendisse. Keeldumise põhjus läheb lüüsi logisse — avage halduspaneelis Logid.

Mis täna töötab:

  • AiHummeri pistikprogrammid ametlikust kataloogist — need paigalduvad tavapäraselt ja kannavad teist, kehtivat allkirja;
  • MCP-server üle HTTP — ühendatakse tööriistaallikana ilma arenduseta, kood jääb teie poolele;
  • OpenAPI-spetsifikatsiooni järgi integratsioon — sama, ilma paigaldatava teenuseta.

Oma pistikprogrammi kõrvallaadimine läbib allkirjakontrolli, kuid käivitub ainult kaug-MCP-na üle HTTP või OpenAPI-integratsioonina; ehitis, mis tuleks käivitada teenusena samas serveris, lükatakse tagasi.

Allkirjastatud uuendused

Uuendus käivitab sama signatuuri värava uuesti nagu esimene install: uuele versioonile liikumisel kontrollitakse allkirja uuesti sama usaldusjuure vastu. Uuendus ei saa mööda minna kontroll — te ei saa usaldust värskenduse kaudu tõsta.

Ametlik märk ja auaste

Veebiliidese kataloogis sisaldavad AiHummeri pluginad Ametlik märgis ja kraad esimesena. Kolmanda osapoole pluginad kuvatakse ilma märgita ja sorteeritakse allalaadimiste arvu järgi. Ametlik lipp on tuletatud ühe osavõtu põhjal origin (ametlik) — seda ei saa manifestis käsitsi määrata.

Kuhu järgmine