Šoninės transporto priemonės

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

Kai kurios galimybės — kalba, vaizdo įrašas, interneto paieška, begalvis naršyklė — nėra paties vartų dalis. Jos veikia kaip šoninės transporto priemonės: maži, nepriklausomi HTTP servisai, kuriuos pasiekia vartai pagal URL. Kiekvienas šoninis vežimėlis yra nemokamas ir vietinis: už nė vieną iš jų nėra privalomo mokamo API.

Kas yra šoninė priekaba

Šoninė karieta yra atskiras procesas, teikiantis HTTP API. Vartai niekada jos nesujungia ar nevykdo procese — jie tiesiog kviečia nustatytą URL. Kiekviena šoninė karieta

veikia po savo systemd vienetas (vietinis kompiuteris, be konteinerių),
yra prijungtas prie vartų per aplinkos kintamąjį, ir
gali būti įdiegtas vietoje šalia vartų arba nukreiptas į esamą pavyzdys tu jau pabėgai kitur.

Kadangi sutartis yra tik HTTP, ta pati konfiguracija veikia nepriklausomai nuo to, ar papildomas servisas įjungtas localhost arba kitame kompiuteryje.

[!NOTE] Šoninės karietos yra neprivalomos — su viena išimtimi: interneto paieška (SearXNG) ir antidetekcinė naršyklė (CloakBrowser) įdiegiamos iš karto. Jų paketai keliauja pasirašytame diegiklio rinkinyje ir įdiegiami neprisijungus prie tinklo. Išjunkite jas diegiklio vėliavėlėmis --no-search ir --no-browser. Visos kitos galimybės aktyvios tik tada, kai sukonfigūruotas jų URL; minimalus diegimas vis tiek lieka tik vartai ir PostgreSQL.

Šoninės transporto priemonės ir jų uostai

Uostas	Šoninė priekaba	Palaikomas	Galia	Sujungtas laidais
8001	STT	greitesnis-šnipas	kalbos į tekstą	`AIHUMMER_STT_URL`
8002	TTS	edge-tts	teksto į kalbą	`AIHUMMER_TTS_URL`
8005	vaizdo įrašas	ffmpeg	vaizdo įrašų supratimas	`AIHUMMER_VIDEO_URL`
8888	SearXNG	SearXNG	tas `web_search` įrankis	įdiegia diegiklis, nustatymas paslėptas; išorinė instancija — `--external-search=URL`
9222	Chrome / CDP	Chrome (CDP)	tas `browser` įrankis	įdiegia diegiklis, nustatymas paslėptas; išorinė instancija — `--external-browser=URL`

Balso šoninės programos yra paruoštas sprendimas: STT (:8001) teikia agentui ėjimą ir TTS (:8002) tarią atsakymą, tiek naudojant nemokamus/vietinius variklius. Vaizdo supratimas (:8005) yra papildomas, pasirenkamas sidecar. SearXNG (:8888) nugara web_search, ir „Chrome/CDP“ galinis taškas (:9222) remia browser įrankis.

Šoninių vežimėlių sujungimas laidais

Jūs nukreipiate vartus į kiekvieną šalutinį vežimėlį su atitinkančiu katalogo nustatymas — iš administratoriaus sąsajos (Valdymas → Nustatymai) arba su aihummer settings set. gateway.env yra tik bootstrap ir yra ignoruojama šioms raktams. Dėl vietinės šeimininko diegimo balsų pagalbinės programos (STT/TTS) yra sukonfigūruotos už jus; interneto paiešką ir naršyklę prijungia pats diegiklis — jų adresų niekada nenustatote ir nustatymuose jos nerodomos; likusią dalį įjungiate pagal poreikį.

# Balso įvestis/išvestis (STT/TTS diegiklis sukonfigūruoja automatiškai)
aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings set AIHUMMER_TTS_URL http://127.0.0.1:8002

# Neprivaloma vaizdo šoninė programa
aihummer settings set AIHUMMER_VIDEO_URL http://127.0.0.1:8005

[!TIP] Kadangi kiekviena šoninėje vežimėlyje esanti dalis yra tik URL, galite centralizuoti sunkias paslaugas. Nukreipkite kelis vartus į vieną bendrą STT/TTS instanciją vietoj to, kad kiekviename kompiuteryje laikytumėte kopiją; paieškai ir naršyklei tą patį atlieka diegiklio vėliavėlės --external-search=URL ir --external-browser=URL.

Vykdant juos vietoje arba bendrinant

Kiekvienas šoninis modulis gyvena po savo systemd vienetu pagrindinėje sistemoje, todėl su juo elgiatės kaip su bet kuria kita paslauga – paleidžiate, sustabdote ir skaitote žurnalus nepriklausomai nuo vartų. Jei jau veikia, tarkime, SearXNG ar Chrome/CDP galutinis taškas, perduokite diegikliui --external-search=URL arba --external-browser=URL: vietinė kopija nediegiama, o vartai kviečia jūsų instanciją. Balsui ir vaizdo įrašams nukreipkite atitinkamą nustatymą į esamą instanciją. Bet kuriuo atveju vartų vaizdas yra identiškas: sukonfigūruotas URL, kurį jis gali iškviesti.

[!WARNING] Tas browser (CDP) ir web_search įrankiai pasiekia tinklą. Įjungta patvirtintų arba atskirtų nuo tinklo diegimų peržiūra, išėjimo srautų ir atskyrimo nuo tinklo nustatymo prieš ją įgalinant – vartai tik kviečia šalutinį modulį, kurį jūs prijungėte.

Kur toliau

Kaip balsas ir naršyklės įrankis naudojami viename veikimo etape: Vartai ir posūkio variklis.
Minimalus griežtas priklausomumas (PostgreSQL) ir viskas kita pasirenkama: Vartai ir posūkio variklis.