AiHummer
Polski▾
Zaloguj sięKonto
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Rynek i wtyczki/Instalacja i aktualizacje

Instalacja i aktualizacje

v1.0.x · zaktualizowany 2026-07-05

Instalowanie wtyczki w AiHummer to jedno kliknięcie w interfejsie administratora, ale za tym kliknięciem kryje się deterministyczny, natywny dla hosta cykl życia. Platforma pobiera wtyczkę, uruchamia zadeklarowane kroki instalacji, renderuje odizolowana jednostka systemd, i uważa wtyczkę za zdrową dopiero, gdy odpowie na kontrolę stanu. Każda instalacja następnie sama utrzymuje się na bieżąco.

Instalacja jednym kliknięciem z interfejsu administracyjnego

Instalujesz i zarządzasz wtyczkami z interfejsu administracyjnego, który jest wspierany przez API modułu administracyjnego:

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

Slug modułu znajduje się w ciele żądania JSON, a nie w ścieżce:

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

Nie ma nic do podłączania ręcznie: wybierz wtyczkę z katalogu, kliknij zainstaluj, a instalator przejmuje dalsze działania.

[!NOTE] Instalowanie łącznika kanału poza zestawem podstawowym (tylko Telegram) wymaga aktywnego Rozrusznik, Biznes lub Przedsiębiorstwo licencja. W planie Community takie żądanie zwraca HTTP 402 „wymagana aktualizacja” (kod plan_limit) — zobacz Licencjonowanie.

[!NOTE] Ten Einstein wtyczka pamięci jest wbudowany: instaluje się automatycznie, posiada odznakę „Wbudowany” i nie można jej usunąć ani zatrzymać.

Przebieg SystemdDeployer

Pod maską SystemdDeployer wykonuje te kroki:

  1. Pobierz archiwum tar dla wybranego wtyczki.
  2. Uruchom manifest install[] kroki zadeklarowany przez wtyczkę.
  3. Wyrenderuj jednostkę systemd w piaskownicy dla wtyczki.
  4. Ankieta /healthz aż usługa zgłosi, że jest zdrowa.
download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

Tylko kiedy /healthz Powodzenie oznacza, że instalacja jest oznaczona jako aktywna — wtyczka, która nie uruchamia się, nie jest cicho uznawana za zainstalowaną.

Systemd uruchamiany natywnie na hoście, w piaskownicy — nie Docker

Każda wtyczka działa jako własna izolowana usługa systemd. Nie ma kontenerów, nie ma Dockera, nie ma orkiestratora: wtyczka to zarządzana usługa Linuksa z własną jednostką, portem i ograniczeniami środowiska piaskownicy, nadzorowana przez systemd jak reszta instalacji.

[!WARNING] AiHummer jest natywny dla hosta. Wtyczki są wdrażane jako izolowane usługi systemd z wydanego archiwum tar — nigdy jako kontenery Dockera. Jeśli przewodnik ci powie uruchomić kontener wtyczki, to nie opisuje AiHummer.

Filtrowanie stanu zdrowia za pomocą /healthz

Rozmieszczający odpytywał wtyczkę /healthz punkt końcowy przed ogłoszeniem sukcesu. Ten bramka zdrowia sprawia, że instalacja jednym kliknięciem jest bezpieczna: uszkodzony lub źle skonfigurowany wtyczka jest wykrywany podczas instalacji, a nie odkrywany później w produkcji.

Automatyczna aktualizacja przy instalacji

Aktualizacje są obsługiwane za instalację. Każda zainstalowana wtyczka może aktualizować się automatycznie według własnego harmonogramu, więc utrzymanie wtyczek w bieżącej wersji nie wymaga ręcznej ponownej instalacji za każdym razem, gdy nowa wersja trafia do katalogu. Ten sam proces pobierania → instalacji → uruchomienia jednostki → kontroli stanu zdrowia jest stosowany zarówno przy aktualizacji, jak i przy pierwszej instalacji.

[!TIP] Ponieważ automatyczna aktualizacja działa dla każdej instalacji, możesz przypiąć niektóre wtyczki, podczas gdy pozwalając innym śledzić najnowsze — każda instalacja zarządza własnym cyklem życia.

