AiHummer
Deutsch▾
AnmeldenKonto
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Marktplatz und Plugins/Installation & Updates

Installation & Updates

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

Die Installation eines Plugins in AiHummer erfolgt mit einem einzigen Klick in der Admin-Oberfläche, aber hinter diesem Klick steckt ein deterministischer, hostnativer Lebenszyklus. Die Plattform lädt das Plugin herunter, führt die deklarierten Installationsschritte aus, rendert ein sandkastenähnliche systemd-Einheit, und betrachtet das Plugin erst dann als gesund, wenn es einen Gesundheitscheck beantwortet. Jede Installation hält sich danach selbst auf dem neuesten Stand.

Installation mit einem Klick über die Admin-Oberfläche

Sie installieren und verwalten Plugins über die Admin-Benutzeroberfläche, die durch die Admin-Modul-API unterstützt wird:

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

Das Modul-Slug gehört in den JSON-Anfragetext, nicht in den Pfad:

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

Es gibt nichts von Hand zu verkabeln: Wählen Sie ein Plugin aus dem Katalog, klicken Sie auf Installieren, und der Bereitsteller übernimmt.

[!NOTE] Installation eines Kanalverbinders außerhalb des Kernsets (nur Telegram) erfordert einen aktiven Anlasser, Geschäft oder Unternehmen Lizenz. Im Community-Plan liefert eine solche Anfrage zurück HTTP 402 „Upgrade erforderlich“ (Code plan_limit) — siehe Lizenzierung.

[!NOTE] Der Einstein Speicher-Plugin ist eingebaut: es installiert sich automatisch, trägt ein „Eingebaut“-Abzeichen und kann nicht entfernt oder gestoppt werden.

Der SystemdDeployer-Fluss

Unter der Haube die Systemd-Einsetzer führt diese Schritte aus:

  1. Lade ein Tarball herunter für das ausgewählte Plugin.
  2. Führe das Manifest aus install[] Schritte vom Plugin deklariert.
  3. Eine sandboxed systemd-Einheit rendern für das Plugin.
  4. Umfrage /healthz bis der Dienst als gesund gemeldet wird.
download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

Nur wenn /healthz Erfolgt die Installation, wird sie als aktiv markiert — ein Plugin, das nicht startet, zählt nicht stillschweigend als installiert.

Host-nativ, sandboxed systemd — nicht Docker

Jedes Plugin läuft als seine eigene sandboxed systemd-Dienst. Es gibt keine Container, kein Docker, keinen Orchestrator: ein Plugin ist ein verwalteter Linux-Dienst mit eigener Einheit, eigenem Port und Sandbox-Beschränkungen, der wie der Rest der Installation von systemd überwacht wird.

[!WARNING] AiHummer ist host-nativ. Plugins werden als gesicherte systemd-Dienste bereitgestellt aus einem Release-Tarball — niemals als Docker-Container. Wenn ein Führer dir sagt Das Ausführen des Plugin-Containers beschreibt AiHummer nicht.

Gesundheitsprüfung mit /healthz

Der Bereitsteller fragt das Plugin ab /healthz Endpunkt, bevor der Erfolg erklärt wird. Dieses Gesundheitsgate macht die Ein-Klick-Installation sicher: Ein defektes oder falsch konfiguriertes Plugin wird während der Installation erkannt, anstatt später in der Produktion entdeckt zu werden.

Pro-Installation automatische Aktualisierung

Updates werden verarbeitet pro Installation. Jedes installierte Plugin kann sich nach seinem eigenen Zeitplan automatisch aktualisieren, sodass das Aktualisieren von Plugins nicht jedes Mal eine manuelle Neuinstallation erfordert, wenn eine neue Version im Katalog erscheint. Die gleichen Schritte herunterladen → installieren → Render-Einheit → Gesundheitsprüfung werden für ein Update ausgeführt wie bei einer Erstinstallation.

[!TIP] Da die automatische Aktualisierung pro Installation erfolgt, können Sie einige Plugins weiterhin fixieren, während Andere den neuesten Stand verfolgen lassen – jede Installation verwaltet ihren eigenen Lebenszyklus.

Mehrquellenkatalog

