AiHummer
Norsk▾
Logg påKonto
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Markedsplass og plugins/Installer og oppdateringer

Installer og oppdateringer

v1.1.x · oppdatert 2026-07-05

Å installere en plugin i AiHummer er et enkelt klikk i administrasjonsgrensesnittet, men bak det klikket er det en deterministisk, vertsnativ livssyklus. Plattformen laster ned pluginen, kjører de erklærte installasjonsstegene, gjengir en sandboxet systemd-enhet, og vurderer plugin-modulen som sunn først når den svarer på en helsesjekk. Hver installasjon holder seg deretter oppdatert på egen hånd.

Ett-klikk installasjon fra admin UI

Du installerer og administrerer plugins fra administrasjonsgrensesnittet, som støttes av administrasjonsmodul-APIet:

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

Modul-sluggen går i JSON-forespørselslegemet, ikke i banen:

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

Det er ingenting å koble for hånd: velg en plugin fra katalogen, klikk installer, og distribusjonsverktøyet tar over.

[!NOTE] Installere en kanaltilkobler utenfor kjernesettet (kun Telegram) krever en aktiv Starter, Forretning eller Foretak lisens. På fellesskapsplan gir en slik forespørsel tilbake HTTP 402 “oppgradering kreves” (kode plan_limit) — se Lisensiering.

[!NOTE] Den Einstein minneplugin er innebygd: det installeres automatisk, har et «innebygd»-merke og kan ikke fjernes eller stoppes.

SystemdDeployer-flyten

Under panseret SystemdDistribusjon utfører disse trinnene:

  1. Last ned en tarball for den valgte pluginen.
  2. Kjør manifestet install[] trinn erklært av pluginen.
  3. Render en sandbokset systemd-enhet for pluginen.
  4. Meningsmåling /healthz inntil tjenesten rapporterer seg som sunn.
download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

Bare når /healthz lykkes er installasjonen merket som aktiv — en plugin som ikke starter, teller ikke stille som installert.

Vert-nativ, sandboxet systemd — ikke Docker

Hvert plugin kjører som sin egen sandbokset systemd-tjeneste. Det er ingen containere, ingen Docker, ingen orkestrator: en plugin er en administrert Linux-tjeneste med sin egen enhet, port og sandkassebegrensninger, overvåket av systemd som resten av installasjonen.

[!WARNING] AiHummer er vertsnativ. Plugins distribueres som sandboxede systemd-tjenester fra en utgivelsestarball — aldri som Docker-beholdere. Hvis en guide forteller deg å “kjøre plugin-beholderen”, beskriver det ikke AiHummer.

Helsesjekk med /healthz

Distribusjonsverktøyet sjekker pluginen /healthz endepunktet før suksess erklæres. Denne helsesjekken er det som gjør ett-klikk installasjon trygg: en ødelagt eller feilkonfigurert plugin blir oppdaget under installasjonen i stedet for senere i produksjon.

Per-installasjon automatisk oppdatering

Oppdateringer håndteres per installasjon. Hver installerte plugin kan oppdatere seg selv automatisk etter sin egen tidsplan, så det å holde plugins oppdatert krever ikke en manuell reinstallasjon hver gang en ny versjon kommer til katalogen. De samme trinnene for nedlasting → installasjon → rendermodul → helsesjekk kjører for en oppdatering som for en første installasjon.

[!TIP] Siden automatisk oppdatering er per installasjon, kan du beholde noen plugins festet mens lar andre følge med på det nyeste — hver installasjon styrer sin egen livssyklus.

Katalog med flere kilder

Katalogen er ikke lenger knyttet til en enkelt URL. Den fellesskapskatalog av tredjepartsplugins leveres som en innebygd standard kilde (forhåndsinstallert på installasjon) — du legger det ikke til selv. I Plugins → Kilder (Admin UI, eller POST /v1/admin/modules/catalog/sources) du kan legge til dine egne ekstra kilder. Gatewayen synkroniserer alle aktive kilder ved oppstart og på autooppdateringsintervallet.

  • Den offisiell kilde (førstepartsmoduler) er festet og betrodd som standard — et eget objekt som er ikke overskrevet av andre kilder.
  • Den fellesskapskatalog er en forhåndsinnstilt standardkilde; private kilder er lagt til av operatøren. Hver katalogoppføring har en origin, og det origin avgjør hvilken anker signaturen blir verifisert på mot (offisiell → festet nøkkel, privat → tillitslager).

For publisering til fellesskapskatalogen, se Publisering av en plugin.

Tillitsmodell og den pinnede nøkkelen

Installasjon verifiserer et plugins signatur etter kilden:

  • offisiell → verifisert mot registertast festet i kjernen. Betrodd av standard, ingen operatørhandling.
  • privat (side-laste) → verifisert mot instans-tillitslager; forfatternøkkel godkjennes av operatøren ved opplasting (ett klikk).
  • usignert → avvist, bortsett fra i utviklingsmodus (AIHUMMER_PLUGIN_DEV_UNSIGNED=1, kun lokal utvikling).

[!WARNING] Fellesskapets programtillegg kan ikke installeres nå — det er ikke en tilkoblingsfeil. Nøkkelen som signerte fellesskapskatalogen er trukket tilbake; inntil en ny nøkkel kommer, avviser signaturkontrollen disse oppføringene. Uavhengig av det kjøres tredjepartskode ennå ikke som en tjeneste på serveren din: inntil et isolert kjøremiljø finnes, tillates bare integrasjoner som kjører hos seg selv og kobler til over nettet.

Det du ser: etter klikk på «installer» vises den vanlige meldingen «installerer», men tillegget dukker aldri opp i listen over installerte. Årsaken til avslaget havner i gateway-loggen — åpne Logger i administrasjonspanelet.

Det som virker i dag:

  • tillegg fra AiHummer i den offisielle katalogen — de installeres som vanlig og har en annen, gyldig signatur;
  • en MCP-server over HTTP — koblet til som verktøykilde uten utvikling, koden blir hos deg;
  • en integrasjon via OpenAPI-spesifikasjon — det samme, ingen tjeneste å installere.

Sidelasting av ditt eget tillegg består signaturkontrollen, men kjøres bare som fjern-MCP over HTTP eller OpenAPI-integrasjon; et bygg som må startes som tjeneste på samme server, avvises.

Signerte oppdateringer

En oppdatering kjører den samme signaturporten på nytt som den første installasjonen: når du går over til en ny versjon, blir signaturen verifisert igjen mot den samme tillitsankeren. En oppdatering kan ikke omgå sjekken — du kan ikke heve tilliten gjennom en oppdatering.

Den offisielle merket og rangeringen

I Web UI-katalogen har plugins fra AiHummer en Offisiell merke og rang første. Tredjeparts plugins vises uten merke og sorteres etter nedlastningstall. Den offisielle flagget er hentet fra et bidrags origin (offisiell) — det kan ikke settes manuelt i manifestet.

Hvor til neste