Муҳити тағйирёбанда

Танзимоти AiHummer ба қисмҳо тақсим мешавад ду гурӯҳи пурра мухталиф:

Bootstrap (gateway.env) — чизе ки дарвозаро бояд бидонад пеш метавонад донед пойгоҳи додаҳоро: DSN пойгоҳи додаҳо, суроғаҳои гӯш кардани, каталогҳои статикӣ, калиди асосӣ. Танҳо ин килиҳо аз муҳит хонда мешаванд.
Феҳристи танзимот (банақшагирӣ) — ҳар як тугмаи дигар. Инҳоро дар дохили қайдгирӣ ва танзим дар интерфейси идоракунии веб (Идоракунӣ → Танзимот) ё бо aihummer settings set <KEY> <VALUE>Барои ин калидҳо а gateway.env арзиш аст бо қабули огоҳона нодида гирифт — ҳатто агар танзим шуда бошад, он дорад бе таъсир.

Намунаи конфигуратсия

gateway.env меўбошад фаъолкунӣ-танҳоФармони қарори:

Мефтаҳи танзимоти феҳрист: database value → built-in default (муҳит нодида гирифта мешавад)
калиди оғозёбӣ: environment variable only.

Бинобар ин, манбаи ягонаи ҳақиқати барои тугмаҳои танзимшаванда базаи додаҳо мебошад (интерфейси идоракунии веб) aihummer settingsМуҳит танҳо он чизеро мебарад, ки раванд барои оғоз кардани он зарур аст.

Файли конфигуратсияи насби соҳиби мизбон дар ҷойи зерин қарор дорад:

# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes

[!TIP] Дастгоҳҳои феҳристи Танзимотро нагузоред gateway.env — он таъсир намекунад. Тағир онҳоро дар интерфейси идоракунии веб (Management → Settings, он дорои ҷустуҷӯ мебошад) ё тавассути aihummer settings setБаъзе тағйиротҳо (масалан, гузаришҳои асбоб ва зер-агент) чуқурӣ) гарм истифода баред; дигарон талаб мекунанд, ки хидмат аз нав оғоз шавад.

Bootstrap (gateway.env)

Ягона калидҳое, ки дарвозаро воқеан аз муҳит мехонанд.

Ҳарф ва пойгоҳи дода

Тағирёбанда	Мақсад
`AIHUMMER_DATABASE_URL`	Лозим. Postgres DSN. Бе он дарвоза танҳо дар режими саломатӣ кор мекунад.
`AIHUMMER_DB_APP_URL`	DSN бо нақши маҳдуд, ки Амнияти сатҳи қаторро фаъол мекунад (барои насбҳои маҳаллӣ ба таври худкор танзим мешавад).
`AIHUMMER_GATEWAY_ADDR`	Суханронии оммавӣ гӯш кунед (пешфарз) `:8780`) — ҳама ҳаракати хориҷӣ: API (`/v1/*`), ҷуфтсозӣ, WS/SSE, вебхукуҳои воридшаванда, прокси барнома/ҷайб ва санҷишҳои саломатӣ.
`AIHUMMER_WEBUI_ADDR`	Суроғаи гӯш кардани интерфейси идоракунии хусусӣ (пешфарз `:8781`), дар роҳи реша хизмат кард `/`; беҳтар аст ба интерфейси дохилӣ маҳдуд карда шавад. Танзимшуда ба `0` хомӯш кардан
`AIHUMMER_DEFAULT_WORKSPACE_ID`	Ҳуҷраи корӣ пешфарзро барои ҳамгироӣҳои воридшудаи конфигуратсияшуда интихоб мекунад.
`AIHUMMER_HOME_ROOT`	Рутро насб кунед (одатан аз роҳи бинарӣ гирифта мешавад); директорияҳои admin-ui/blob/installer ва файлҳои калидиро мустаҳкам мекунад.
`AIHUMMER_BLOB_DIR`	Хизматрасонии воситаҳои ахбор/файлро (директорияи захираи блоб) фаъол мекунад. Он инчунин нигоҳ медорад артефактҳои плагини хусусӣ (пардохти паҳншуда) зери `blob:` манбаъҳое, ки насбкунанда ҳалл мекунад.
`AIHUMMER_ADMIN_UI_DIR`	Ба админ SPA хизмат мекунад дар `/admin/`.

Рамзҳо ва инфрасохтор