Der Katalog ist nicht mehr an eine einzelne URL gebunden. Die Gemeinschaftskatalog von Drittanbieter-Plugins wird als integrierte Funktion geliefert Standardquelle (beim Installieren vorbesät) — Sie fügen es nicht selbst hinzu. In Plugins → Quellen (Admin-Benutzeroberfläche, oder POST /v1/admin/modules/catalog/sources) Sie können Ihre eigenen zusätzlichen Quellen hinzufügen. Das Gateway synchronisiert jede aktivierte Quelle beim Start und im Intervall für automatische Updates.

  • Der offizielle Quelle (Erstpartei-Module) sind standardmäßig festgelegt und vertrauenswürdig — ein separates Objekt, das ist nicht überschrieben durch andere Quellen.
  • Der Gemeinschaftskatalog ist eine vorgegebene Standardquelle; private Quellen sind hinzugefügt vom Betreiber. Jeder Katalogeintrag hat ein origin, und das origin entscheidet, welcher Anker die Signatur überprüft gegen (offiziell → angehefteter Schlüssel, privat → Vertrauensspeicher).

Zum Veröffentlichen im Community-Katalog siehe Ein Plugin veröffentlichen.

Vertrauensmodell und der angeheftete Schlüssel

Die Installation überprüft die Signatur eines Plugins anhand seiner Quelle:

  • offiziell → überprüft gegen die Registrierungsschlüssel im Kern angeheftet. Vertraut von Standard, keine Bedieneraktion.
  • privat (seitlich laden) → überprüft gegen die Instanz-Truststore; der Der Autorenschlüssel wird vom Betreiber beim Hochladen genehmigt (ein Klick).
  • vorzeichenlos → abgelehnt, außer im Entwicklermodus (AIHUMMER_PLUGIN_DEV_UNSIGNED=1, nur lokale Entwicklung).

[!WARNING] Community-Plugins lassen sich derzeit nicht installieren — das ist kein Verbindungsproblem. Der Schlüssel, mit dem der Community-Katalog signiert wurde, ist zurückgezogen; bis ein neuer Schlüssel ausgeliefert wird, weist die Signaturprüfung solche Einträge ab. Davon unabhängig läuft Fremdcode noch nicht als Dienst auf Ihrem Server: bis es eine isolierte Laufzeitumgebung gibt, sind nur Integrationen erlaubt, die auf ihrer eigenen Seite laufen und über das Netz angebunden werden.

Was Sie sehen: nach dem Klick auf „Installieren“ erscheint die übliche Meldung „wird installiert“, das Plugin taucht aber nie in der Liste der installierten auf. Der Ablehnungsgrund landet im Gateway-Protokoll — öffnen Sie Protokolle in der Verwaltungsoberfläche.

Was heute funktioniert:

  • Plugins von AiHummer aus dem offiziellen Katalog — sie installieren sich wie gewohnt und tragen eine andere, gültige Signatur;
  • ein MCP-Server über HTTP — als Werkzeugquelle ohne Entwicklung angebunden, der Code bleibt bei Ihnen;
  • eine Integration per OpenAPI-Spezifikation — dasselbe, ohne Dienst.

Das seitliche Laden eines eigenen Plugins besteht die Signaturprüfung, läuft aber nur als entferntes MCP über HTTP oder als OpenAPI-Integration; ein Build, der als Dienst auf demselben Server starten müsste, wird abgelehnt.

Signierte Updates

Ein Update führt dasselbe Signaturtor erneut aus wie bei der ersten Installation: Beim Wechsel zu einer neuen Version wird die Signatur erneut anhand des gleichen Vertrauensankers überprüft. Ein Update kann nicht umgehen Die Überprüfung — Sie können Vertrauen nicht durch ein Update steigern.

Das offizielle Abzeichen und die Rangordnung

Im Web-UI-Katalog tragen Plugins von AiHummer ein Offiziell Abzeichen und Rang zuerst. Plugins von Drittanbietern werden ohne Abzeichen angezeigt und sortiert nach Download-Anzahl. Die offizielle Flagge leitet sich aus dem Eintrag ab origin (offiziell) — es kann nicht manuell im Manifest gesetzt werden.

Wohin als Nächstes