AiHummer
Deutsch▾
AnmeldenKonto
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Marktplatz und Plugins/Ein Plugin veröffentlichen

Ein Plugin veröffentlichen

v1.1.x · aktualisiert 2026-07-19

Ein Plugin mit dem gebaut Plugin-SDK? Sie können es in veröffentlichen zwei Wege:

  • Privat (für dich selbst) — seitlich laden in Ihre Instanz. Das Artefakt niemals lässt es.
  • Gemeinschaft (für alle) — veröffentlichen über dein persönliches Schrank bei my.aihummer.ru, App-Store Stil: Lade den Build hoch, fülle die Store-Seite aus, bestehe die Überprüfung, und es landet in der signierter Community-Katalog, den jede Instanz installieren kann.

Analogie: installieren eines .vsix von Hand (privat) vs. Veröffentlichung in einem App-Store (gemeinschaftlich).

[!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.

Privater Modus — seitlich in Ihre Instanz laden

Verwenden Sie dies, wenn nur Sie das Plugin benötigen: ein interner Anschluss, eine benutzerdefinierte Integration, ein Testbuild.

Schritte

  1. Paket schnüren und unterschreiben: 
    aihummer plugin package ./my-plugin
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz
  2. Laden Sie es auf die Instanz auf eine von zwei Arten hoch:
    • Admin UI → Plugins → “Plugin hochladen” — das Bündel ziehen; oder
    • CLI: 
      aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz
  3. Unter der Haube ist dies POST /v1/admin/modules/upload (mehrteilig, integrations:write): das Artefakt landet in der Instanz Blob-Speicher (AIHUMMER_BLOB_DIR) unter einem blob: ref, und eine Katalogzeile wird registriert mit origin = local-private, visibility = private.
  4. Das Plugin erscheint im Marktplatz gekennzeichnet Privat und installiert über die normaler Pfad — eingeschränkte systemd-Einheit + Gesundheitskontrolle.

Vertrauen: der angeheftete Schlüssel und der Vertrauensspeicher

Private Artefakte muss unterschrieben werden. Wenn Sie ein mit einem unbekannten Schlüssel signiertes Plugin hochladen, fordert die Admin-Benutzeroberfläche Sie auf, den Schlüssel des Autors genehmigen in den Instanz-Trust-Store (ein Klick). Nach der Genehmigung wird die Signatur bei jeder Installation und jedem Update überprüft.

  • Artefakte aus dem offiziell Quelle gegen überprüfen Registrierungsschlüssel angeheftet im Kern — standardmäßig vertraut, kein zusätzlicher Schritt.
  • Privat Artefakte werden gegen die Schlüssel im Instanz-Trust-Store überprüft.
  • Unterschrieben nicht Pakete werden abgelehnt — außer im Entwicklungsmodus für lokale Iteration: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 deaktiviert die Signaturüberprüfung und ist vorgesehen Nur für die lokale Entwicklung. Aktivieren Sie es niemals auf einer extern erreichbaren Instanz.

Community-Modus — über das persönliche Cabinet veröffentlichen

Um ein Plugin verfügbar zu machen für jeder Instanz, veröffentlichen Sie es von Ihrem persönliches Schrank bei my.aihummer.ru, auf die gleiche Weise, wie Sie eine App in einem App-Store veröffentlichen. Sie laden das Build hoch, füllen die Store-Seite aus und senden es zur Überprüfung; zunächst wird eine automatisierte KI-Prüfung durchgeführt, dann trifft ein menschlicher Moderator die endgültige Entscheidung, und nach der Genehmigung wird das Artefakt signiert und im Community-Katalog veröffentlicht.

Die vollständige Schritt-für-Schritt-Anleitung ist an Ein Plugin einreichen. Kurz gesagt:

  1. Erstellen & paketieren Ihr Plugin mit dem SDK (aihummer plugin package) — das Artefakt ist ein unterzeichnet .tar.gz trägt sein manifest.json.
  2. Öffnen Sie «Meine Plugins» im Schrank und eine Einreichung erstellen: lade die hoch Artefakt, füllen Sie das Metadaten speichern (Name & Beschreibungen auf RU + EN, Version, Symbol, Screenshots, Kategorie, optionaler Spendenlink, Änderungsprotokoll) und deklarieren Sie die Fähigkeitsmanifest.
  3. Zur Überprüfung senden. Automatisiert KI-Bewertung überprüft die Einreichung gegen der Überprüfungspolitik (Sicherheit, Manifest) Richtigkeit, Vollständigkeit, Inhalt), dann ein menschlicher Moderator liest den Bericht und entscheidet. Die Automatisierung veröffentlicht niemals von selbst.
  4. Nach Genehmigung das Artefakt ist unterzeichnet und veröffentlicht zu einem trennen community-catalog.json auf dem CDN. Jede Instanz, die das hinzugefügt hat Die Community-Quelle sieht das Plugin; der Kern vertraut ihm über die angehefteter Registrierungsschlüssel — kein Vertrauensschritt pro Bediener erforderlich.

