Сайдкарҳо — AiHummer Ҳуҷҷатнигорӣ

Баъзе қобилиятҳо — нутқ, видео, ҷустуҷӯи веб, браузери бе сари сафҳа — қисми худи дарвозаи хизматрасонӣ нестанд. Онҳо ҳамчун саҳни канорӣ: хидматҳои хурд, мустақили HTTP, ки дарвоза ба онҳо мерасад аз тариқи URLҲар як сайдкар озод ва маҳаллӣПас паси ягон кадом аз онҳо API-и пулакӣ ҳатмӣ вуҷуд надорад.

Сайдкар чист

Сайдкар раванде ҷудогона мебошад, ки API-и HTTP-ро намоиш медиҳад. Дарвоза ҳеҷ гоҳ онро пайваст намекунад ё дар раванд иҷро намекунад — он танҳо URL-ро, ки шумо танзим кардаед, даъват мекунад. Ҳар як сайдкар

мегузарад зери як воҳиди systemd-и худ (меҳмон-меҳмонхона, бе контейнерҳо)
ба дарвозаи дастрасӣ тавассути тағирёбандаи муҳити шабакавӣ пайваст карда шудааст, ва
метавонад дар паҳлӯи даргоҳ тавассути худи система насбшуда, ё ба ҷои мавҷуда нишон дода шудааст намуна ту аллакай ба ҷои дигар медавӣ.

Вақте ки шартнома танҳо HTTP аст, ҳамон конфигуратсия кор мекунад, новобаста аз он ки сайдкар фаъол аст ё не localhost ё дар мизбони дигар.

[!NOTE] Сайдкарҳо ихтиёрӣ ҳастанд, аммо бо як истисно: ҷустуҷӯи веб (SearXNG) ва браузери зиддиошкорсозӣ (CloakBrowser) аз қуттӣ насб мешаванд. Бастаҳои онҳо дар маҷмӯаи насбкунандаи имзошуда ҷойгиранд ва ба таври офлайн насб мешаванд. Онҳоро бо флагҳои насбкунанда --no-search ва --no-browser хомӯш кардан мумкин аст. Қобилиятҳои дигар танҳо ҳангоми танзим шудани URL-и онҳо фаъоланд; насби минималӣ ҳамоно танҳо дарвоза ва PostgreSQL аст.

Пӯшакҳо ва бандарҳои онҳо

Бандар	Сайдкар	Ҳимоятшуда аз ҷониби	Қувватҳо	Бо васлшуда
8001	СТТ	пишкӯҳи зуд	сухан ба матн	`AIHUMMER_STT_URL`
8002	ТТС	edge-tts	матн ба нутқ	`AIHUMMER_TTS_URL`
8005	видео	ffmpeg	дарки видео	`AIHUMMER_VIDEO_URL`
8888	SearXNG	SearXNG	он `web_search` асбоб	аз ҷониби насбкунанда насб мешавад, танзимаш пинҳон аст; нусхаи беруна — `--external-search=URL`
9222	Хром / CDP	Хром (CDP)	он `browser` асбоб	аз ҷониби насбкунанда насб мешавад, танзимаш пинҳон аст; нусхаи беруна — `--external-browser=URL`

Ҷойгоҳҳои овозӣ роҳи омодасозии фаврӣ мебошанд: STT (:8001) ҳалқаи агент ва TTS-ро таъмин мекунад(:8002) ҷавобро мегуяд, ҳам дар муҳаррикҳои ройгон ва маҳаллӣ. Фаҳмиши видео (:8005) як иловаи ихтиёрӣ ва ихтиёрӣ мебошад. SearXNG (:8888) пуштиҳо web_search, ва як нуқтаи анҷоми Chrome/CDP (:9222) дастгирӣ мекунад browser асбоб

Симкашикунӣ барои сайкларҳо

Шумо дарвоза ро ба ҳар як саҳифаи ҳамоҳангшуда нишон медиҳед танзими каталог — аз интерфейси маъмурӣ (Идоракунӣ → Танзимот) ё бо aihummer settings set. gateway.env ин танҳо барои bootstrap мебошад ва барои ин калидҳо нодида гирифта мешавад. Барои насби мизбон-моҳират, барномаҳои кӯмакчии овоз (STT/TTS) барои шумо танзим шудаанд; ҷустуҷӯи веб ва браузерро худи насбкунанда пайваст мекунад — суроғаҳои онҳоро оператор ҳеҷ гоҳ намедиҳад ва онҳо дар танзимот нишон дода намешаванд; боқимонда онҳоро тибқи эҳтиёҷ фаъол мекунед.

# Voice in/out (auto-configured by the installer for STT/TTS)
aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings set AIHUMMER_TTS_URL http://127.0.0.1:8002

# Optional video sidecar
aihummer settings set AIHUMMER_VIDEO_URL http://127.0.0.1:8005

[!TIP] Зеро ҳар як сайдкар танҳо як URL аст, шумо метавонед хидматҳои вазнинро марказонида кунед. Якчанд дарвозаро ба як нусхаи муштараки STT/TTS равона кунед, ба ҷои иҷрои нусхаи алоҳида дар ҳар мизбон; барои ҷустуҷӯ ва браузер ҳамин корро флагҳои насбкунанда --external-search=URL ва --external-browser=URL мекунанд.

Пайваста ё муштарак иҷро кардани онҳо

Ҳар як сайдкар дар зерсистемаи худ дар мизбон зиндагӣ мекунад, бинобар ин шумо онро монанди ҳар хидмати дигар идора мекунед — оғоз кардан, қатъ кардан ва хондани журналҳо мустақилона аз шлюз. Агар шумо аллакай, масалан, як нуқтаи SearXNG ё Chrome/CDP-ро иҷро мекунед, ба насбкунанда флаги --external-search=URL ё --external-browser=URL диҳед: нусхаи маҳаллӣ насб намешавад ва дарвоза ба нусхаи шумо муроҷиат мекунад. Барои овоз ва видео танзими мувофиқро ба нусхаи мавҷуда равона кунед. Дар ҳар ду ҳолат назари шлюз яксон аст: URL-и танзимшуда, ки он метавонад ба он занг занад.

[!WARNING] Он browser (CDP) ва web_search асбобҳо ба шабака дастрасӣ пайдо мекунанд. Дар таҳлили насбҳои сахтшуда ё ҷудошудаи ҳавоӣ ихроҷ ва танзими ҷудошудаи ҳавоиро баррасӣ мекунад пеш аз он ки онҳоро фаъол созед — дарвоза танҳо ба кабинети паҳлӯӣ занг мезанад, ки шумо онро пайваст кардаед.

Баъд ба куҷо

Чӣ тавр овоз ва асбоби браузер дар як гардиш истифода мешаванд: Дарвозаву муҳаррики гардиш.
Ҷавобгарии ҳадди ақал (PostgreSQL) ва ҳама чизҳои дигар бо интихоби ихтиёрӣ: Дарвозаву муҳаррики гардиш.