Katalog wieloźródłowy

Katalog nie jest już powiązany z jednym URL. katalog społeczności wtyczki stron trzecich są dostarczane jako wbudowane domyślne źródło (zasiane podczas instalacji) — nie dodajesz tego samodzielnie. W Wtyczki → Źródła (Interfejs administratora, lub POST /v1/admin/modules/catalog/sources) możesz dodać własne dodatkowe źródła. Brama synchronizuje każde włączone źródło przy uruchomieniu i w interwale automatycznej aktualizacji.

  • Ten oficjalne źródło (moduły pierwszej strony) są domyślnie przypięte i zaufane — oddzielny obiekt, który jest nie nadpisany przez inne źródła.
  • Ten katalog społeczności jest domyślnym źródłem z nasionami; prywatne źródła są dodane przez operatora. Każdy wpis w katalogu ma jeden origin, i to origin decyduje, który kotwica jest weryfikowana podpisem przeciwko (oficjalny → przypięty klucz, prywatny → magazyn zaufania).

Aby opublikować w katalogu społeczności, zobacz Publikowanie wtyczki.

Model zaufania i przypisany klucz

Instalacja weryfikuje podpis wtyczki według jej źródła:

  • oficjalny → zweryfikowano względem klucz rejestru przypięty w rdzeniu. Zaufany przez domyślnie, brak działania operatora.
  • prywatny (załaduj z boku) → zweryfikowano w stosunku do magazyn zaufania instancji; ten Klucz autora jest zatwierdzany przez operatora podczas przesyłania (jednym kliknięciem).
  • bez znaku → odrzucone, z wyjątkiem trybu deweloperskiego (AIHUMMER_PLUGIN_DEV_UNSIGNED=1, tylko lokalny rozwój).

[!WARNING] Wtyczek społeczności nie da się teraz zainstalować — to nie awaria łącza. Klucz, którym podpisywano katalog społeczności, został wycofany; dopóki nie pojawi się nowy klucz, weryfikacja podpisu odrzuca takie wpisy. Niezależnie od tego kod firm trzecich nie jest jeszcze uruchamiany jako usługa na Twoim serwerze: dopóki nie powstanie izolowane środowisko uruchomieniowe, dozwolone są tylko integracje działające po swojej stronie i łączące się przez sieć.

Co zobaczysz: po kliknięciu „zainstaluj” pojawi się zwykły komunikat „instalowanie”, ale wtyczka nigdy nie pojawi się na liście zainstalowanych. Powód odmowy trafia do dziennika bramy — otwórz Dzienniki w panelu.

Co działa dzisiaj:

  • wtyczki od AiHummer z katalogu oficjalnego — instalują się normalnie, mają inny, ważny podpis;
  • serwer MCP po HTTP — podłączany jako źródło narzędzi bez programowania, kod zostaje po Twojej stronie;
  • integracja przez specyfikację OpenAPI — to samo, bez instalowania usługi.

Wgranie własnej wtyczki (side-load) przechodzi weryfikację podpisu, ale uruchomi się wyłącznie jako zdalne MCP po HTTP albo integracja OpenAPI; kompilacja, którą trzeba uruchomić jako usługę na tym samym serwerze, zostanie odrzucona.

Podpisane aktualizacje

Aktualizacja ponownie uruchamia tę samą bramkę sygnaturową jak przy pierwszej instalacji: podczas przechodzenia na nową wersję podpis jest ponownie weryfikowany względem tego samego punktu zaufania. Aktualizacja nie można ominąć sprawdzenie — nie możesz podnieść zaufania poprzez aktualizację.

Oficjalna odznaka i ranking

W katalogu interfejsu internetowego wtyczki od AiHummer mają Oficjalny najpierw odznakę i rangę. Wtyczki firm trzecich wyświetlają się bez odznaki i sortują według liczby pobrań. Oficjalna flaga pochodzi z wpisu origin (oficjalnie) — nie można go ustawić ręcznie w manifeście.

Dokąd dalej