Installation og opdateringer

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

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

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

Installation af et plugin i AiHummer er et enkelt klik i administrationsgrænsefladen, men bag det klik er der en deterministisk, vært-native livscyklus. Platformen downloader pluginet, udfører dets erklærede installations trin, gengiver en **sandboxed systemd-enhed**, og betragter kun pluginnet som sundt, når det svarer på en sundhedskontrol. Hver installation holder sig derefter opdateret på egen hånd. ## Én-klik installation fra admin-brugerfladen Du installerer og administrerer plugins fra admin-brugergrænsefladen, som understøttes af admin-modulets API: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Modul-sluggen skal i JSON-anmodningens indhold, ikke i stien: ```json { "slug": "einstein", "version": "" } ``` Der er ikke noget at forbinde manuelt: vælg et plugin fra kataloget, klik på installer, og udruleren tager over. > [!NOTE] > Installation af en kanalforbinder uden for kernepakken (kun Telegram) > kræver en aktiv **Starter**, **Forretning** eller **Foretagende** licens. > På Community-planen returnerer en sådan forespørgsel **HTTP 402 "opgradering påkrævet"** > (kode `plan_limit`) — se [Licensiering](/da/v1.0/commercial/licensing). > [!NOTE] > Den **Einstein** hukommelsesplugin er **indbygget**: det installeres automatisk, > bærer et "Indbygget" badge og kan ikke fjernes eller stoppes. ## SystemdDeployer-flowet Under motorhjelmen **SystemdDeployer** udfører disse trin: 1. **Download en tarball** for den valgte plugin. 2. **Kør manifestet `install[]` trin** deklareret af plugin'et. 3. **Gengiv en sandboxet systemd-enhed** til pluginen. 4. **Meningsmåling `/healthz`** indtil tjenesten rapporterer sund. ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` Kun når `/healthz` lykkes, markeres installationen som aktiv — en plugin, der ikke kommer op, tæller ikke stiltiende som installeret. ## Host-native, sandboxet systemd — ikke Docker Hvert plugin kører som **sin egen sandboxede systemd-tjeneste**. Der er ingen containere, ingen Docker, ingen orkestrator: et plugin er en administreret Linux-tjeneste med sin egen enhed, port- og sandboxbegrænsninger, overvåget af systemd ligesom resten af installationen. > [!WARNING] > AiHummer er vært-native. Plugins implementeres som sandkasse-systemd-tjenester > fra en udgivelsestarball — **aldrig som Docker-containere.** Hvis en guide fortæller dig > at "køre plugin-containeren", beskriver det ikke AiHummer. ## Sundhedsgodkendelse med /healthz Udruleren spørger plugin'ens `/healthz` endepunktet før erklæring af succes. Denne sundhedskontrol er det, der gør installation med ét klik sikker: en defekt eller forkert konfigureret plugin bliver fanget under installationen i stedet for at blive opdaget senere i produktionen. ## Auto-opdatering pr. installation Opdateringer håndteres **pr. installation**. Hver installeret plugin kan opdatere sig selv automatisk efter sin egen tidsplan, så det at holde plugins opdaterede kræver ikke en manuel geninstallation hver gang en ny version når kataloget. De samme download → installations trin → rendeenhed → sundhedskontrol flow kører for en opdatering som for en første installation. > [!TIP] > Fordi automatisk opdatering er pr. installation, kan du beholde nogle plugins fastgjort, mens > lade andre følge med i det seneste — hver installation styrer sin egen livscyklus. ## Katalog med flere kilder Kataloget er ikke længere bundet til en enkelt URL. **fællesskabskatalog** af tredjepartsplugins leveres som en indbygget **standard kilde** (forudindlæst ved installation) — du tilføjer det ikke selv. I **Plugins → Kilder** (Admin UI, eller `POST /v1/admin/modules/catalog/sources`) du kan tilføje dine egne ekstra kilder. Gatewayen synkroniserer hver aktiveret kilde ved opstart og ved auto-opdateringsintervallet. - Den **officiel kilde** (førstepartsmoduler) er som standard fastlåst og betroet — et separat objekt, der er **ikke overskrevet** af andre kilder. - Den **fællesskabskatalog** er en standardkilde med frø; **private kilder** er tilføjet af operatøren. Hver katalogpost har en `origin`, og det `origin` beslutter hvilken anker signaturen verificeres på mod (officiel → fastgjort nøgle, privat → tillidslager). For offentliggørelse i fællesskabskataloget, se [Publicering af en plugin](/da/v1.0/marketplace/publishing). ## Tillidsmodel og den fastlåste nøgle Installation bekræfter en plugins signatur ud fra dens kilde: - **officiel** → verificeret mod **registreringsdatabasenøgle fastgjort i kerne**. Betroet af standard, ingen operatørhandling. - **privat** (side-load) → verificeret mod **instans-tillidslager**; forfatternøgle godkendes af operatøren ved upload (et klik). - **usigneret** → afvist, undtagen i udviklingstilstand (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, kun lokal udvikling). > [!WARNING] > **Fællesskabets plugins kan ikke installeres lige nu — det er ikke en > forbindelsesfejl.** Nøglen, der signerede fællesskabskataloget, er trukket > tilbage; indtil en ny nøgle udkommer, afviser signaturkontrollen disse poster. > Uafhængigt af det køres tredjepartskode endnu ikke som en tjeneste på din > server: indtil et isoleret kørselsmiljø findes, tillades kun integrationer, der > kører hos sig selv og forbinder over netværket. > > **Det du ser:** efter klik på «installer» vises den sædvanlige besked > «installerer», men pluginet **dukker aldrig op** på listen over installerede. > Årsagen til afvisningen havner i gatewayens log — åbn **Logfiler** i > administrationspanelet. > > **Det, der virker i dag:** > > - **plugins fra AiHummer** i det officielle katalog — de installeres som > sædvanligt og bærer en anden, gyldig signatur; > - **en MCP-server over HTTP** — tilsluttet som værktøjskilde uden udvikling, > koden bliver hos dig; > - **en integration via OpenAPI-specifikation** — det samme, uden tjeneste at > installere. > > Sideindlæsning af dit eget plugin består signaturkontrollen, men kører kun som > **fjern-MCP over HTTP** eller OpenAPI-integration; et build, der skal startes > som tjeneste på den samme server, afvises. ## Underskrevne opdateringer En opdatering **kører den samme signaturport igen** som den første installation: når der skiftes til en ny version, verificeres signaturen igen mod det samme tillidsanker. En opdatering **kan ikke omgå** tjekket — du kan ikke øge tillid gennem en opdatering. ## Det officielle badge og rang I Web UI-katalogen har plugins fra AiHummer en **Officiel** mærke og rang første. Tredjeparts plugins vises uden mærke og sorterer **efter antal downloads**. Den officielle flag stammer fra en deltagers bidrag `origin` (officiel) — det kan ikke indstilles manuelt i manifestet. ## Hvor til næste - [Markedspladsoversigt og niveauer](/da/v1.0/marketplace/overview-tiers) — hvad pokker tre plugin-niveauer er. - [Plugin SDK](/da/v1.0/marketplace/sdk) — `manifest.json` hvis `install[]` trin denne livscyklus kører. - [Publicering af en plugin](/da/v1.0/marketplace/publishing) — privat sidelastning og fællesskabspublicering via det personlige kabinet. - [Integrationer uden kode](/da/v1.0/marketplace/zero-code) — tilføj OpenAPI/MCP-værktøjer uden nogen service at installere.