AiHummer
Svenska▾
Logga inKonto
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Marknadsplats och tillägg/Installera & uppdateringar

Installera & uppdateringar

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

Att installera ett plugin i AiHummer är ett enda klick i administratörsgränssnittet, men bakom det klicket finns en deterministisk, värd-nativ livscykel. Plattformen laddar ner pluginet, kör dess deklarerade installationssteg, renderar en sandboxad systemd-enhet, och betraktar endast pluginet som friskt när det svarar på en hälsokontroll. Varje installation håller sig sedan uppdaterad på egen hand.

Installera med ett klick från administrationsgränssnittet

Du installerar och hanterar plugins från administrationsgränssnittet, som stöds av administrationsmodulens API:

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

Modulens slug går i JSON-begäranens kropp, inte i sökvägen:

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

Det finns inget att koppla för hand: välj ett plugin från katalogen, klicka på installera, och deployern tar över.

[!NOTE] Installera en kanalanslutning utanför kärnsetet (endast Telegram) kräver en aktiv Startmotor, Affärer eller Företag licens. På Community-planen returnerar en sådan begäran HTTP 402 “uppgradering krävs” (kod plan_limit) — se Licensiering.

[!NOTE] Den Einstein minnesplugin är inbyggd: det installeras automatiskt, bär en “Inbyggd”-märke och kan inte tas bort eller stoppas.

SystemdDeployer-flödet

Under huven det SystemdDistribuerare utför dessa steg:

  1. Ladda ner en tarball för den valda pluginen.
  2. Kör manifestet install[] steg deklarerad av pluginen.
  3. Rendera en sandboxad systemd-enhet för tillägget.
  4. Enkät /healthz tills tjänsten rapporterar att den är frisk.
download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

Endast när /healthz lyckas är installationen markerad som aktiv — en plugin som inte startar räknas inte tyst som installerad.

Host-native, sandboxad systemd — inte Docker

Varje plugin körs som sin egen sandlåda systemd-tjänst. Det finns inga containrar, ingen Docker, ingen orkestrator: ett plugin är en hanterad Linux-tjänst med sin egen enhet, port och sandbox-begränsningar, övervakad av systemd som resten av installationen.

[!WARNING] AiHummer är värd-native. Plugins distribueras som sandboxade systemd-tjänster från ett releasedarkiv — aldrig som Docker-containrar. Om en guide berättar för dig att “köra plugin-behållaren”, det beskriver inte AiHummer.

Hälsokontroll med /healthz

Distribueraren pollar pluginens /healthz slutpunkt innan man deklarerar framgång. Denna hälsogrind är vad som gör installation med ett klick säker: ett trasigt eller felkonfigurerat plugin fångas under installationen istället för att upptäckas senare i produktion.

Auto-uppdatering per installation

Uppdateringar hanteras per installation. Varje installerad plugin kan uppdatera sig själv enligt sitt eget schema, så att hålla plugins uppdaterade kräver inte en manuell ominstallation varje gång en ny version når katalogen. Samma steg med nedladdning → installation → renderingsenhet → hälsokontroll körs för en uppdatering som för en första installation.

[!TIP] Eftersom automatisk uppdatering är per installation, kan du hålla vissa tillägg fastspända medan låter andra spåra det senaste — varje installation hanterar sin egen livscykel.

Katalog med flera källor

Katalogen är inte längre knuten till en ensam URL. gemenskapskatalog av tredjepartsplugins levereras som en inbyggd standardkälla (förinstallerat vid installation) — du lägger inte till det själv. I Plugins → Källor (Admin UI, eller POST /v1/admin/modules/catalog/sources) du kan lägga till dina egna extra källor. Gatewayn synkroniserar varje aktiverad källa vid start och vid automatisk uppdateringsintervall.

  • Den officiell källa (förstapartimoduler) är fixad och betrodd som standard — ett separat objekt som är inte överskrivet av andra källor.
  • Den gemenskapskatalog är en förinställd standardkälla; privata källor är lagts till av operatören. Varje katalogpost har en origin, och det origin beslutar vilken ankare signaturen verifieras mot mot (officiell → fastnålad nyckel, privat → förtroendelager).

För publicering i communitykatalogen, se Publicera ett plugin.

Förtroendemodell och den fastnålade nyckeln

Installation verifierar ett plugins signatur baserat på dess källa:

  • officiell → verifierad mot registernyckel fastsatt i kärnan. Betrodd av standard, ingen operatörsåtgärd.
  • privat (sidoladda) → verifierad mot instansens betrodda lagring; författarnyckeln godkänns av operatören vid uppladdning (ett klick).
  • osignerad → avvisad, förutom i utvecklingsläge (AIHUMMER_PLUGIN_DEV_UNSIGNED=1, endast lokal utveckling).

[!WARNING] Community-plugin går inte att installera just nu — det är inte ett anslutningsfel. Nyckeln som signerade community-katalogen har dragits tillbaka; tills en ny nyckel levereras avvisar signaturkontrollen de posterna. Fristående från det körs tredjepartskod ännu inte som en tjänst på din server: tills en isolerad körmiljö finns tillåts bara integrationer som körs på sin egen sida och ansluter över nätet.

Det du ser: efter klick på ”installera” visas det vanliga meddelandet ”installerar”, men insticket dyker aldrig upp i listan över installerade. Orsaken till avslaget hamnar i gatewayens logg — öppna Loggar i administrationspanelen.

Det som fungerar i dag:

  • plugin från AiHummer i den officiella katalogen — de installeras som vanligt och bär en annan, giltig signatur;
  • en MCP-server över HTTP — ansluten som verktygskälla utan utveckling, koden stannar hos dig;
  • en integration via OpenAPI-specifikation — samma sak, ingen tjänst att installera.

Att sidoladda ditt eget plugin klarar signaturkontrollen, men det körs bara som fjärr-MCP över HTTP eller OpenAPI-integration; ett bygge som måste startas som tjänst på samma server avvisas.

Signerade uppdateringar

En uppdatering kör samma signaturgrind igen som den första installationen: när man uppgraderar till en ny version verifieras signaturen igen mot samma betrodda ankare. En uppdatering kan inte kringgå kontrollen — du kan inte höja förtroendet genom en uppdatering.

Den officiella märket och rangordningen

I Web UI-katalogen har plugins från AiHummer en Officiell märke och rang först. Tillägg från tredje part visas utan märke och sorteras efter nedladdningsantal. Den officiella flaggan är härledd från ett bidrags origin (officiell) — det kan inte ställas in manuellt i manifestet.

Vart härnäst