Paigalda ja uuendused

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

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

download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

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: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Mooduli lühinimi läheb JSON-päringu kehasse, mitte teele: ```json { "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](/et/v1.0/commercial/licensing). > [!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. ```text 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](/et/v1.0/marketplace/publishing). ## 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 - [Turul ülevaade ja tasemed](/et/v1.0/marketplace/overview-tiers) — mis ... kolm pistikprogrammi taset on. - [Plugina SDK](/et/v1.0/marketplace/sdk) — see `manifest.json` kelle `install[]` sammud, mida see elutsükkel käivitab. - [Plugina avaldamine](/et/v1.0/marketplace/publishing) — privaatne külglaadimine ja ühenduse väljaandmine läbi isikliku kabineti. - [Nullkoodiga integratsioonid](/et/v1.0/marketplace/zero-code) — lisa OpenAPI/MCP tööriistad ilma teenust paigaldamata.