[!NOTE] Der alte öffentliche Veröffentlichungsfluss wurde eingestellt; der oben beschriebene Personal-Kabinett-Fluss — „Meine Plugins” — ist der einzige Community-Veröffentlichungspfad. Community-Plugins sind kostenlos; Sie können einen optionalen Spenden-Link hinzufügen.

[!NOTE] Erste-Partei-Plugins (Einstein, SIP, Bitrix24, pocket-agent, os-client) sind nicht auf diese Weise veröffentlicht — sie werden über ihre eigene AiHummer-CI-Pipeline bereitgestellt und landen in der angeheftete offizielle Katalog. Der persönliche Schrankfluss ist für Gemeinschaft (Drittanbieter) Plugins.

Moderation

Jede Einsendung der Gemeinschaft durchläuft eine automatisierte Überprüfung (Vollständigkeit, das Capability-Manifest, Signatur und ein Sicherheits-Scan), dann ein KI-Risikoüberprüfung, und schließlich ein verpflichtende menschliche Überprüfung vom AiHummer-Team. Weder die Automatisierung noch die KI veröffentlichen jemals eigenständig – die Entscheidung liegt immer bei einem Moderator, und nichts gelangt ohne deren Genehmigung in den Katalog. Ein veröffentlichtes Plugin, das später als bösartig oder fehlerhaft festgestellt wird, kann widerrufen und beim nächsten Abgleich aus dem Katalog entfernt wurde.

Der Community-Katalog als zusätzliche Quelle

Community-Plugins werden veröffentlicht zu einer trennen community-catalog.json das tut nicht überschreiben Sie den kuratierten First-Party-Katalog. Eine Instanz fügt ihn als zusätzliche Quelle hinzu in Plugins → Quellen (oder POST /v1/admin/modules/catalog/sources). Siehe Installation & Updates und Übersicht & Stufen.

Plugin-Lebenszyklus (App Store)

Der Marktplatz funktioniert wie ein echter App Store – jedes Plugin hat ein Identität (ein permanenter Slug + Autor), unter dem es verschickt wird Versionen.

Versionen & Updates

Ein Update wird als neue Version eines bereits veröffentlichten Plugins: derselbe Slug, sein eigenes Änderungsprotokoll, seine eigenen Bewertungen und Moderation. Nur eins Eine Version kann zu einem Zeitpunkt überprüft werden – Sie reichen die nächste ein, nachdem die aktuelle eine Entscheidung erhalten hat. Wenn eine neue Version veröffentlicht wird, wird die vorherige gekennzeichnet. superseded, und der Katalog + jede Instanz wird zum neuen verschoben.

Geplante Veröffentlichung

Nachdem ein Moderator es genehmigt hat, der Autor kontrolliert die Veröffentlichung: jetzt veröffentlichen oder für eine bestimmte Zeit planen — das Plugin geht zum festgelegten Zeitpunkt live.

Zurückziehen

  • Pause — Plugin vorübergehend ausblenden: Es verschwindet aus dem öffentlichen Katalog und von den Instanzen (bei der nächsten Synchronisierung), wird aber beibehalten und kann neu veröffentlicht zu jeder Zeit.
  • Auslisten — das Plugin endgültig aus dem Marktplatz entfernen.

Sobald ein Plugin nicht mehr veröffentlicht wird (pausiert oder aus der Liste entfernt), wird sein Eintrag entfernt aus community-catalog.json, und Instanzen hören auf, es bei der nächsten Synchronisierung anzuzeigen.

Autorenschaft

Ein Plugin wird veröffentlicht unter Ihr Anzeigename (z. B. der Name Ihres Studios) — oder anonym. Der öffentliche Katalog und die Instanz-Weboberfläche zeigen den gewählten Namen oder „Anonym“ an; Ihre echte E-Mail/ID wird niemals offengelegt.

Entwicklerstatistiken

Jedes Plugin hat aggregierte Statistiken: Downloads, Installationen, aktive Instanzen und Deinstallationen, sowie ein Tagesdiagramm. Nur aggregierte Zahlen — keine pro Instanz-Daten werden dem Entwickler angezeigt.

Veröffentlichungsbelohnung

Für jedes Plugin, das Sie zum ersten Mal veröffentlichen, Ihr AiHummer-Abonnement erhält ein kostenloser Monat (einmal pro Plugin gewährt).

Wo als Nächstes