Тағирёбанда	Мақсад
`AIHUMMER_MASTER_KEY`	base64-кодшуда 32 байт; махфиятҳо дар ҳолати истироҳат, анбор ва BYOK-ро имкон медиҳад.
`AIHUMMER_MEDIA_TOKEN_SECRET`	URLҳои зеркаши дастнависшударо дар тӯли оғозҳои дубора боқӣ мегузорад.
`AIHUMMER_OTEL_ENDPOINT`	Нуқтаи охирини OTLP барои фиристодани изҳо/метрикҳо.
`AIHUMMER_DOWNLOAD_BASE_URL`	URL-и асосӣ барои артефактҳои нашр (манбаи худнавсозӣ).

[!WARNING] Намояндагӣ Фармони танҳо OTLP. AiHummer ин кор мекунад не пинҳон кардани Прометей /metrics ниҳоӣ ё /debug/pprof. Нуқта AIHUMMER_OTEL_ENDPOINT дар шум ба ҷои он ҷамъкунанда.

Феҳристи танзимот (базаи додаҳо — интерфейси идоракунии веб) `aihummer settings`)

Ҳар калиди зер дар пойгоҳи додаҳо мавҷуд аст. Онро дар интерфейси идоракунӣ дар веб насб кунед (Идоракунӣ → Танзимот) ё монанди ин:

aihummer settings set AIHUMMER_LLM_PROVIDER openai

А gateway.env нархи чунин калид ин аст нирў накарда шуд.

Амният

Калид	Мақсад
`AIHUMMER_APPROVAL_TOOLS`	Асбобҳое, ки пеш аз иҷро талаб менамоянд, то шахс тасдиқ кунад.
`AIHUMMER_AIRGAPPED`	`1` пайдарҳамии баромади умумиро, ки бо модел назорат мешавад (режими ҷудо аз ҳаво), монеъ мешавад.
`AIHUMMER_AUDIT_RETENTION_DAYS`	Муддати нигоҳдории сабти назорати маъмурӣ.
`AIHUMMER_INBOUND_SECRET`	Маҳфияти муштарак HMAC барои пайвасткунанда → дарвоза `/v1/inbound/*` занги телефонӣ.

Санҷиши ҳувият ва ҳамоҳангсозии ягона

Калид	Мақсад
`AIHUMMER_OIDC_ISSUER`	Ҳифз мекунад `/v1/admin/*`Бе он (ва беба LDAP/SAML) маъмур ба сарлавҳаҳои dev эътимод мекунад — ҳеҷ гоҳ чунин ҳолатро ошкор накунед.

LDAP/AD ва SAML ҳамзамон бо OIDC барои воридшавӣ ба ташкилот танзим карда шудаанд; SCIM пешниҳоди корбарро ба таври автоматӣ таъмин мекунад. Нигаред Вебқутбҳо, SCIM ва ҷуфтсозӣ.

LLM ва моделҳо

Калид	Мақсад
`AIHUMMER_LLM_PROVIDER`	Фурӯшандаи модел барои истифода.
`AIHUMMER_LLM_MODEL`	Номи модел.
`AIHUMMER_LLM_GATEWAY_URL`	URL асосии дарвозаи/нигори LLM, ки бо OpenAI мувофиқ аст `AIHUMMER_LLM_*` масир; аз маҳаллӣ ҷудо `AIHUMMER_OPENAI_BASE_URL`). Бубинед BYOK ва таъминкунандагон.
`AIHUMMER_OPENAI_API_KEY`	Калиди API барои провайдери мувофиқи OpenAI.
`AIHUMMER_SUBAGENT_MAX_DEPTH`	Ҳадди зиёди амиқии агенти зерсохташуда.

[!NOTE] Агар ягон модел пайваст нашавад, дарвоза ба ҳолати пешфарзӣ мегузарад. таппиқии ҳалкунанда пас система ҳанӯз кор мекунад. Ҳеч гоҳ API-и модели пардохтӣ лозим нест — моделҳои ройгон/маҳаллӣ ва як Нақлиёти обунаи Codex/ChatGPT дараҷаи як мебошанд.

Асбобҳо

Калид	Мақсад
`AIHUMMER_FS_ROOT`	Имкон медиҳад `filesystem_read`, дар ин реша таҳкурсӣ шуда.
`AIHUMMER_DB_QUERY_DSN`	Имкон медиҳад `db_query` (танҳо хондан) бар зидди ин DSN.
`AIHUMMER_CODE_EXEC`	Фарз мекунад `code_exec` асбоб (дар хостҳои муштарак тавассути хомӯш пешфарз фаъол мешавад)
`AIHUMMER_BROWSER_PROFILE_SOCKET`	Роҳ ба сокети хусусии `managed-profiles.sock`-и хидмати браузер; холӣ — профилҳои доимии `computer` хомӯшанд.
`AIHUMMER_BROWSER_PROFILE_BINDINGS`	Массиви JSON-и пайвастҳои возеҳи профилҳои доимии браузер (`profile_id`, `tenant_id`, `user_id`, `agent_ids`, `conversation_ids`).

Ҷустуҷӯи веб ва браузер аз ҷониби насбкунанда идора мешаванд: онҳо аз қуттӣ насб мешаванд, бо флагҳои --no-search / --no-browser хомӯш карда мешаванд, ва нусхаи мавҷуда бо флагҳои --external-search=URL / --external-browser=URL пайваст карда мешавад — танзимоти алоҳидаи операторӣ барои онҳо нест.

Бӯсаи пурраро бинед Феҳристи асбобҳо барои он ки ҳар як асбоб чӣ кор мекунад.

Овоз ва сайдқар

Калид	Мақсад
`AIHUMMER_STT_URL`	URL-и дастгирии нутқ ба матн (аз тарафи насбкунанда пешбинишуда).
`AIHUMMER_TTS_URL`	URL-и паҳлӯи матн ба садо (аз тарафи насбкунанда сохташуда).
`AIHUMMER_VIDEO_URL`	URL-и паҳлӯии фаҳмиши видео.
`AIHUMMER_TTS_AUTO_REPLY`	Кай ҷавоби тайёр садо дода мешавад: `off`, `always`, `inbound` (пешфарз), `tagged`.
`AIHUMMER_TTS_MAX_CHARS`	Ҳадди матни садододашаванда: `0` — ҷавоби пурра, вагарна `100`–`10000` аломат.
`AIHUMMER_TTS_SUMMARIZE`	Кӯтоҳ кардани ҷавоби дароз барои садодиҳӣ (аз рӯи пешфарз фаъол).

Сайдкартҳо хадамоти ҷудогонаи HTTP мебошанд; гузаргоҳ тавассути URL ба онҳо мерасад.

Векторҳо ва ҷойгиркуниҳо

Калид	Мақсад
`AIHUMMER_QDRANT_URL`	Ҷойгоҳи воқеии векторӣ (Qdrant). Ҳузур надорад → дар хотираи дохилӣ нигоҳ дошта мешавад.
`AIHUMMER_EMBEDDER_URL`	Хизматрасонии воқеии дохилсозӣ. Набудани → дохилсозии хеш.

Сатҳҳои протокол (ихтиёрӣ)

Калид	Мақсад
`AIHUMMER_MCP_PUBLISH`	Маҳз `1` сервери берунии MCP-ро дар `POST /v1/mcp` мекушояд. Худ аз худ ягон абзорро содир намекунад.
`AIHUMMER_MCP_EXPORT_TOOLS`	Номҳои дақиқи абзорҳо бо вергул, ки муштарии MCP мебинад. Холӣ (пешфарз) — СИФР абзор содир мешавад.
`AIHUMMER_A2A_PUBLISH`	`1` имконият медиҳад, ки сатҳи A2A`/.well-known/agent.json`, `/a2a/message`).

Танҳо Dev месозад

Тағирёбанда	Мақсад
`AIHUMMER_PLUGIN_PUBKEY`	Як калиди ҷамъиятии иловагӣ, боэътимод (base64 ed25519) барои тасдиқи имзоҳои плагин. Танҳо барои сохтани Dev — дар сохторҳои нашршуда нодида гирифта шудааст (калиди режистри ба файли биноӣ часпонида шудааст).
`AIHUMMER_PLUGIN_DEV_UNSIGNED`	`1` имкон медиҳад насб кардан дисавторӣшуда плагинҳо. Фақат барои сохтани Dev — дар сохтани нашршуда нодида гирифта шудааст. Ҳеҷ гоҳ дар як намунаи берун аз дастрасӣ нест.

[!WARNING] Дар нашри баровардашуда решаи эътимоди плагин чунин аст дар бинарӣ ҳалқадоршуда ва инро на муҳит ва на танзимот метавонад тағйир диҳад — ин як системаи зидди дасткорӣ аст капалат

Намунаи эътимод (расмӣ → калиди часпондашуда, хусусӣ → анбори эътимод, бимиёндошта → баста) тавсиф шудааст дар Насб ва навсозӣ.

Баъд ба куҷо

Бубинед ки ҳар калид кадом воситаҳоро мекушояд: Феҳристи асбобҳо.
Инстансро рӯзмарра идора кунед: Маълумоти CLI.